CKTIS / Python
Module dataclasses
Generate field-based initialization, representation and equality from a class declaration.
Version: Python 3.14; repository image, production runtime not attested
Syntax
@dataclasses.dataclass(frozen=True)Generate field-based initialization, representation and equality from a class declaration.
Omitting a field invokes its default_factory. The factory list creates a fresh list, whereas a different factory can return a shared object. A frozen dataclass blocks ordinary field rebinding but does not make the contents of a list immutable.
The example mutates one list and catches a rejected field assignment.
Examples
import dataclasses
@dataclasses.dataclass(frozen=True)
class Basket:
items: list[str] = dataclasses.field(default_factory=list)
a, b = Basket(), Basket()
a.items.append("one")
print(a.items, b.items)
try:
a.items = []
except dataclasses.FrozenInstanceError:
print("frozen field")
shared = []
@dataclasses.dataclass
class Shared:
items: list = dataclasses.field(default_factory=lambda: shared)
assert Shared().items is Shared().items is shared
Result
['one'] [] frozen field
The example mutates one list and catches a rejected field assignment.