PyProject

Minimal template for a quick start of a Python project.

Highlights

• Actions workflows for CI tests and linting
• Dependabot for automated dependency updates
• Zizmor for GitHub Actions security checks
• Labeler to auto-apply labels to PRs
• Mypy for static typing + Ruff for lint/format
• pre-commit for local hooks before commits
• docker-compose out of the box
• structlog logger included by default
• AGENTS.md for blazingly fast development

Commands

just rename aboba      # set the project name across the repo
just install           # install python dependencies via uv
just lint              # run formatting and lint checks
just test              # run tests via pytest with coverage
just run               # run the application
just up                # run the application via docker compose
just down              # stop the application via docker compose

Configuring

cp config/template.config.yaml config/config.yaml
cp config/template.env config/.env