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

Des attributs calculés avec @property

Parfois, une valeur doit ressembler à un attribut mais être en réalité calculée à la volée, ou vérifiée avant d'avoir le droit de changer. Le décorateur @property transforme une méthode en quelque chose que tu lis sans parenthèses, comme un attribut normal.

Une valeur calculée en lecture seule

class Rectangle:
    def __init__(self, w, h):
        self.w = w
        self.h = h

    @property
    def area(self):
        return self.w * self.h

r = Rectangle(3, 4)
print(r.area)   # 12, note: no parentheses

Comme area est une propriété, tu écris r.area, pas r.area(). Elle se recalcule à chaque fois, donc elle reste juste même si w ou h changent.

Valider une valeur avec un setter

Tu peux aussi protéger les écritures. Définis la propriété, puis un @<name>.setter assorti. Par convention, la vraie donnée est rangée dans un attribut d'allure privée qui commence par un tiret bas.

class Person:
    def __init__(self, age):
        self.age = age   # this goes through the setter below

    @property
    def age(self):
        return self._age

    @age.setter
    def age(self, value):
        if value < 0:
            raise ValueError("age cannot be negative")
        self._age = value

p = Person(30)
print(p.age)   # 30
p.age = 31     # ok
# p.age = -5   # would raise ValueError

De l'extérieur, ça ressemble toujours à un attribut simple, mais chaque lecture et chaque écriture exécute ton code.

À ton tour

Définis une classe Circle dont le __init__ prend radius et l'affecte à self.radius (ce qui passe par un setter). Ajoute une propriété radius et un setter radius qui lève ValueError pour un nombre négatif, en rangeant la valeur dans self._radius. Ajoute une propriété diameter en lecture seule qui renvoie radius * 2.

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.