Programme Leçon 63 sur 250 · Code pythonique, tests et projet final
Code pythonique, tests et projet final

Les décorateurs

Un décorateur est une fonction qui en enveloppe une autre pour lui ajouter un comportement, sans changer le corps de l'originale. On l'applique avec la syntaxe @ placée au-dessus d'un def.

La forme est toujours la même : prends une fonction, définis une fonction interne wrapper qui fait quelque chose en plus puis appelle l'originale, et renvoie le wrapper.

def shout(func):
    def wrapper(*args, **kwargs):
        result = func(*args, **kwargs)
        return result.upper()
    return wrapper

@shout
def greet(name):
    return f"hi {name}"

print(greet("ada"))   # HI ADA

Écrire @shout au-dessus de greet est juste un raccourci pour greet = shout(greet). À partir de là, le nom greet pointe vers le wrapper.

Les *args, **kwargs du wrapper lui permettent d'accepter tous les arguments que prend l'originale, puis de les transmettre. Ça garde le décorateur générique.

functools.wraps

Envelopper remplace la fonction, donc le nom et la docstring de l'originale se retrouvent cachés derrière wrapper. Corrige ça en décorant le wrapper lui-même avec functools.wraps(func), qui recopie les métadonnées. Fais-le toujours sur les vrais décorateurs :

import functools

def double(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs) * 2
    return wrapper

@double
def add(a, b):
    """Add two numbers."""
    return a + b

print(add(3, 4))        # 14
print(add.__name__)     # 'add'  (preserved by wraps)
À ton tour

Écris un décorateur double qui double la valeur renvoyée par toute fonction qu'il enveloppe. Utilise functools.wraps pour que la fonction enveloppée garde son __name__. Puis applique-le avec @double à une fonction add(a, b) qui renvoie a + b, pour que add(3, 4) donne 14 et que add.__name__ vaille toujours "add".

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.