Patrones de diseño en Python

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.

  • Avanzado
  • 3 min de lectura
  • 1 ejemplo ejecutable

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.

Del mostrador de bocadillos al código
ReportBuilder()🍞 Empieza un pedido vacío
.add_title()🧀 Añade un ingrediente
.add_chart()🍅 Añade otro; el orden importa
.build()🥪 Entrega el bocadillo terminado
Añade las partes que necesitas y luego construye el resultado.
En una frase

El 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

  1. self.parts reúne las partes añadidas hasta ahora.
  2. add_title y add_chart añaden una parte cada uno y hacen return self, así las llamadas se pueden encadenar.
  3. ReportBuilder().add_title().add_chart().build() se lee como una lista de instrucciones.
  4. 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

Ejecutar código →
main.py
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)
Obtén un botón Run para este ejemplo

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.

  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

Olvidar devolver self

Sin return self, el encadenamiento falla porque el método devuelve None.

Problema
def add_title(self):
    self.parts.append("title")
Solución
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