Introducción a los decoradores

Los decoradores son una función muy útil de Python que permite modificar el comportamiento de funciones o métodos. A menudo se usan para agregar funcionalidad a las funciones sin modificar su código.

En esta lección, aprenderá qué son los decoradores, cómo usarlos y cómo crear sus propios decoradores.

¿Qué es un decorador?

Un decorador es una función que recibe otra función como entrada y devuelve una nueva función con funcionalidad adicional. A menudo se usa con la sintaxis @decorator_name.

# Basic example of a decorator
def decorator(func):
    def wrapper():
        print("Before the function call")
        func()
        print("After the function call")
    return wrapper

@decorator
def say_hello():
    print("Hello!")

say_hello()

Cómo funcionan los decoradores

Cuando usa un decorador, Python reemplaza la función original por la función envoltorio que devuelve el decorador.

# How decorators work
def decorator(func):
    def wrapper():
        print("Wrapper called")
        func()
    return wrapper

@decorator
def greet():
    print("Greetings!")

print(greet.__name__)  # Outputs: wrapper
greet()

Usar decoradores con argumentos

Los decoradores pueden trabajar con funciones que reciben argumentos mediante *args y **kwargs en la función envoltorio:

# Decorator for functions with arguments
def decorator(func):
    def wrapper(*args, **kwargs):
        print(f"Arguments: {args}, {kwargs}")
        return func(*args, **kwargs)
    return wrapper

@decorator
def add(a, b):
    return a + b

print(add(3, 5))

Encadenar varios decoradores

Puede usar varios decoradores en una sola función. Se aplican en el orden en que aparecen, de arriba abajo:

# Chaining multiple decorators
def decorator1(func):
    def wrapper():
        print("Decorator 1")
        func()
    return wrapper

def decorator2(func):
    def wrapper():
        print("Decorator 2")
        func()
    return wrapper

@decorator1
@decorator2
def greet():
    print("Hello!")

greet()

Crear decoradores parametrizados

Los decoradores parametrizados aceptan argumentos y permiten una funcionalidad más flexible:

# Parameterized decorator
def repeat(times):
    def decorator(func):
        def wrapper(*args, **kwargs):
            for _ in range(times):
                func(*args, **kwargs)
        return wrapper
    return decorator

@repeat(3)
def say_hello():
    print("Hello!")

say_hello()

Casos de uso habituales de los decoradores

Los decoradores se utilizan habitualmente para:

• Registrar las llamadas a funciones y sus argumentos.
• Medir el tiempo de ejecución de las funciones.
• Controlar el acceso, por ejemplo, comprobando los permisos de los usuarios.
• Almacenar en caché los resultados para mejorar el rendimiento.

Decoradores integrados en Python

Python proporciona varios decoradores integrados, entre ellos:

• @staticmethod: Define un método estático.
• @classmethod: Define un método de clase.
• @property: Define una propiedad.

Errores comunes con los decoradores

Estos son algunos errores que debe evitar:

• No conservar el nombre y la cadena de documentación de la función original (use functools.wraps).
• Usar decoradores innecesariamente para tareas sencillas.
• Olvidar gestionar los argumentos en la función envoltorio.

¿Qué hemos aprendido?

En esta lección, ha aprendido:

• Qué son los decoradores y cómo funcionan en Python.
• Cómo crear y utilizar decoradores básicos, parametrizados y encadenados.
• Casos de uso habituales y decoradores integrados en Python.

¡Muy bien! Pasemos al siguiente tema.