El patrón de diseño Builder en Python
En esta lección vas a usar el patrón Builder para construir un objeto complejo en varios pasos claros.
Introducción
El problema
Algunos objetos tienen muchas partes opcionales: un informe puede tener título, gráfico, tabla, pie de página o cualquier combinación. Un constructor con diez argumentos opcionales es difícil de leer y fácil de llamar mal. Un builder añade las partes paso a paso, con claridad.
Imagínalo así
Un builder es como pedir un bocadillo en un mostrador. Dices "pan, luego queso, luego tomate", y el bocadillo crece con cada instrucción. Cuando dices "listo", recibes el bocadillo terminado.
ReportBuilder()🍞 Empieza un pedido vacío.add_title()🧀 Añade un ingrediente.add_chart()🍅 Añade otro; el orden importa.build()🥪 Entrega el bocadillo terminadoEl patrón Builder construye un objeto complejo paso a paso con métodos separados y devuelve el objeto terminado con una llamada final a build.
Puntos clave
self.partsreúne las partes añadidas hasta ahora.add_titleyadd_chartañaden una parte cada uno y hacenreturn self, así las llamadas se pueden encadenar.ReportBuilder().add_title().add_chart().build()se lee como una lista de instrucciones.build()convierte las partes reunidas en el texto final del informe.
¿Cuándo se usa?
- Objetos con muchas partes opcionales: informes, peticiones HTTP, consultas SQL, documentos.
- Hacer legible una construcción paso a paso con encadenamiento de métodos.
- Crear variantes distintas con los mismos pasos de construcción.
Cuándo no hace falta
- Objetos con dos o tres campos obligatorios: un constructor normal o una dataclass es más sencillo.
- Código Python donde los argumentos con nombre y valores por defecto ya dejan clara la llamada.
Código de ejemplo
class ReportBuilder:
# Builder: assemble a complex value one optional part at a time.
def __init__(self):
self.parts = []
def add_title(self):
self.parts.append("title")
return self
def add_chart(self):
self.parts.append("chart")
return self
def build(self):
# Hide the final assembly behind one operation.
return "Report: " + ", ".join(self.parts)
report = ReportBuilder().add_title().add_chart().build()
print(report)
Resultado de la ejecución
Report: title, chart
Explicación del código
Cada método, como add_title(), añade una parte al informe y devuelve el propio objeto builder (return self). Así, las llamadas se pueden encadenar en una misma línea. Por último, el método build() junta las partes y devuelve el informe completo, Report: title, chart.
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.
- Sustituye el dominio del ejemplo conservando la estructura del patrón.
- Compara el patrón con una implementación más sencilla y explica las ventajas y desventajas.
- Escribe pruebas para cada participante antes de añadir otra implementación.
Errores comunes
Olvidar devolver self
Sin return self, el encadenamiento falla porque el método devuelve None.
def add_title(self):
self.parts.append("title")
def add_title(self):
self.parts.append("title")
return 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