Frozen Dataclasses¶

The @frozen_dataclass decorator creates immutable configuration classes.

Basic Usage¶

from vidhi import frozen_dataclass

@frozen_dataclass
class Config:
    name: str
    value: int = 10

config = Config(name="test")
config.value = 20  # Raises AttributeError

Post-Initialization¶

Modify attributes during __post_init__ using object.__setattr__():

@frozen_dataclass
class Config:
    value: int = 10
    doubled: int = None

    def __post_init__(self):
        object.__setattr__(self, "doubled", self.value * 2)

Field Helper¶

The field() function adds CLI metadata to fields:

from vidhi import frozen_dataclass, field

@frozen_dataclass
class Config:
    learning_rate: float = field(
        0.001,
        help="Learning rate for optimizer",
        name="lr"  # CLI alias: --lr instead of --learning_rate
    )

Parameters:

default: Default value
help: Help text for --help output
name: Custom CLI argument name