Patrones de diseño en Python

El patrón de diseño Decorator en Python

En esta lección vas a usar el patrón Decorator para añadir funciones a un objeto sin modificar su clase.

  • Avanzado
  • 3 min de lectura
  • 1 ejemplo ejecutable

Introducción

El problema

Quieres añadir un comportamiento extra a un objeto, como registro, formato o caché, sin cambiar su clase y sin crear una subclase para cada combinación de extras.

Imagínalo así

El patrón Decorator es como envolver un regalo. El regalo sigue siendo el mismo; cada capa añade algo: primero el papel, luego un lazo, luego una tarjeta. Puedes añadir capas en cualquier orden, y el resultado sigue siendo un regalo que entregas de la misma forma.

Del papel de regalo al código
Message()🎁 El regalo original
Uppercase(...)🧻 Una capa que cambia su aspecto
Logger(...)🎀 Otra capa encima
.render()🤲 Se entrega igual: LOG: HELLO
Cada envoltorio ofrece el mismo método y añade su propio comportamiento.
En una frase

El patrón Decorator envuelve un objeto en otro objeto con la misma interfaz, que llama al objeto envuelto y añade comportamiento antes o después.

Puntos clave

  1. Message.render() devuelve "hello".
  2. Uppercase guarda el objeto envuelto y devuelve su resultado en mayúsculas.
  3. Logger añade "LOG: " delante del resultado del objeto envuelto.
  4. Logger(Uppercase(Message())).render() apila los dos envoltorios y da "LOG: HELLO".

¿Cuándo se usa?

  • Añadir registro, caché, validación o formato alrededor de objetos existentes.
  • Combinar extras opcionales sin una subclase para cada combinación.
  • Entender la sintaxis @decorator de Python, que aplica la misma idea a las funciones.

Cuándo no hace falta

  • Solo hace falta un comportamiento extra fijo: cambia la clase o añade un método.
  • Muchas capas que dependen del orden de las demás: la pila se vuelve difícil de entender.

Código de ejemplo

Ejecutar código →
main.py
class Message:
    # Decorator: wrap an object to add behavior dynamically.
    def render(self): return "hello"


class Uppercase:
    def __init__(self, wrapped): self.wrapped = wrapped
    def render(self): return self.wrapped.render().upper()


class Logger:
    def __init__(self, wrapped): self.wrapped = wrapped

    def render(self):
        # Add behavior while preserving the render interface.
        return "LOG: " + self.wrapped.render()


print(Logger(Uppercase(Message())).render())
Obtén un botón Run para este ejemplo

Resultado de la ejecución

LOG: HELLO

Explicación del código

Uppercase envuelve el objeto Message y pasa el resultado a mayúsculas, y después Logger envuelve Uppercase y añade el prefijo LOG:. Las tres clases tienen el método render(), así que pueden envolverse unas a otras en cualquier orden. El resultado final es LOG: HELLO.

Cambia los valores y ejecuta el programa en el compilador Python online de CodeUtility sin instalar Python.

Ejercicios de práctica

Prueba a modificar el código siguiendo las ideas de abajo. Cambiar el código y ver el resultado te ayudará a entender la lección mucho mejor que solo leerla.

  1. Sustituye el dominio del ejemplo conservando la estructura del patrón.
  2. Compara el patrón con una implementación más sencilla y explica las ventajas y desventajas.
  3. Escribe pruebas para cada participante antes de añadir otra implementación.
Ejecutar en el compilador de Python →

Errores comunes

Romper la interfaz común

Un envoltorio con otro nombre de método no se puede volver a envolver ni usar en lugar del original.

Problema
class Uppercase:
    def show(self): ...
Solución
class Uppercase:
    def render(self): ...

¿Terminaste esta lección?

Márcala como aprendida para seguir tu progreso.

Practica con un reto

Usa lo que cubre esta lección para resolver un problema real. Cada reto se ejecuta en el navegador, con pruebas al instante y una revisión de IA.

Todos los retos