Python Code Style

Formatting

• Use Ruff for formatting (ruff format .)
• Indentation: 4 spaces
• Max line length: 120 characters
• Use trailing commas in multi-line collections

Naming Conventions

• Functions and variables: snake_case
• Classes: PascalCase
• Constants: UPPER_SNAKE_CASE
• Private members: _leading_underscore
• Module files: snake_case.py

Type Hints

• Required for all function parameters and return types
• Use Optional[T] or T | None for nullable types
• Use list[T], dict[K, V] (lowercase) for Python 3.10+