Padrões de projeto em Python

Padrão de projeto Builder em Python

Nesta lição, você vai usar o padrão Builder para construir um objeto complexo em etapas bem definidas.

  • Avançado
  • 3 min de leitura
  • 1 exemplo executável

Introdução

O problema

Alguns objetos têm muitas partes opcionais: um relatório pode ter título, gráfico, tabela, rodapé ou qualquer mistura disso. Um construtor com dez argumentos opcionais é difícil de ler e fácil de chamar errado. Um builder adiciona as partes uma de cada vez, com clareza.

Pense assim

Um builder é como pedir um sanduíche no balcão. Você diz "pão, depois queijo, depois tomate", e o sanduíche cresce a cada instrução. Quando diz "pronto", recebe o sanduíche terminado.

Do balcão de sanduíches para o código
ReportBuilder()🍞 Comece um pedido vazio
.add_title()🧀 Adicione um ingrediente
.add_chart()🍅 Adicione outro; a ordem importa
.build()🥪 Entregue o sanduíche pronto
Adicione as partes que precisa e depois construa o resultado.
Em uma frase

O padrão Builder constrói um objeto complexo passo a passo, com métodos separados, e devolve o objeto pronto numa chamada final build.

Pontos-chave

  1. self.parts junta as partes adicionadas até agora.
  2. add_title e add_chart adicionam uma parte cada e fazem return self, então as chamadas podem ser encadeadas.
  3. ReportBuilder().add_title().add_chart().build() se lê como uma lista de instruções.
  4. build() transforma as partes reunidas no texto final do relatório.

Quando usar?

  • Objetos com muitas partes opcionais: relatórios, requisições HTTP, consultas SQL, documentos.
  • Deixar legível uma construção passo a passo com encadeamento de métodos.
  • Criar variantes diferentes com os mesmos passos de construção.

Quando não é preciso

  • Objetos com dois ou três campos obrigatórios: um construtor normal ou uma dataclass é mais simples.
  • Código Python em que argumentos nomeados com valores padrão já deixam a chamada clara.

Código de exemplo

Executar 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)
Gerar um botão Run para este exemplo

Resultado da execução

Report: title, chart

Explicação do código

Cada método, como add_title(), adiciona uma parte ao relatório e devolve o próprio objeto builder (return self). Assim, as chamadas podem ser encadeadas na mesma linha. No final, o método build() junta as partes e retorna o relatório completo, Report: title, chart.

Altere os valores e execute o programa no compilador Python online CodeUtility sem instalar Python.

Exercícios práticos

Tente modificar o código seguindo as sugestões abaixo. Mudar o código e observar o resultado ajuda você a entender muito mais do que só ler.

  1. Substitua o domínio do exemplo preservando a estrutura do padrão.
  2. Compare o padrão com uma implementação mais simples e explique as diferenças.
  3. Escreva testes para cada participante antes de adicionar outra implementação.
Executar no compilador Python →

Erros comuns

Esquecer de devolver self

Sem return self, o encadeamento falha porque o método devolve None.

Problema
def add_title(self):
    self.parts.append("title")
Correção
def add_title(self):
    self.parts.append("title")
    return self

Terminou esta lição?

Marque como aprendida para acompanhar seu progresso.

Pratique com um desafio

Use o conteúdo desta lição para resolver um problema real. Cada desafio roda no navegador, com testes instantâneos e uma revisão por IA.

Todos os desafios