template-py

Python template repository

Requirements

• uv: Python package manager
• Task: Task runner

You can use the provided dev container to automatically set up the development environment with all requirements.

Tech Stack

Dependencies

• Pydantic: Data validation and settings management using Python type annotations
• structlog: Structured logging for better observability

Development Tools

• uv: Fast Python package manager and resolver
• Ruff: An extremely fast Python linter and code formatter
• Pyright: Static type checker for Python
• pytest: Testing framework for Python
• pip-audit: Security vulnerability scanner for Python packages
• Task: Simple task runner

Run app

Sync the project; e.g. install dependencies, etc.

uv sync

Convenient commands are defined in Taskfile.yaml. You can run them with:

# run the main script
task run
# check code quality
task check

You can see all available commands with:

task --list-all

How create this template

Initialize the project

uv init --package --build-backend uv

Edit some configurations in pyproject.toml.