Décorateurs de propriété

Fait partie de la section Programmation orientée objet du Journey Python de Coddy. Leçon 14 sur 64.

Les décorateurs de propriété vous permettent de contrôler la manière dont les attributs sont consultés et modifiés, tout en conservant la syntaxe simple des attributs.

Voici un exemple de classe avec un accesseur de propriété :

class Person:
    def __init__(self, name, age):
        self._name = name
        self._age = age
    
    @property
    def age(self):
        return self._age

Utilisez la propriété comme un attribut ordinaire :

person = Person("Alice", 30)
print(person.age)

Sortie :

Notez que vous accédez à age sans parenthèses, même si cela appelle en réalité une méthode.

Ajoutez un setter pour valider les données lors de la définition des valeurs :

class Person:
    def __init__(self, name, age):
        self._name = name
        self._age = age
    
    @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

Vous pouvez maintenant définir age avec une validation automatique :

person = Person("Alice", 30)
person.age = 31     # Utilise le setter avec validation
print(person.age)   # Utilise le getter

# Ceci lèverait une erreur :
# person.age = -5   # ValueError: L'âge ne peut pas être négatif

Sortie :

Créez des propriétés calculées qui calculent des valeurs :

class Rectangle:
    def __init__(self, width, height):
        self.width = width
        self.height = height
    
    @property
    def area(self):
        return self.width * self.height

rect = Rectangle(5, 3)
print(rect.area)  # Calcule 5 * 3 = 15

Sortie :

Point clé : les décorateurs de propriété donnent aux méthodes l’apparence d’attributs. Utilisez @property pour les getters et @attribute_name.setter pour les setters. Cela permet la validation des données et les valeurs calculées tout en conservant une syntaxe simple d’accès aux attributs.

Défi

Moyen

Complétez la classe Temperature dans temperature.py qui convertit les températures entre Celsius et Fahrenheit. Utilisez ensuite cette classe dans driver.py pour tester les conversions de température. Suivez les commentaires TODO dans les deux fichiers pour obtenir des instructions étape par étape.

Affichez chaque conversion au format [celsius]°C is [fahrenheit]°F, avec la valeur Celsius exactement telle qu’elle a été fournie et la valeur Fahrenheit telle que Python la calcule. N’arrondissez pas les nombres et ne les formatez pas. Les deux lignes produites par le programme sont :

25°C is 77.0°F
37.0°C is 98.6°F

Essayez vous-même

# TODO: Importer la classe Temperature depuis le module temperature

# Tester la classe :
# TODO: Créer une instance de température à 25°C
temp = None  # Remplacer par une instance Temperature réelle

# TODO: Afficher les valeurs en Celsius et en Fahrenheit
# TODO: Utiliser le format : "25.0°C is 77.0°F"

# TODO: Définir la température à 98.6°F

# TODO: Afficher à nouveau les deux valeurs pour confirmer que la conversion fonctionne
# TODO: Utiliser le même format qu'auparavant