audreyfeldroy / cookiecutter-pypackage
Cookiecutter template for a Python package.
AI Architecture Analysis
This repository is indexed by RepoMind. By analyzing audreyfeldroy/cookiecutter-pypackage in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.
Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.
Embed this Badge
Showcase RepoMind's analysis directly in your repository's README.
Repository Overview (README excerpt)
Crawler viewCookiecutter PyPackage Cookiecutter template for a Python package with production-ready CI and automated PyPI publishing. Push a tag, your package ships, no token management needed. What you get Tooling | | Tool | | |---|---|---| | Package manager | uv | Fast, handles venvs automatically | | Task runner | just | formats, lints, type-checks, and tests | | Linting | ruff | Format + lint in one tool | | Type checking | ty | All rules enabled, watch mode with | | Testing | pytest | Python 3.12, 3.13, 3.14 | | CLI framework | Typer | Entry point + included | | Docs | Zensical + mkdocstrings | Auto-deployed to GitHub Pages, API docs from docstrings | CI/CD (GitHub Actions, security-hardened) | Workflow | Trigger | What happens | |---|---|---| | **CI** | Push, PRs | Lint, type check, test across 3 Python versions | | **Publish** | tag | Build, Sigstore attestation, PyPI via Trusted Publishers (no tokens) | | **Docs** | Push to main | Build and deploy to GitHub Pages | | **Dependabot** | Weekly | PRs to update SHA-pinned actions | All actions pinned by SHA, minimal permissions, no persisted credentials. Quickstart Install uv, then: You'll be prompted for your package name, GitHub username, and a few other values (full list). Then push to GitHub and follow the tutorial to enable Pages and set up PyPI publishing. Without uvx Documentation **audreyfeldroy.github.io/cookiecutter-pypackage** • Tutorial - from generation to first PyPI release • Project Structure - what's in the generated project • GitHub Actions - CI, publish, docs deployment, security hardening • Prompts - what each prompt means • Troubleshooting Alternatives This template is opinionated. If it doesn't fit: • Browse the fork network for variants • Create your own template from scratch Pull requests welcome if they're small, atomic, and improve the template. --- Discord | MIT license