A one-day start Cookiecutter Python project template with configured up-to-date tools. It is framework-agnostic as it doesn't come with any framework at all at all [for now].

It features:

• Rye as a package manager
• code quality tools via pre-commit: Ruff, MyPy
• development and production Docker Compose YAMLs and staged Dockerfile
• convenient file structure (src/, tests/, deploy/, scripts/, docs/) with some pre-built files
• set-up semantic-release for automatic versioning, and tag+release+changelog via GitHub CI
• pyproject.toml with configured and commented scripts, pytest, coverage, black, ruff, etc.

There are plenty other Cookiecutter Python templates. More sophisticated, more parametrized, more stable. Why then create yet another one?

There are two main reasons.

• It's a good place to store practices, configurations, and tools I encountered throughout my career.
• Most of the templates don't include newer Rust-made tools, Rye and Ruff, that I use extensively.
  • Because of their high performance and convenience, I believe they should dominate sooner or later.

I've spent way too much my own and others' time configuring local file version update (src/__init__.py::__version__). It'd be great to have the same ready-to-use configuration for semantic-release in whatever project/language/paradigm... But it just doesn't work out of the box w/o package.json. .releaserc falls short delivering and would also need an extra prerequisite step --- it's not MPT's purpose. I want it to run with a single click.

To create a new project using this template:

1. Install Cookiecutter if you haven't already:

   pip install cookiecutter

2. Run the following command and follow the prompts:

   cookiecutter python-project-cookiecutter/

• project_name: The name of your project (displayed in documentation).
• project_slug: A slugified version of the project name used for directories and files.
• author_name: Your name or organization.
• license: The license under which your project will be released.
• main_branch_name: Choose between master and main branch.

{{ cookiecutter.project_slug }}/
│
├── .github/workflows/
│   └── ci.yml
│
│   # Contains the main source code files...
├── src/
│   │
│   │   # Unit tests...
│   ├── tests/
│   │   └── __init__.py
│   │
│   │   # `__version__` variable will be located here...
│   └── __init__.py
│
│   # Integrational tests that would require running your server(s)...
├── tests/
│   └── __init__.py
│
├── docs/
│   │   # A template C4 Mermaid diagram...
│   └── c4.md
│
├── requirements/
│   ├── dev.txt
│   └── prod.txt
│
├── scripts/
│   │   # Gunicorn + Uvicorn workers running template script
│   └── start.sh
│
├── deploy/
│   ├── Dockerfile.dev
│   ├── Dockerfile.prod
│   ├── docker-compose.dev.yml
│   └── docker-compose.prod.yml
│
│
├── .gitignore
├── .pre-commit-config.yml
└── pyproject.toml