Formations — 1 037 leçons en français

Accueil › Python › @property et l'encapsulation à la Python

@property et l'encapsulation à la Python

Classes et objetsintermediaire

En Java, on écrit des accesseurs par avance parce que passer d'un attribut public à une méthode casserait tous les appels. En Python, ce problème n'existe pas : @property permet de glisser du code derrière un accès qui garde exactement la même syntaxe.

class Produit:
    def __init__(self, reference: str, prix: float) -> None:
        self.reference = reference
        self.prix = prix              # attribut nu, et c'est très bien

Le jour où le prix ne doit plus pouvoir être négatif, rien ne change pour les appelants :

class Produit:
    def __init__(self, reference: str, prix: float) -> None:
        self.reference = reference
        self.prix = prix              # passe par le setter ci-dessous

    @property
    def prix(self) -> float:
        return self._prix

    @prix.setter
    def prix(self, valeur: float) -> None:
        if valeur < 0:
            raise ValueError(f"prix négatif : {valeur}")
        self._prix = valeur

produit.prix et produit.prix = 12.0 s'écrivent toujours pareil. C'est tout l'argument : l'accesseur écrit « au cas où » ne protège de rien, donc on ne l'écrit pas.

Une propriété sans setter est en lecture seule — pratique pour une valeur dérivée :

    @property
    def prix_ttc(self) -> float:
        return round(self._prix * 1.2, 2)

Deux points de vigilance. Le nom de stockage doit différer de celui de la propriété (_prix, pas prix), sinon vous obtenez RecursionError: maximum recursion depth exceeded. Et l'encapsulation en Python est une convention : _prix signale « interne », le langage n'interdit rien.

Les termes à connaître

@property

Décorateur qui transforme une méthode en attribut en lecture : produit.prix_ttc appelle la méthode, sans parenthèses. Permet d'ajouter un calcul ou un contrôle derrière un accès qui avait toujours l'air d'un simple attribut.

Setter

La méthode d'écriture associée, déclarée @prix.setter. Sans elle, la propriété est en lecture seule et toute affectation lève AttributeError: property 'prix' of 'Produit' object has no setter.

Convention `_nom`

Un seul souligné en préfixe signale « interne, ne vous appuyez pas dessus ». Rien n'est interdit par le langage : c'est un contrat entre développeurs, et il suffit dans la pratique.

Name mangling (`__nom`)

Deux soulignés en préfixe font renommer l'attribut en _Classe__nom à la compilation. Le but est d'éviter les collisions de noms entre une classe et ses sous-classes, pas de rendre l'attribut privé : obj._Produit__prix y accède sans difficulté.

Attribut public d'abord

La pratique Python : on expose l'attribut directement, et on le remplace par une propriété le jour où un contrôle devient nécessaire. Le code appelant ne change pas d'une ligne — c'est ce qui rend les accesseurs écrits par avance inutiles.

`functools.cached_property`

Variante qui calcule la valeur une seule fois et la mémorise dans l'instance. Pour un calcul coûteux sur un objet dont les données ne changent plus ; dangereuse si elles changent, car rien n'invalide le cache.

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.