Serious Scaffold Python
A Python Project Template for Long-Term Maintainability.
[!WARNING] Serious Scaffold Python is in the Alpha phase. Frequent changes and instability should be anticipated. Any feedback, comments, suggestions and contributions are welcome!
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.
🛠️ Features
- Project setup and template update with copier.
- Manage dependencies and virtual environments with pdm.
- Build with setuptools and versioned with setuptools-scm.
- Lint with pre-commit, mypy, ruff, pyproject-fmt, codespell, check-jsonschema and commitlint.
- Test with pytest and coverage for threshold and reports.
- Documentation with sphinx, the furo theme and MyST parser for markdown.
- Build documentation dynamically when related files change with watchfiles.
- Develop Command Line Interfaces with click.
- Manage configurations with pydantic-settings.
- Dev container for development and GitLab CI/CD.
- Automate dependency updates with Renovate.
- Automate version management and release with semantic-release.
- Versioned documentation and pull request previews with Read the Docs.
- 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 is required to manage the standalone tools used across the development lifecycle. Please refer to pipx's installation instructions here. Once pipx is set up, install the copier for project generation using the following command:
pipx install copier==9.6.0
🚀 Quickstart
-
Generate the project.
copier copy gh:serious-scaffold/ss-python /path/to/project
-
Navigate to the project directory and initialize a git repository.
cd /path/to/project git init
-
Install standalone tools.
make prerequisites -
Set up the development environment.
make dev -
Commit the initialized project.
git add . git commit -m "Initialize from serious-scaffold."
-
That's it! Feel free to focus on the coding within
srcfolder.
📜 License
MIT License, for more details, see the LICENSE file.
Release files for ss-python 0.0.67
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ss_python-0.0.67.tar.gz | 506.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ss_python-0.0.67-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 513.0 kB
Release files / ss_python-0.0.67.tar.gz
| Download URL | ss_python-0.0.67.tar.gz |
|---|---|
| Size | 506.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e7a417439098853a55abb4cdbdd3ace1e190fc38a5a93d57e4ade639f56b9300
|
|
BLAKE2b-256 checksum How to use checksums |
4a74d8307d391b0b2595b8382b9dc4ade5d40a39aa34957da779f7c998056691
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
pdm/2.24.0 CPython/3.12.10 Linux/6.11.0-1012-azure
|
Release files / ss_python-0.0.67-py3-none-any.whl
| Download URL | ss_python-0.0.67-py3-none-any.whl |
|---|---|
| Size | 6.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aadb834e42a3e3bdc8a91b017990a8e00eea7acf1fc62063404f39ed89e1beda
|
|
BLAKE2b-256 checksum How to use checksums |
2ff31c1594b9925c745b3b24a07727d4048bd76b33393cc969f11beff90ffb94
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
pdm/2.24.0 CPython/3.12.10 Linux/6.11.0-1012-azure
|
