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_ttcappelle 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èveAttributeError: 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__prixy 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.
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.