Python Pro

Guidelines for writing clean, performant, and idiomatic Python code.

Core Principles

1. Pythonic code - Follow PEP 8, use Python idioms
2. Composition over inheritance - Prefer mixins and protocols
3. Explicit is better than implicit - Clear error handling
4. Generators for efficiency - Lazy evaluation for large datasets
5. Type hints everywhere - Enable static analysis with mypy

Code Patterns

Type Hints (Python 3.10+)

from typing import Protocol, TypeVar, Generic
from collections.abc import Callable, Iterator