Le patron de conception Builder en Python
Dans cette leçon, vous allez utiliser le patron Builder pour construire un objet complexe en plusieurs étapes claires.
Introduction
Le problème
Certains objets ont beaucoup de parties facultatives : un rapport peut avoir un titre, un graphique, un tableau, un pied de page, ou n'importe quel mélange. Un constructeur à dix arguments facultatifs est difficile à lire et facile à mal appeler. Un builder ajoute les parties une étape claire à la fois.
Imaginez-le ainsi
Un builder, c'est comme commander un sandwich au comptoir. Vous dites « pain, puis fromage, puis tomate », et le sandwich grandit à chaque instruction. Quand vous dites « c'est tout », vous recevez le sandwich terminé.
ReportBuilder()🍞 Commencer une commande vide.add_title()🧀 Ajouter un ingrédient.add_chart()🍅 En ajouter un autre ; l'ordre compte.build()🥪 Remettre le sandwich terminéLe pattern Builder construit un objet complexe étape par étape via des méthodes séparées, puis renvoie l'objet terminé lors d'un appel final à build.
Points clés
self.partsrassemble les parties ajoutées jusque-là.add_titleetadd_chartajoutent chacune une partie et fontreturn self, donc les appels peuvent s'enchaîner.ReportBuilder().add_title().add_chart().build()se lit comme une liste d'instructions.build()transforme les parties rassemblées en texte de rapport terminé.
Quand l’utiliser ?
- Les objets avec beaucoup de parties facultatives : rapports, requêtes HTTP, requêtes SQL, documents.
- Rendre une construction pas à pas lisible grâce au chaînage de méthodes.
- Créer différentes variantes avec les mêmes étapes de construction.
Quand s'en passer
- Les objets avec deux ou trois champs obligatoires : un constructeur normal ou une dataclass est plus simple.
- Le code Python où des arguments nommés avec valeurs par défaut rendent déjà l'appel clair.
Code d’exemple
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)
Résultat de l’exécution
Report: title, chart
Explication du code
Chaque méthode, comme add_title(), ajoute une partie au rapport puis renvoie l'objet builder lui-même (return self). Les appels peuvent ainsi s'enchaîner sur une même ligne. Enfin, la méthode build() assemble les parties et renvoie le rapport complet, Report: title, chart.
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.
- Remplacez le domaine de l’exemple tout en conservant la structure du pattern.
- Comparez le pattern à une implémentation plus simple et expliquez les compromis.
- Écrivez des tests pour chaque participant avant d’ajouter une autre implémentation.
Erreurs fréquentes
Oublier de renvoyer self
Sans return self, le chaînage échoue car la méthode renvoie None.
def add_title(self):
self.parts.append("title")
def add_title(self):
self.parts.append("title")
return self
Leçon terminée ?
Marquez-la comme apprise pour suivre votre progression.
S'entraîner avec un défi
Utilisez le contenu de cette leçon pour résoudre un vrai problème. Chaque défi s'exécute dans le navigateur, avec des tests instantanés et une revue par l'IA.
Tous les défis