{"id":21623520,"url":"https://github.com/natelandau/cookiecutter-python","last_synced_at":"2025-11-08T23:03:44.465Z","repository":{"id":89065045,"uuid":"601175160","full_name":"natelandau/cookiecutter-python","owner":"natelandau","description":"Opinionated Cookiecutter template for creating CLI applications using uv and Typer","archived":false,"fork":false,"pushed_at":"2025-01-06T22:21:01.000Z","size":277,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-18T12:42:37.265Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/natelandau.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-02-13T14:23:28.000Z","updated_at":"2024-11-15T21:18:34.000Z","dependencies_parsed_at":"2024-01-06T21:26:54.552Z","dependency_job_id":"b8ceee5f-c189-4fe6-b034-180ae3b2e7f7","html_url":"https://github.com/natelandau/cookiecutter-python","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/natelandau/cookiecutter-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natelandau%2Fcookiecutter-python","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natelandau%2Fcookiecutter-python/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natelandau%2Fcookiecutter-python/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natelandau%2Fcookiecutter-python/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/natelandau","download_url":"https://codeload.github.com/natelandau/cookiecutter-python/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natelandau%2Fcookiecutter-python/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":272252495,"owners_count":24900668,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-26T02:00:07.904Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-25T00:13:14.077Z","updated_at":"2025-11-08T23:03:39.423Z","avatar_url":"https://github.com/natelandau.png","language":"Python","readme":"# Cookiecutter Python CLI Template\n\n[![Automated Tests](https://github.com/natelandau/cookiecutter-python/actions/workflows/main.yml/badge.svg)](https://github.com/natelandau/cookiecutter-python/actions/workflows/main.yml) [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://github.com/natelandau/cookiecutter-python/blob/master/LICENSE) [![Changelog](https://img.shields.io/github/v/tag/natelandau/cookiecutter-python)](https://github.com/natelandau/cookiecutter-python/tags)\n\nOpinionated [Cookiecutter](https://github.com/cookiecutter/cookiecutter) template for creating Python CLI applications with [Typer](https://typer.tiangolo.com/) and [uv](https://github.com/astral-sh/uv).\n\n## Features\n\n-   Packaging and dependency management with [uv](https://github.com/astral-sh/uv)\n-   Task running with [Poe the Poet](https://github.com/nat-n/poethepoet)\n-   Linting and code formatting with [ruff](https://github.com/charliermarsh/ruff)\n-   Type checking with [mypy](https://github.com/python/mypy)\n-   Spell checking with [typos](https://github.com/crate-ci/typos)\n-   Pre-commit hooks with [pre-commit](https://pre-commit.com/)\n-   Automated testing with [GitHub Actions](https://docs.github.com/en/actions)\n-   Code coverage with [codecov](https://about.codecov.io/)\n-   Optional publishing as a package to PyPI and a Docker image to GitHub Container Registry via GitHub Actions\n-   Follows the [Conventional Commits](https://www.conventionalcommits.org/) standard to automate [Semantic Versioning](https://semver.org/) and [Keep A Changelog](https://keepachangelog.com/) with [Commitizen](https://github.com/commitizen-tools/commitizen)\n-   Automated dependency updating with [Dependabot](https://docs.github.com/en/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates)\n\n---\n\n## Usage\n\nTo create a new Python project with this template:\n\n```bash\nuvx cookiecutter https://github.com/natelandau/cookiecutter-python.git\n```\n\nIf you don't have [uv](https://github.com/astral-sh/uv) or [Cookiecutter](https://github.com/cookiecutter/cookiecutter) installed, then run the following two commands.\n\n```bash\npip install cookiecutter\ncookiecutter https://github.com/natelandau/cookiecutter-python.git\n```\n\nOnce installed, run the following to install the project dependencies and activate the virtual environment:\n\n```bash\nuv sync\nsource .venv/bin/activate\n```\n\n## Configuring CI workflows\n\nBuilt-in workflows are configured for linting, testing, and optionally publishing to PyPI and GitHub Container Registry. Be certain to review the workflows to remove any steps that are not desired.\n\n### PyPI Publishing\n\nTo publish to PyPI, two GitHub Actions secrets need to be set:\n\n-   `TWINE_USERNAME`: If using a username/password for PyPI, your PyPI username. If using an API token, set this to `__token__`.\n-   `TWINE_PASSWORD`: Your PyPI password or API token.\n\nEnjoy!\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatelandau%2Fcookiecutter-python","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnatelandau%2Fcookiecutter-python","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatelandau%2Fcookiecutter-python/lists"}