Accueil › Python › @dataclass : les classes de données
@dataclass : les classes de données
Classes et objetsintermediaire
Beaucoup de classes ne servent qu'à transporter des données. Les écrire à la main est répétitif et donne un résultat médiocre :
class Ligne:
def __init__(self, reference: str, prix: float, quantite: int = 1) -> None:
self.reference = reference
self.prix = prix
self.quantite = quantite
Pas d'affichage lisible (<__main__.Ligne object at 0x7f3a…>), pas d'égalité (deux lignes identiques sont considérées différentes), et le nom de chaque champ écrit trois fois. @dataclass fait le travail :
from dataclasses import dataclass, field
@dataclass
class Ligne:
reference: str
prix: float
quantite: int = 1
>>> a = Ligne("ref-1", 10.0, 2)
>>> a
Ligne(reference='ref-1', prix=10.0, quantite=2)
>>> a == Ligne("ref-1", 10.0, 2)
True
L'annotation est ce qui déclenche tout : un attribut sans annotation n'est pas un champ. Trois options couvrent l'essentiel des besoins :
@dataclass(frozen=True, slots=True)
class Commande:
client: str
lignes: list[Ligne] = field(default_factory=list) # mutable → factory
frozen=Trueinterdit la modification après création — et rend l'objet hachable ;field(default_factory=list)donne une liste par instance ;- une valeur par défaut mutable écrite directement est refusée à l'import :
ValueError: mutable default <class 'list'> for field lignes is not allowed: use default_factory.
Et une précision qui tombe souvent en entretien : les annotations ne valident rien à l'exécution. Ligne("ref", "dix") crée l'objet sans broncher.
Les termes à connaître
- @dataclass
Décorateur de la bibliothèque standard (
from dataclasses import dataclass) qui génère__init__,__repr__et__eq__à partir des attributs annotés du corps de la classe.- Champ (field)
Un attribut de classe annoté :
prix: float. L'annotation est ce qui déclenche la prise en compte ; une ligne sans annotation reste un simple attribut de classe, ignoré par le décorateur.- `field(default_factory=…)`
La façon de donner une valeur par défaut mutable :
lignes: list[Ligne] = field(default_factory=list). La fabrique est appelée à chaque création, donc chaque instance reçoit sa propre liste.- `frozen=True`
Rend les instances immuables : toute affectation lève
FrozenInstanceError. Combiné àeq=True(le défaut), la dataclass devient hachable et peut servir de clé de dictionnaire ou entrer dans unset.- `__post_init__`
Méthode appelée automatiquement à la fin du
__init__généré. C'est l'endroit où placer une validation ou un calcul dérivé, puisqu'on ne peut pas écrire son propre__init__sans perdre celui qui est généré.- `kw_only=True`
Force le passage des arguments par nom :
Commande(client="Camille", total=25.0). Évite les inversions silencieuses entre deux champs de même type et libère de la contrainte d'ordre entre champs avec et sans valeur par défaut.- `slots=True`
Génère
__slots__: les attributs sont stockés dans un emplacement fixe au lieu d'un dictionnaire par objet. Moins de mémoire, accès un peu plus rapide, mais plus d'ajout d'attribut dynamique.- `asdict` / `astuple`
dataclasses.asdict(obj)convertit l'objet en dictionnaire, récursivement sur les dataclasses imbriquées. Pratique pour sérialiser en JSON ; attention, la récursion a un coût sur de grosses structures.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.