Python Template

"Batteries included but not welded shut"

A minimal, professional baseline for Python projects.

This template aims to answer the recurring questions that appear in every real project: configuration, logging, code quality, testing, automation, and reproducible local development.

It provides defaults that are easy to keep, easy to change, and easy to remove.

---

Table of Contents

• What you get
• Project structure
• Getting started
• Make targets
• Configuration
• Logging
• Quality & Testing
• CI
• Docker
• How to extend

---

What you get

Included out of the box:

• Poetry dependency management
• Ruff for linting + formatting
• Pytest testing setup
• Pre-commit hooks (TODO)
• Typed configuration via settings.py
• Structured logging via logging.py (TODO)
• TBD

---

Project structure

High-level structure:

• src/app/ — application package
• docs/ — architecture notes, runbooks, decision records
• TBD

This separation keeps the core portable and avoids coupling everything to a specific runtime.

---

Getting started

TBD

Setup