python-conventions

Python Conventions

Package Management

Use uv exclusively:

uv sync          # Install dependencies
uv lock          # Regenerate lock file
uv add "pkg"     # Add dependency
uv run <cmd>     # Run in project environment

Lock files: Never manually edit. Delete and regenerate:

rm uv.lock && uv lock

Linting

Tools (in order):

1. ruff check --fix - Linting
2. ruff format - Formatting
3. mypy - Type checking

Run all: uv run pre-commit run --all-files

Inline Ignores

Always include justification:

from module import thing  # noqa: PLC0415 - Lazy import after validation

Environment

Clear inherited environments:

unset VIRTUAL_ENV
uv sync