Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources