templatepy
Copier template for modern Python packages.
Stack
| Tool | Role |
|---|---|
| uv | dependency management, virtual environments |
| hatchling + hatch-vcs | build backend; version from git tags |
| commitizen | Conventional Commits enforcement; auto bump on merge |
| ruff | linting + formatting |
| mypy | static type checking |
| pytest + pytest-cov | testing with coverage |
| gitleaks | secret scanning |
Quickstart
uv tool install copier
copier copy gh:larsrollik/templatepy my-new-project
cd my-new-project
git init && git add -A && git commit -m "chore: initial commit from templatepy"
uv sync --extra dev
uv run pre-commit install --hook-type pre-commit --hook-type commit-msg
Update existing project
cd my-existing-project && copier update
Release flow
feature branch → PR → CI gate (lint + test) must pass
merge blocked until green
↓
merge to main (merge commit)
↓
versioning.yml fires on push to main:
→ cz bump → tag vX.Y.Z → dispatch release.yml
↓
release.yml (on tag / dispatch):
→ GitHub release (wheel + sdist attached)
→ PyPI via OIDC trusted publishing (no stored token)
→ Zenodo webhook (if enabled)
PyPI setup (one-time per repo)
Uses OIDC trusted publishing — no API token stored in GitHub secrets.
- pypi.org → project → Settings → Publishing → Add trusted publisher
- Owner:
<github-user>, Repository:<repo>, Workflow:release.yml - Done — the workflow handles authentication automatically.
Branch protection (required for CI gate)
Repo settings → Branches → Add rule for main:
- ✅ Require status checks:
CIjob - ✅ Require branches to be up to date
- ✅ Require linear history
For the auto-bump workflow to push the bump commit back to main:
- ✅ Allow specified actors to bypass → add
github-actions[bot]
Docs
uv run mkdocs serve
Deploy to GitHub Pages on push to main via docs.yml (automatic).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
templatepy-0.13.0.tar.gz
(16.3 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file templatepy-0.13.0.tar.gz.
File metadata
- Download URL: templatepy-0.13.0.tar.gz
- Upload date:
- Size: 16.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4fab504ce8a5878f34b0735356127e6f954523d1a42ff444a1a803e79920960e
|
|
| MD5 |
179b75e47a3e6025d8165c4d788d298b
|
|
| BLAKE2b-256 |
832194912185862f17d404a8ca4db7e235066bb9afd9a0022c8485a8c67a4dcc
|
File details
Details for the file templatepy-0.13.0-py3-none-any.whl.
File metadata
- Download URL: templatepy-0.13.0-py3-none-any.whl
- Upload date:
- Size: 28.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7fb1d5ae9b0f504c62dba1d5351e9b70983cd2c45d141aa355b7df54484623f9
|
|
| MD5 |
ca4a880e652cf77d4e988c307e2daefa
|
|
| BLAKE2b-256 |
54c6035f68fcf75499fca9e99165b563728e79966629b4654d9a0553ef1acc1b
|
