How headsrooms/configclasses works
Main Components
a) Core Components:
• Configuration Decorator (@configclass)
• Config Loaders System
• Config Dumpers System
• Type Conversion System
• Exception Handling System
b) File Format Support:
• ENV files (.env)
• YAML files (.yaml)
• TOML files (.toml)
• INI files (.ini)
• JSON files (.json)
┌─ User Application Code ─┐
• @configclass │
• Class Definitions │
• ┬────────────┘
┌─ Config Processing Layer ──┐
• ┌─ Loaders ─┐ ┌─ Dumpers ┐│
• .env │ │.env ││
• .yaml │ │.yaml ││
• .toml │ │.toml ││
• .ini │ │.ini ││
• .json │ │.json ││
• ┘ └──────────┘│
• ┘
┌─ Core Services ──────────┐
• Type Conversion │
• Environment Variables │
• File System Access │
• ┘
Data Flow Representation
• Configuration Definition → Config Processing
• Config Processing → File System / Environment
• File System / Environment → Config Processing
• Config Processing → Type Conversion
• Type Conversion → Final Config Object
Integration Points
How the system integrates with:
• Environment Variables
• File System
• Python Type System
• User's Application Code
Technical Details
• Python 3.8+ requirement
• Optional dependencies for different file formats
• Support for nested configuration classes
• Type conversion capabilities
• Prefix support
The extensible nature of the format support
Remember to show both the static structure (components and their relationships) and the dynamic behavior (how configuration data flows through the system) in separate views if necessary.