Temario Lección 63 de 250 · Código Pythonic, Pruebas y Proyecto Final
Código Pythonic, Pruebas y Proyecto Final

Decoradores

Un decorador es una función que envuelve a otra función para añadirle comportamiento sin cambiar el cuerpo de la original. Se aplica con la sintaxis @ colocada encima de un def.

La forma es siempre la misma: recibes una función, defines dentro un wrapper que hace algo extra y luego llama a la original, y devuelves el 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

Escribir @shout encima de greet es solo una abreviatura de greet = shout(greet). A partir de ahí, el nombre greet apunta al wrapper.

El *args, **kwargs del wrapper le permite aceptar cualquier argumento que reciba la original y pasárselo. Eso mantiene el decorador genérico.

functools.wraps

Envolver sustituye la función, así que el nombre y el docstring de la original quedan ocultos detrás de wrapper. Arréglalo decorando el propio wrapper con functools.wraps(func), que copia los metadatos. Hazlo siempre en los decoradores reales:

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)
Tu turno

Escribe un decorador double que duplique el valor de retorno de cualquier función que envuelva. Usa functools.wraps para que la función envuelta mantenga su __name__. Luego aplícalo con @double a una función add(a, b) que retorna a + b, de modo que add(3, 4) da 14 y add.__name__ sigue siendo "add".

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.