Patrons de conception Python

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.

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

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é.

Du comptoir à sandwichs au code
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é
Ajoutez les parties nécessaires, puis construisez le résultat.
En une phrase

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

  1. self.parts rassemble les parties ajoutées jusque-là.
  2. add_title et add_chart ajoutent chacune une partie et font return self, donc les appels peuvent s'enchaîner.
  3. ReportBuilder().add_title().add_chart().build() se lit comme une liste d'instructions.
  4. 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

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

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.

  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

Oublier de renvoyer self

Sans return self, le chaînage échoue car la méthode renvoie None.

Problème
def add_title(self):
    self.parts.append("title")
Correction
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