CKTIS / Python
dataclasses.dataclass
Génère par défaut initialiseur, représentation et comparaison par valeur à partir des annotations de champs.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
@dataclasses.dataclass(frozen=True)Génère par défaut initialiseur, représentation et comparaison par valeur à partir des annotations de champs.
Une méthode générée ne garantit pas que les valeurs des champs soient hachables. hash sur Item([]) lève TypeError à cause de la liste incluse dans le calcul. Sans __hash__ explicite, eq=True avec frozen=True génère le hachage, une classe mutable avec eq=True est non hachable et eq=False conserve la règle héritée. unsafe_hash=True force la génération. slots=True renvoie une nouvelle classe. Les champs de base suivent le MRO inversé et un champ redéfini conserve sa position. L’égalité produite compare les champs retenus entre instances de la même classe exacte. Deux Point(4) sont donc égaux.
Avec frozen=True réaffecter p.x lève FrozenInstanceError, mais une liste contenue dans un champ gelé peut changer.
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
Exemples
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__)
Résultat
True FrozenInstanceError
Avec frozen=True réaffecter p.x lève FrozenInstanceError, mais une liste contenue dans un champ gelé peut changer.