$ show audreyfeldroy/cookiecutter-pypackage
Cookiecutter PyPackage is a cookiecutter template that generates a modern Python package project with production-ready tooling. It produces a src-layout package with a Typer CLI, pytest tests, Ruff linting, ty type checking, uv dependency management, and a justfile task runner. The generated project includes security-hardened GitHub Actions workflows for CI, PyPI publishing via Trusted Publishers, documentation deployment with Zensical, CodeQL and zizmor security scanning, and Dependabot for dependency updates. The template itself is a Python package with a CLI wrapper around cookiecutter, a development watcher for live template iteration, and a comprehensive post-generation hook that optionally sets up a GitHub repository, enables Pages, and creates the PyPI environment. The codebase demonstrates strong engineering practices: comprehensive test coverage, clear separation of concerns, and thoughtful security defaults. It is actively maintained with recent commits and a well-documented changelog.
The LLM identified 4 files worth highlighting for reuse:
A self-contained Python script that finalizes release notes, creates annotated git tags, pushes to origin, and creates GitHub releases. It handles interrupted releases gracefully by detecting existing tags and GitHub releases, and supports both the new unreleased.md lifecycle and legacy versioned changelog files. The script is fully testable with monkeypatched subprocess calls and demonstrates robust error handling for release preconditions.
A post-generation hook that optionally sets up a GitHub repository, initializes Git, enables Pages, creates the PyPI environment, and pushes the first commit. It implements a safe, consent-driven flow: checks for GitHub CLI availability, validates repository state, shows a detailed plan before any writes, and handles failures gracefully without leaving partial state. The hook is thoroughly tested with mocked subprocess calls and supports both interactive and non-interactive modes.
A development watcher that monitors changes to the template directory and cookiecutter.json, then automatically regenerates the output project. Uses watchdog for file system events with a debounce period to avoid rapid re-runs. This pattern is reusable for any cookiecutter template development workflow, enabling fast iteration without manual re-generation.
A Typer-based CLI that wraps cookiecutter with additional features: listing template variables, forwarding extra context, and controlling GitHub setup mode via environment variable. It demonstrates a clean pattern for building a CLI around cookiecutter with proper error handling and environment restoration. The template location logic supports both installed package and source checkout scenarios.