What problem does it solve?
Reduce inconsistent, hard-to-maintain, and non-idiomatic Python code by providing clear patterns, conventions, and practical guidance that improve readability, safety, and long-term maintainability.
Core Features & Use Cases
- Idiomatic Patterns: Guidelines for readability, explicit behavior, EAFP, comprehensions, and when to prefer generators or context managers.
- Typing & Validation: Recommendations for modern type hints, Protocol-based duck typing, TypeVar usage, and integrating mypy or other type checkers.
- Error Handling & Tooling: Best practices for specific exception handling, exception chaining, custom exception hierarchies, and integration with black, ruff, isort, pytest, and CI workflows.
- Performance & Concurrency: Patterns for memory efficiency (slots), generator-based streaming, threading vs multiprocessing, and async/await for concurrent I/O.
- Use Case: Refactor a legacy module to adopt type hints, improve error handling, add tests, and align formatting and linting for a production codebase.
Quick Start
Use the python-patterns skill to refactor a function for readability, add type hints, and suggest unit tests.
