https://github.com/viseshrp/yapc

Yet Another Python Cookiecutter
https://github.com/viseshrp/yapc

Last synced: 6 months ago
JSON representation

Yet Another Python Cookiecutter

• Host: GitHub
• URL: https://github.com/viseshrp/yapc
• Owner: viseshrp
• License: mit
• Created: 2025-02-28T23:26:05.000Z (7 months ago)
• Default Branch: main
• Last Pushed: 2025-03-26T16:32:57.000Z (7 months ago)
• Last Synced: 2025-03-26T16:37:09.888Z (7 months ago)
• Language: Python
• Size: 180 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE

Awesome Lists containing this project

README

          

# yapc

[![Build status](https://img.shields.io/github/actions/workflow/status/viseshrp/yapc/main.yml?branch=main)](https://github.com/viseshrp/yapc/actions/workflows/main.yml?query=branch%3Amain)

[![Supported Python versions](https://img.shields.io/badge/python-3.9_%7C_3.10_%7C_3.11_%7C_3.12_%7C_3.13-blue?labelColor=grey&color=blue)](https://github.com/viseshrp/yapc/blob/main/pyproject.toml)

[![License](https://img.shields.io/github/license/viseshrp/yapc)](https://img.shields.io/github/license/viseshrp/yapc)

This is a modern Cookiecutter template that can be used to initiate a Python project with all the necessary tools for development, testing, and deployment. It supports the following features:

- [uv](https://docs.astral.sh/uv/) for dependency management

- Supports both [src and flat layout](https://packaging.python.org/en/latest/discussions/src-layout-vs-flat-layout/).

- CI/CD with [GitHub Actions](https://github.com/features/actions)

- Pre-commit hooks with [pre-commit](https://pre-commit.com/)

- Code quality with [ruff](https://github.com/charliermarsh/ruff), [mypy](https://mypy.readthedocs.io/en/stable/) and [deptry](https://github.com/fpgmaas/deptry/).

- Publishing to [PyPI](https://pypi.org) by creating a new release on GitHub

- Testing and coverage with [pytest](https://docs.pytest.org/en/7.1.x/) and [codecov](https://about.codecov.io/)

- Compatibility testing for multiple versions of Python with [tox-uv](https://github.com/tox-dev/tox-uv)

- Containerization with [Docker](https://www.docker.com/)

## Quickstart

On your local machine, navigate to the directory in which you want to

create a project directory, and run the following command:

```bash

uvx cookiecutter https://github.com/viseshrp/yapc.git

```

or if you don't have `uv` installed yet:

```bash

pip install cookiecutter

cookiecutter https://github.com/viseshrp/yapc.git

```

Follow the prompts to configure your project. Once completed, a new directory containing your project will be created. Then navigate into your newly created project directory and follow the instructions in the `README.md` to complete the setup of your project.

## Acknowledgements

This project is based on the [cookiecutter-uv](https://github.com/fpgmaas/cookiecutter-uv)

repository.