Python Programming Guide

Toolchain

• Type Checking: ty check <FILE_PATH> --output-format concise
• Lint: ruff check --fix --unsafe-fixes <FILE_PATH>
• Format: ruff format <FILE_PATH>
• Run tests: uv run pytest
• Sync deps: uv sync --upgrade
• NEVER use python; use uv run instead

References

When deeply modifying code in these areas, you MUST read the corresponding document first:

• references/async-programming.md - before modifying anyio/async code
• references/type-hints-cheat-sheet.md - before modifying complex type annotations
• references/exceptions.md - before modifying error handling
• references/logging.md - before modifying logging