Writing Python Code

All Python code follows the pit-of-success philosophy: strict types, Result-based error handling, modern tooling.

Run project-local tools through uv, not system-installed binaries: uv run python, uv run pytest, uv run ruff, uv run basedpyright, uv run poe, uv run pre-commit. The normal verification pair is uv run poe lint_full and uv run poe test.

Type System

basedpyright Configuration