Programme Leçon 55 sur 250 · Python orienté objet
Python orienté objet

Moins de code répétitif avec @dataclass

Écrire à la main __init__, __repr__ et __eq__ pour une simple classe qui contient des données devient répétitif. Le décorateur @dataclass de la bibliothèque standard les écrit pour toi. Tu listes juste les champs avec des annotations de type.

from dataclasses import dataclass

@dataclass
class Point:
    x: int
    y: int

p = Point(1, 2)
print(p)            # Point(x=1, y=2)   (free __repr__)
print(p == Point(1, 2))   # True          (free __eq__)
print(p.x, p.y)     # 1 2

En trois lignes, tu as obtenu un __init__ qui prend x et y, un __repr__ lisible et un __eq__ par valeur. Pas de corvée self.x = x.

Valeurs par défaut et méthodes

Les champs peuvent avoir des valeurs par défaut, et tu peux toujours ajouter tes propres méthodes comme dans toute classe :

from dataclasses import dataclass

@dataclass
class Item:
    name: str
    price: float
    qty: int = 1

    def total(self):
        return self.price * self.qty

i = Item("Pen", 2.5, 4)
print(i.total())   # 10.0

Une mise en garde sur les valeurs par défaut : une valeur par défaut mutable comme tags: list = [] est interdite et lève ValueError: mutable default ... is not allowed. C'est le même piège de valeur par défaut partagée que pour les fonctions, donc les dataclasses le bloquent d'emblée. Utilise plutôt field(default_factory=list), qui donne à chaque instance sa propre liste toute neuve.

from dataclasses import dataclass, field

@dataclass
class Cart:
    items: list = field(default_factory=list)

print(Cart().items)   # []

Les annotations de type (x: int) ne sont pas imposées par Python, elles documentent juste l'intention. Le vrai travail, c'est le code répétitif que génère le décorateur.

À ton tour

Utilise @dataclass pour définir une classe Product avec les champs name (str), price (float) et quantity (int) qui vaut 1 par défaut. Ajoute une méthode subtotal(self) qui renvoie price * quantity. Pense à importer dataclass depuis dataclasses.

Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon

Cet exercice s'ouvre bientôt

Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.