Padrões de projeto em Python

Padrão de projeto Template Method em Python

Nesta lição, você vai usar o padrão Template Method para fixar as etapas de um processo e ainda permitir que subclasses personalizem algumas delas.

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

Introdução

O problema

Muitos processos seguem a mesma ordem de passos mas diferem em um deles: todo pipeline de dados lê, processa e salva, mas processar CSV é diferente de processar JSON. Copiar o processo inteiro para cada variante duplica a ordem e convida a erros.

Pense assim

O padrão Template Method é como uma ficha de receita com uma linha em branco. A ficha fixa a ordem: preparar, cozinhar o recheio, servir. Cada cozinheiro só preenche a linha em branco com o seu recheio; ninguém muda a ordem dos passos.

Da ficha de receita para o código
run()📇 A ficha com passos fixos
"read", ..., "save"🔒 Passos que nunca mudam
self.process()✏️ A linha em branco que cada cozinheiro preenche
CsvPipeline🧑‍🍳 A versão de um cozinheiro para esse passo
A classe base fixa a ordem; as subclasses preenchem um passo.
Em uma frase

O padrão Template Method define os passos de um algoritmo num método da classe base e deixa as subclasses sobrescreverem passos específicos sem mudar a ordem geral.

Pontos-chave

  1. DataPipeline.run() fixa a ordem: ler, processar, salvar.
  2. process é marcado com @abstractmethod, então toda subclasse precisa fornecê-lo.
  3. CsvPipeline sobrescreve só process.
  4. CsvPipeline().run() mantém a ordem fixa e usa o passo de CSV.

Quando usar?

  • Fluxos com ordem fixa e alguns passos que variam: pipelines, exportações, turnos de jogo.
  • Frameworks que chamam o seu código em pontos definidos.
  • Tirar fluxo de controle duplicado de classes parecidas.

Quando não é preciso

  • Só um passo varia e ele é simples: passe uma função (Strategy) em vez de criar subclasses.
  • Os próprios passos mudam de ordem entre as variantes.

Código de exemplo

Executar código →
main.py
from abc import ABC, abstractmethod


class DataPipeline(ABC):
    # Template Method: fix the workflow and customize selected steps.
    def run(self):
        # Keep the algorithm order stable.
        return ["read", self.process(), "save"]

    @abstractmethod
    def process(self): pass


class CsvPipeline(DataPipeline):
    def process(self): return "process CSV"


print(" -> ".join(CsvPipeline().run()))
Gerar um botão Run para este exemplo

Resultado da execução

read -> process CSV -> save

Explicação do código

O método run() de DataPipeline fixa a ordem read, process, save. A etapa process() é marcada com @abstractmethod, então toda subclasse é obrigada a implementá-la. CsvPipeline fornece seu próprio processamento, process CSV, e o resultado é read -> process CSV -> save.

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

Sobrescrever run na subclasse

Reescrever run duplica a ordem e pode quebrá-la.

Problema
class CsvPipeline(DataPipeline):
    def run(self):
        return ["process CSV", "save"]  # read was forgotten
Correção
class CsvPipeline(DataPipeline):
    def process(self):
        return "process CSV"

Terminou esta lição?

Marque como aprendida para acompanhar seu progresso.