Formations — 1 037 leçons en français

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

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 un set.

`__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.

Lire l'explication détaillée et faire le quiz →

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.