# Serious Scaffold Python
A Python Project Template for Long-Term Maintainability.
[](https://github.com/serious-scaffold/ss-python/actions/workflows/ci.yml)
[](https://github.com/serious-scaffold/ss-python/actions/workflows/commitlint.yml)
[](https://github.com/serious-scaffold/ss-python/actions/workflows/devcontainer.yml)
[](https://github.com/serious-scaffold/ss-python/actions/workflows/release.yml)
[](https://github.com/serious-scaffold/ss-python/actions/workflows/renovate.yml)
[](https://github.com/serious-scaffold/ss-python/actions/workflows/semantic-release.yml)
[](https://serious-scaffold.github.io/ss-python/reports/coverage)
[](https://github.com/serious-scaffold/ss-python/releases)
[](https://pypi.org/project/ss-python/)
[](https://pypi.org/project/ss-python/)
[](https://github.com/serious-scaffold/ss-python/blob/main/LICENSE)
[](https://pdm-project.org)
[](https://github.com/pre-commit/pre-commit)
[](http://mypy-lang.org/)
[](https://github.com/astral-sh/ruff)
[](https://conventionalcommits.org)
[](https://pydantic.dev)
[](https://github.com/copier-org/copier)
[](https://serious-scaffold.github.io/ss-python)
[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/serious-scaffold/ss-python)
> [!WARNING]
> _Serious Scaffold Python_ is in the **Alpha** phase.
> Frequent changes and instability should be anticipated.
> Any feedback, comments, suggestions and contributions are welcome!
[](https://github.com/serious-scaffold/ss-python)
Serious Scaffold Python is crafted for long-term, maintainable Python projects. It includes GitHub Actions and GitLab CI/CD, automated dependency updates via Renovate, and comprehensive linting, testing, and documentation. Key integrations like pdm for environment and dependency management, click for CLI development, and pydantic for configuration enhance project robustness. With copier’s easy project setup and continuous updating, your project stays aligned with best practices for sustainable development. Pre-configured dev containers and cross-platform CI support ensure maintainability from the start.
If you find this helpful, please consider [sponsorship](https://github.com/sponsors/huxuan).
## 🛠️ Features
- Project setup and template update with [copier](https://copier.readthedocs.io/).
- Manage dependencies and virtual environments with [pdm](https://pdm-project.org/).
- Build with [setuptools](https://github.com/pypa/setuptools) and versioned with [setuptools-scm](https://github.com/pypa/setuptools_scm/).
- Lint with [pre-commit](https://pre-commit.com), [mypy](http://www.mypy-lang.org/), [ruff](https://github.com/charliermarsh/ruff), [pyproject-fmt](https://github.com/tox-dev/pyproject-fmt) and [commitlint](https://commitlint.js.org/).
- Test with [pytest](https://docs.pytest.org/) and [coverage](https://coverage.readthedocs.io) for threshold and reports.
- Documentation with [sphinx](https://www.sphinx-doc.org/), the [furo](https://pradyunsg.me/furo) theme and [MyST parser](https://myst-parser.readthedocs.io/) for markdown.
- Develop Command Line Interfaces with [click](https://click.palletsprojects.com/).
- Manage configurations with [pydantic-settings](https://docs.pydantic.dev/latest/usage/pydantic_settings/).
- [Dev container](https://containers.dev/) for development and GitLab CI/CD.
- Automate dependency updates with [Renovate](https://github.com/renovatebot/renovate).
- Automate version management and release with [semantic-release](https://github.com/semantic-release/semantic-release).
- [Versioned documentation](https://docs.readthedocs.io/en/stable/versions.html) and [pull request previews](https://docs.readthedocs.io/en/stable/pull-requests.html) with [Read the Docs](https://readthedocs.org/).
- Adapted configuration for GitHub, GitLab and self-managed GitLab.
- Continuous Integration for Linux, MacOS and Windows [GitHub Only].
- Continuous Integration for multiple Python versions.
- Release with documentation, package and production container.
- Centralize common actions with a unified Makefile.
- VSCode settings with recommended extensions.
## 🔧 Prerequisites
[pipx](https://pipx.pypa.io/) is required to manage the standalone tools used across the development lifecycle.
Please refer to pipx's installation instructions [here](https://pipx.pypa.io/stable/installation/).
Once pipx is set up, install the copier for project generation using the following command:
```bash
pipx install copier==9.4.1
```
## 🚀 Quickstart
1. Generate the project.
```bash
copier copy gh:serious-scaffold/ss-python /path/to/project
```
1. Navigate to the project directory and initialize a git repository.
```bash
cd /path/to/project
git init
```
1. Install standalone tools.
```bash
make prerequisites
```
1. Set up the development environment.
```bash
make dev
```
1. Commit the initialized project.
```bash
git add .
git commit -m "Initialize from serious-scaffold."
```
1. That's it! Feel free to focus on the coding within `src` folder.
## 📜 License
MIT License, for more details, see the [LICENSE](https://github.com/serious-scaffold/ss-python/blob/main/LICENSE) file.
Raw data
{
"_id": null,
"home_page": null,
"name": "ss-python",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "copier-template, full-development-lifecycle, project-template, serious-scaffold",
"author": null,
"author_email": "huxuan <i@huxuan.org>",
"download_url": "https://files.pythonhosted.org/packages/e6/30/9ebd50234a59931a39a8702edd23ff6aa97f46e5bd9c3b0eea77cd29083d/ss_python-0.0.61.tar.gz",
"platform": null,
"description": "# Serious Scaffold Python\n\nA Python Project Template for Long-Term Maintainability.\n\n[](https://github.com/serious-scaffold/ss-python/actions/workflows/ci.yml)\n[](https://github.com/serious-scaffold/ss-python/actions/workflows/commitlint.yml)\n[](https://github.com/serious-scaffold/ss-python/actions/workflows/devcontainer.yml)\n[](https://github.com/serious-scaffold/ss-python/actions/workflows/release.yml)\n[](https://github.com/serious-scaffold/ss-python/actions/workflows/renovate.yml)\n[](https://github.com/serious-scaffold/ss-python/actions/workflows/semantic-release.yml)\n[](https://serious-scaffold.github.io/ss-python/reports/coverage)\n[](https://github.com/serious-scaffold/ss-python/releases)\n[](https://pypi.org/project/ss-python/)\n[](https://pypi.org/project/ss-python/)\n[](https://github.com/serious-scaffold/ss-python/blob/main/LICENSE)\n\n[](https://pdm-project.org)\n[](https://github.com/pre-commit/pre-commit)\n[](http://mypy-lang.org/)\n[](https://github.com/astral-sh/ruff)\n[](https://conventionalcommits.org)\n[](https://pydantic.dev)\n[](https://github.com/copier-org/copier)\n[](https://serious-scaffold.github.io/ss-python)\n[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/serious-scaffold/ss-python)\n\n> [!WARNING]\n> _Serious Scaffold Python_ is in the **Alpha** phase.\n> Frequent changes and instability should be anticipated.\n> Any feedback, comments, suggestions and contributions are welcome!\n\n[](https://github.com/serious-scaffold/ss-python)\n\nSerious Scaffold Python is crafted for long-term, maintainable Python projects. It includes GitHub Actions and GitLab CI/CD, automated dependency updates via Renovate, and comprehensive linting, testing, and documentation. Key integrations like pdm for environment and dependency management, click for CLI development, and pydantic for configuration enhance project robustness. With copier\u2019s easy project setup and continuous updating, your project stays aligned with best practices for sustainable development. Pre-configured dev containers and cross-platform CI support ensure maintainability from the start.\n\nIf you find this helpful, please consider [sponsorship](https://github.com/sponsors/huxuan).\n\n## \ud83d\udee0\ufe0f Features\n\n- Project setup and template update with [copier](https://copier.readthedocs.io/).\n- Manage dependencies and virtual environments with [pdm](https://pdm-project.org/).\n- Build with [setuptools](https://github.com/pypa/setuptools) and versioned with [setuptools-scm](https://github.com/pypa/setuptools_scm/).\n- Lint with [pre-commit](https://pre-commit.com), [mypy](http://www.mypy-lang.org/), [ruff](https://github.com/charliermarsh/ruff), [pyproject-fmt](https://github.com/tox-dev/pyproject-fmt) and [commitlint](https://commitlint.js.org/).\n- Test with [pytest](https://docs.pytest.org/) and [coverage](https://coverage.readthedocs.io) for threshold and reports.\n- Documentation with [sphinx](https://www.sphinx-doc.org/), the [furo](https://pradyunsg.me/furo) theme and [MyST parser](https://myst-parser.readthedocs.io/) for markdown.\n- Develop Command Line Interfaces with [click](https://click.palletsprojects.com/).\n- Manage configurations with [pydantic-settings](https://docs.pydantic.dev/latest/usage/pydantic_settings/).\n- [Dev container](https://containers.dev/) for development and GitLab CI/CD.\n- Automate dependency updates with [Renovate](https://github.com/renovatebot/renovate).\n- Automate version management and release with [semantic-release](https://github.com/semantic-release/semantic-release).\n- [Versioned documentation](https://docs.readthedocs.io/en/stable/versions.html) and [pull request previews](https://docs.readthedocs.io/en/stable/pull-requests.html) with [Read the Docs](https://readthedocs.org/).\n- Adapted configuration for GitHub, GitLab and self-managed GitLab.\n- Continuous Integration for Linux, MacOS and Windows [GitHub Only].\n- Continuous Integration for multiple Python versions.\n- Release with documentation, package and production container.\n- Centralize common actions with a unified Makefile.\n- VSCode settings with recommended extensions.\n\n## \ud83d\udd27 Prerequisites\n\n[pipx](https://pipx.pypa.io/) is required to manage the standalone tools used across the development lifecycle.\nPlease refer to pipx's installation instructions [here](https://pipx.pypa.io/stable/installation/).\nOnce pipx is set up, install the copier for project generation using the following command:\n\n```bash\npipx install copier==9.4.1\n```\n\n## \ud83d\ude80 Quickstart\n\n1. Generate the project.\n\n ```bash\n copier copy gh:serious-scaffold/ss-python /path/to/project\n ```\n\n1. Navigate to the project directory and initialize a git repository.\n\n ```bash\n cd /path/to/project\n git init\n ```\n\n1. Install standalone tools.\n\n ```bash\n make prerequisites\n ```\n\n1. Set up the development environment.\n\n ```bash\n make dev\n ```\n\n1. Commit the initialized project.\n\n ```bash\n git add .\n git commit -m \"Initialize from serious-scaffold.\"\n ```\n\n1. That's it! Feel free to focus on the coding within `src` folder.\n\n## \ud83d\udcdc License\n\nMIT License, for more details, see the [LICENSE](https://github.com/serious-scaffold/ss-python/blob/main/LICENSE) file.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python Project Template for Long-Term Maintainability.",
"version": "0.0.61",
"project_urls": {
"documentation": "https://serious-scaffold.github.io/ss-python",
"issue": "https://github.com/serious-scaffold/ss-python/issues",
"repository": "https://github.com/serious-scaffold/ss-python"
},
"split_keywords": [
"copier-template",
" full-development-lifecycle",
" project-template",
" serious-scaffold"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c88d69d04517f768cc4c61180a443389ed79cc250824f33a84731f17ac0d7ab1",
"md5": "233b41d8a9faf9982aa155bbc60ffc69",
"sha256": "45693559d0a6915c96c89b1c68816e20a22a65531b160642a85a1883217f2745"
},
"downloads": -1,
"filename": "ss_python-0.0.61-py3-none-any.whl",
"has_sig": false,
"md5_digest": "233b41d8a9faf9982aa155bbc60ffc69",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 6042,
"upload_time": "2024-12-03T01:22:29",
"upload_time_iso_8601": "2024-12-03T01:22:29.948094Z",
"url": "https://files.pythonhosted.org/packages/c8/8d/69d04517f768cc4c61180a443389ed79cc250824f33a84731f17ac0d7ab1/ss_python-0.0.61-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e6309ebd50234a59931a39a8702edd23ff6aa97f46e5bd9c3b0eea77cd29083d",
"md5": "860fc0412bb1519371f00896b5033214",
"sha256": "64388de58fce872f2e9976ed174cb2e72ab5ae8b8b3d9be431af090e4cab46b1"
},
"downloads": -1,
"filename": "ss_python-0.0.61.tar.gz",
"has_sig": false,
"md5_digest": "860fc0412bb1519371f00896b5033214",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 502155,
"upload_time": "2024-12-03T01:22:31",
"upload_time_iso_8601": "2024-12-03T01:22:31.672381Z",
"url": "https://files.pythonhosted.org/packages/e6/30/9ebd50234a59931a39a8702edd23ff6aa97f46e5bd9c3b0eea77cd29083d/ss_python-0.0.61.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-03 01:22:31",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "serious-scaffold",
"github_project": "ss-python",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "ss-python"
}
JSON
