Python Coding Conventions

Quick Reference

• Python version: Use Python 3.11+ for modern features
• Package manager: Use Astral's uv for dependency and environment management
• Formatting & Linting: Use Astral's ruff (replaces flake8, isort, pylint, Black)
• Type hints: Modern built-in annotations (list[str], dict[str, int])
• Type checking: Use Astral's ty for type checking
• Pre-commit: User prek for pre-commit hooks
• Documentation: Google-style docstrings following PEP 257

Core Instructions