CKTIS / Python
dataclasses.dataclass
Genera per impostazione predefinita inizializzatore, rappresentazione e confronto per valore dalle annotazioni dei campi.
Versione: Python 3.14; repository image, production runtime not attested
Sintassi
@dataclasses.dataclass(frozen=True)Genera per impostazione predefinita inizializzatore, rappresentazione e confronto per valore dalle annotazioni dei campi.
Il metodo generato non garantisce che i valori dei campi siano hashabili. hash su Item([]) solleva TypeError a causa della lista inclusa nel calcolo. Senza __hash__ esplicito, eq=True con frozen=True genera lo hash, una classe mutabile con eq=True non è hashabile ed eq=False conserva la regola ereditata. unsafe_hash=True forza la generazione. slots=True restituisce una nuova classe. I campi base seguono il MRO inverso e un campo ridefinito mantiene la posizione. L’uguaglianza generata confronta i campi selezionati di istanze della stessa identica classe. Due Point(4) sono quindi uguali.
Con frozen=True riassegnare p.x solleva FrozenInstanceError, ma una lista in un campo congelato può cambiare.
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
Esempi
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__)
Risultato
True FrozenInstanceError
Con frozen=True riassegnare p.x solleva FrozenInstanceError, ma una lista in un campo congelato può cambiare.