python-sdk-config-pattern

What problem does it solve?

It streamlines the creation of robust, immutable configuration classes for Python SDKs, reducing errors and improving maintainability.

Core Features & Use Cases

• Typed and immutable configs: Defines configurations as frozen @dataclass or pydantic models, preventing post-construction mutation.
• Validation and normalization: Incorporates runtime validation via __post_init__ or pydantic validators for complex rules.
• Factories from environment and URLs: Provides class methods like from_env() and from_url() to simplify configuration loading from external sources.
• Use Case: Quickly build a secure SDK client configuration that loads API keys from environment variables, with validation on URLs and timeouts.

Quick Start

Define a Config class with @dataclass or pydantic, then instantiate it directly or via the from_env() factory to load settings securely and immutably.