CKTIS / Python
dataclasses.dataclass
Genereert standaard een initialisatiemethode, representatie en waardevergelijking uit veldannotaties.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
@dataclasses.dataclass(frozen=True)Genereert standaard een initialisatiemethode, representatie en waardevergelijking uit veldannotaties.
Een gegenereerde methode garandeert geen hashbare veldwaarden. hash op Item([]) geeft TypeError door de lijst die meetelt in de berekening. Zonder eigen __hash__ genereren eq=True en frozen=True een hash, een veranderlijke klasse met eq=True is niet hashbaar en eq=False behoudt de geërfde regel. unsafe_hash=True dwingt generatie af. slots=True geeft een nieuwe klasse. Basisvelden worden in omgekeerde MRO verzameld en een overschreven veld behoudt zijn positie. De gegenereerde gelijkheid vergelijkt de geselecteerde velden van instanties van exact dezelfde klasse. Twee Point(4) zijn dus gelijk.
Met frozen=True geeft opnieuw toewijzen van p.x FrozenInstanceError, maar een lijst in een bevroren veld kan veranderen.
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
Voorbeelden
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__)
Resultaat
True FrozenInstanceError
Met frozen=True geeft opnieuw toewijzen van p.x FrozenInstanceError, maar een lijst in een bevroren veld kan veranderen.