python-style

When writing Python code:

• Always include type annotations for function parameters and return values.
• Write docstrings for all public functions using Google-style format.
• Follow PEP 8 naming conventions (snake_case for functions/variables, PascalCase for classes).
• Keep functions small and focused on a single responsibility.
• Handle edge cases explicitly rather than relying on implicit behavior.
• Prefer functions over classes when possible.
• Use list comprehensions and generator expressions where appropriate.
• Prefer streaming/iterative approaches over loading entire datasets into memory.