Patrons de conception Python

Le patron de conception Template Method en Python

Dans cette leçon, vous allez utiliser le patron Template Method pour fixer les étapes d'un processus tout en laissant les sous-classes personnaliser certaines d'entre elles.

  • Avancé
  • 3 min de lecture
  • 1 exemple exécutable

Introduction

Le problème

Beaucoup de processus suivent les mêmes étapes dans le même ordre et ne diffèrent que sur une seule. Tout pipeline de données lit, traite et enregistre, mais on ne traite pas du CSV comme du JSON. Recopier tout le processus pour chaque variante duplique l'ordre des étapes et multiplie les risques d'erreur.

Imaginez-le ainsi

Le pattern Template Method, c'est comme une fiche recette avec une ligne vide. La fiche fixe l'ordre : préparer, cuire la garniture, servir. Chaque cuisinier ne remplit que la ligne vide avec sa propre garniture, et personne ne peut changer l'ordre des étapes.

De la fiche recette au code
run()📇 La fiche recette aux étapes fixes
"read", ..., "save"🔒 Les étapes qui ne changent jamais
self.process()✏️ La ligne vide que remplit chaque cuisinier
CsvPipeline🧑‍🍳 La version d'un cuisinier pour cette étape
La classe de base fixe l'ordre, les sous-classes remplissent une étape.
En une phrase

Le pattern Template Method définit les étapes d'un algorithme dans une méthode de la classe de base et laisse les sous-classes redéfinir certaines étapes sans changer l'ordre général.

Points clés

  1. DataPipeline.run() fixe l'ordre : lire, traiter, enregistrer.
  2. process est marquée @abstractmethod, donc chaque sous-classe doit la fournir.
  3. CsvPipeline ne redéfinit que process.
  4. CsvPipeline().run() garde l'ordre fixe et utilise l'étape CSV.

Quand l’utiliser ?

  • Les processus à ordre fixe dont quelques étapes varient : pipelines, exports, tours de jeu.
  • Les frameworks qui appellent votre code à des points définis.
  • Éviter de dupliquer le même enchaînement d'étapes dans des classes semblables.

Quand s'en passer

  • Une seule étape varie et elle est simple : passez une fonction (Strategy) au lieu de créer une sous-classe.
  • Les étapes elles-mêmes changent d'ordre d'une variante à l'autre.

Code d’exemple

Exécuter le code →
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()))
Obtenir un bouton Run pour cet exemple

Résultat de l’exécution

read -> process CSV -> save

Explication du code

La méthode run() de DataPipeline fixe l'ordre read, process, save. L'étape process() est marquée @abstractmethod, chaque sous-classe doit donc l'implémenter. CsvPipeline fournit son propre traitement, process CSV, et le résultat est read -> process CSV -> save.

Modifiez les valeurs et exécutez le programme avec le compilateur Python en ligne CodeUtility, sans installation locale.

Exercices d’approfondissement

Essayez de modifier le code en suivant les pistes ci-dessous. Changer le code et observer le résultat vous fera bien mieux comprendre la leçon que la simple lecture.

  1. Remplacez le domaine de l’exemple tout en conservant la structure du pattern.
  2. Comparez le pattern à une implémentation plus simple et expliquez les compromis.
  3. Écrivez des tests pour chaque participant avant d’ajouter une autre implémentation.
Exécuter dans le compilateur Python →

Erreurs fréquentes

Redéfinir run dans la sous-classe

Réécrire run duplique l'ordre et peut le casser.

Problème
class CsvPipeline(DataPipeline):
    def run(self):
        return ["process CSV", "save"]  # read was forgotten
Correction
class CsvPipeline(DataPipeline):
    def process(self):
        return "process CSV"

Leçon terminée ?

Marquez-la comme apprise pour suivre votre progression.