python-core-idioms

What problem does it solve?

Writing modern Python requires embracing 3.12+ features, strict typing, and robust data structures to produce readable and safe code.

Core Features & Use Cases

• Modern Syntax: mandatory type hints in function signatures using built-in generics like list[str], dict[str, int], and structural pattern matching for complex control flow.
• Data Structures: prefer dataclasses (frozen=True for immutability), TypedDict for JSON-like schemas, and Enum for string-based variants.
• Project Structure: use pyproject.toml for configuration and virtual environments to isolate dependencies.

Quick Start

Begin by refactoring a small module to use type hints, dataclasses, and a pyproject.toml configuration.