Паттерны проектирования Python

Паттерн проектирования Builder в Python

В этом уроке вы с помощью паттерна Builder построите сложный объект за несколько понятных шагов.

  • Продвинутый
  • Чтение: 3 мин
  • Примеров для запуска: 1

Введение

Какую задачу это решает

У некоторых объектов много необязательных частей: в отчёте может быть заголовок, график, таблица, подвал или любое их сочетание. Конструктор с десятью необязательными аргументами трудно читать и легко вызвать неправильно. Builder (строитель) добавляет части по одной, понятными шагами.

Пример из жизни

Builder похож на заказ сэндвича у стойки. Вы говорите «хлеб, потом сыр, потом помидор», и сэндвич растёт с каждой инструкцией. Когда вы говорите «готово», вам отдают законченный сэндвич.

От стойки с сэндвичами к коду
ReportBuilder()🍞 Начать пустой заказ
.add_title()🧀 Добавить один ингредиент
.add_chart()🍅 Добавить ещё, порядок важен
.build()🥪 Отдать готовый сэндвич
Добавьте нужные части, потом соберите результат.
Одним предложением

Шаблон Builder собирает сложный объект шаг за шагом с помощью отдельных методов, а готовый объект возвращает последний вызов build.

Главное

  1. self.parts собирает уже добавленные части.
  2. add_title и add_chart добавляют по одной части и делают return self, поэтому вызовы можно связывать в цепочку.
  3. ReportBuilder().add_title().add_chart().build() читается как список инструкций.
  4. build() превращает собранные части в готовый текст отчёта.

Когда это нужно?

  • Объекты с множеством необязательных частей: отчёты, HTTP-запросы, SQL-запросы, документы.
  • Понятное пошаговое создание объекта через цепочку методов.
  • Создание разных вариантов одними и теми же шагами сборки.

Когда это не нужно

  • Объекты с двумя-тремя обязательными полями: обычный конструктор или dataclass проще.
  • Код на Python, где именованные аргументы со значениями по умолчанию уже делают вызов понятным.

Пример кода

Запустить код →
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)
Получить кнопку запуска для этого примера

Результат выполнения

Report: title, chart

Разбор кода

Каждый метод, например add_title(), добавляет часть отчёта и возвращает сам объект builder (return self). Благодаря этому вызовы можно связывать в цепочку в одной строке. В конце метод build() собирает части и возвращает готовый отчёт Report: title, chart.

Измените значения и запустите программу в онлайн-компиляторе Python CodeUtility без локальной установки Python.

Упражнения для практики

Попробуйте изменить код по подсказкам ниже. Если менять код и смотреть на результат, урок запомнится гораздо лучше, чем при простом чтении.

  1. Замените предметную область примера, сохранив структуру паттерна.
  2. Сравните паттерн с более простой реализацией и объясните компромиссы.
  3. Напишите тесты для каждого участника перед добавлением новой реализации.
Запустить в компиляторе Python →

Частые ошибки

Забытый return self

Без return self цепочка ломается, потому что метод возвращает None.

Ошибка
def add_title(self):
    self.parts.append("title")
Исправление
def add_title(self):
    self.parts.append("title")
    return self

Закончили этот урок?

Отметьте его как изученный, чтобы следить за прогрессом.

Попрактикуйтесь на задаче

Примените материал этого урока к реальной задаче. Каждая задача запускается в браузере, с мгновенными тестами и разбором от ИИ.

Все задачи