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 (if enable_pypi_publishing)
                           → Zenodo webhook (if enabled)

PyPI setup (one-time per repo)

Only if you answered enable_pypi_publishing: true (otherwise release.yml makes the GitHub/Forgejo release but skips the publish step). 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 (optional)

Generated projects ship a stepper that creates the repo, points you through installing the release-bot App, and installs a main-protected ruleset (require PR + review + the CI check, block force-push/deletion):

bash scripts/setup_repo.sh          # guided: create → App → protect
# or just the ruleset on an existing repo:
bash scripts/setup_branch_protection.sh

versioning.yml is adaptive: with the App configured (CI_BOT_APP_ID variable + CI_BOT_PRIVATE_KEY secret) it pushes the bump as that App — a ruleset bypass actor — so protection and auto-release coexist; without it, it falls back to github-actions[bot] on an unprotected main. The generated docs/repository-setup.md covers the App, its permissions, and the secrets.

Docs

uv run mkdocs serve

mkdocs.yml + the docs extra are always generated (build locally as above). Deploy to GitHub Pages on push to main via docs.yml is added only when enable_docs_publishing: true.

Optional workflows (copier answers)

Three publish/automation extras are off by default; enable per project:

enable_pypi_publishing — PyPI publish step in release.yml (+ OIDC id-token).
enable_docs_publishing — the GitHub Pages / Forgejo docs.yml deploy workflow.
enable_llm_pr_review — the optional LLM PR-review workflow (pr-review.yml).

When off, the corresponding workflow file is not generated at all (no "not configured" placeholder checks).

Development Status
- 5 - Production/Stable
Intended Audience
- Developers
Programming Language
- Python :: 3
Topic
- Software Development :: Code Generators

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.15.0.tar.gz (21.2 kB view details)

Uploaded Aug 11, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

templatepy-0.15.0-py3-none-any.whl (35.7 kB view details)

Uploaded Aug 11, 2026 Python 3

File details

Details for the file templatepy-0.15.0.tar.gz.

File metadata

Download URL: templatepy-0.15.0.tar.gz
Upload date: Aug 11, 2026
Size: 21.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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

Hashes for templatepy-0.15.0.tar.gz
Algorithm	Hash digest
SHA256	`9a03f77ffdfcd5175ce22586a19e12160cca3d446e4d7220ec20e2ce19d05769`
MD5	`99d484d4e8fb11166b2415a476e23186`
BLAKE2b-256	`d79640e64e68bf87a21e0b3f221b76c5de6b28104bbe428e0ee3252709a564c3`

See more details on using hashes here.

File details

Details for the file templatepy-0.15.0-py3-none-any.whl.

File metadata

Download URL: templatepy-0.15.0-py3-none-any.whl
Upload date: Aug 11, 2026
Size: 35.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","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

Hashes for templatepy-0.15.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`f2af3dd354c6b5da8ce0bb0a722212e9c6b5e8bdfd6d5823af3b33b3c4b70ebf`
MD5	`53b5825033e0416f1ff7f369796fd6a8`
BLAKE2b-256	`d26fd639b8cb2bc2ae521e678ec2d57daab87f5e59d21d4d3b1706136c8e0fea`