CKTIS / Python
dataclasses.dataclass
Z anotací polí standardně vytvoří inicializátor, reprezentaci a porovnání hodnot.
Verze: Python 3.14; repository image, production runtime not attested
Syntaxe
@dataclasses.dataclass(frozen=True)Z anotací polí standardně vytvoří inicializátor, reprezentaci a porovnání hodnot.
Vytvořená metoda nezaručuje hašovatelné hodnoty polí. hash pro Item([]) vyvolá TypeError kvůli seznamu zahrnutému do výpočtu. Bez vlastního __hash__ vytvoří eq=True s frozen=True hašovací metodu, měnitelná třída s eq=True není hašovatelná a eq=False zachová zděděné pravidlo. unsafe_hash=True vynutí vytvoření metody. slots=True vrátí novou třídu. Pole předků se sbírají v obráceném MRO a přepsané pole si zachová pozici. Vytvořená rovnost porovnává vybraná pole instancí přesně téže třídy. Dva objekty Point(4) jsou tedy stejné hodnotou.
Při frozen=True přiřazení p.x vyvolá FrozenInstanceError, ale seznam uložený v zamrzlém poli lze měnit.
from dataclasses import dataclass, FrozenInstanceError
@dataclass(frozen=True)
class Item:
tags: list
x = Item([])
x.tags.append("ok")
assert x == Item(["ok"])
try:
x.tags = []
except FrozenInstanceError:
pass
else:
raise AssertionError
class C: pass
assert dataclass(slots=True)(C) is not C
assert dataclass()(type("A", (), {})).__hash__ is None
assert callable(dataclass(frozen=True)(type("B", (), {})).__hash__)
try:
hash(Item([]))
except TypeError:
pass
else:
raise AssertionError
Příklady
import dataclasses
@dataclasses.dataclass(frozen=True)
class Point:
x: int
p = Point(4)
print(p == Point(4))
try:
p.x = 9
except dataclasses.FrozenInstanceError as error:
print(type(error).__name__)
Výsledek
True FrozenInstanceError
Při frozen=True přiřazení p.x vyvolá FrozenInstanceError, ale seznam uložený v zamrzlém poli lze měnit.