Repository navigation
The first release.
- Python 3.15 first: packages require 3.14 or later, CI tests 3.14 and 3.15 on Linux and macOS, and the Docker image
ispython:3.15-slim. - Eight checks wired in from the first commit: black, isort, editorconfig-checker, darglint, flake8 with pydocstyle
and tidy imports, mypy in strict mode, bandit and pytest with coverage.make checksruns exactly what CI runs. - A man page from the first commit:
docs/MANUAL.mdis the one source for<command> guide,<command> manand
man <command>, and a ninth check fails when they drift apart. - An example command that shows the conventions:
--jsonon every command,guidefor people and agents, exit
codes that mean something. - Releases: publishing a GitHub release builds the wheel and the sdist and attaches them.
make renamerenames the package, its command, its paths and its man page in one go, and drops the files that only
describe the template. CI proves a renamed copy starts green.- Agent ready: an
AGENTS.mdfor coding agents, and a Claude Code plugin with a skill that starts a new package
from the template. - Fixed: installing straight from git failed because
setup.cfgsent egg metadata to a folder that does not exist
in a fresh clone.