the-aios/aios/python-best-practices

Python Best Practices

Curated reference for writing production-quality Python — opinionated where it matters, undogmatic where it doesn't.

When to load which reference

Each reference is an in-depth guide — load only the one relevant to the current task.

Core principles (all references share)

• Explicit over implicit — type hints, named arguments, no magic.
• Small over abstract — one function per concept, no premature inheritance.
• Fail loud at boundaries, validate at the edge — Pydantic/dataclasses at API surfaces, raw types internally.
• Test the behavior, not the implementation — pytest fixtures over class-based setUp, parameterize for variants.

For test-first discipline beyond Python specifics, see superpowers/test-driven-development.