Knowledge baseExam Center
ENEnglish
Choose language13

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.

Sources