Decorator: Adding Superpowers

Why this matters

Inheritance is the obvious solution when you need to add behavior — until you need combinations. A coffee shop with Espresso, Milk, Sugar, and Caramel can produce 16 combinations. Subclassing gives you 16 classes. Adding Vanilla makes it 32. The Decorator pattern escapes this explosion: each wrapper implements the same interface and holds a reference to another instance of that interface. You stack decorators like LEGO bricks — unlimited combinations from a small set of parts.

La herencia es la solución obvia cuando necesitas añadir comportamiento — hasta que necesitas combinaciones. Una cafetería con Espresso, Leche, Azúcar y Caramelo puede producir 16 combinaciones. La herencia te da 16 clases. Añadir Vainilla lo hace 32. El patrón Decorator escapa esta explosión: cada envoltorio implementa la misma interfaz y contiene una referencia a otra instancia de esa interfaz. Apila decoradores como piezas LEGO — combinaciones ilimitadas de un pequeño conjunto de partes.

✗ The problem

✓ The solution

In the wildEn la práctica

Python's own @functools.wraps, logging handlers, and middleware stacks all use the Decorator pattern. Django and FastAPI middleware layers are decorators. The pattern is also the foundation of Python's @decorator syntax, though function decorators are a simpler variant that wraps callables rather than objects.

El propio @functools.wraps de Python, los manejadores de logging y las pilas de middleware usan el patrón Decorator. Las capas de middleware de Django y FastAPI son decoradores. El patrón también es la base de la sintaxis @decorator de Python, aunque los decoradores de funciones son una variante más simple que envuelve callables en lugar de objetos.