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

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

В этом уроке вы реализуете паттерн Singleton, который гарантирует, что у класса есть только один общий объект.

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

Введение

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

Некоторые вещи должны существовать в программе в единственном экземпляре: настройки приложения, пул соединений, логгер, который пишет в один файл. Если каждая часть кода создаёт свою копию, настройки расходятся, а ресурсы тратятся впустую.

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

Шаблон Singleton (одиночка) похож на единственный школьный звонок в здании. Во всех кабинетах звенит один и тот же звонок, и никто не ставит себе отдельный. Где бы вы ни спросили про звонок, речь всегда пойдёт именно о нём.

От школьного звонка к коду
_instance = None🔔 Звонок ещё не установлен
if cls._instance is None:🔧 Установить его, когда кто-то попросит впервые
return cls._instance🔁 Все следующие получают тот же звонок
first is second✅ Два запроса, один объект: True
Каждый вызов возвращает один и тот же объект.
Одним предложением

Шаблон Singleton заставляет класс при каждом создании возвращать один и тот же экземпляр. Так у программы появляется один общий объект.

Главное

  1. _instance - атрибут класса, который хранит единственный общий объект.
  2. __new__ - метод, который Python вызывает при создании объекта. Он создаёт объект, только если _instance всё ещё равен None.
  3. cls._instance.theme = "dark" настраивает общий объект один раз.
  4. first is second равно True: оба имени указывают на один и тот же объект.

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

  • Конфигурация на всё приложение, которую читает каждый модуль.
  • Один общий ресурс, например кэш, логгер или пул соединений.
  • Чтобы разобраться, как __new__ управляет созданием объектов.

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

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

Пример кода

Запустить код →
main.py
class AppConfig:
    # Singleton: every caller receives one shared configuration object.
    _instance = None

    def __new__(cls):
        # Create the shared instance only on the first call.
        if cls._instance is None:
            cls._instance = super().__new__(cls)
            cls._instance.theme = "dark"
        return cls._instance


first = AppConfig()
second = AppConfig()
print(first is second)
Получить кнопку запуска для этого примера

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

True

Разбор кода

Метод __new__ вызывается перед __init__ при каждом создании объекта. При первом вызове _instance ещё равно None, поэтому объект создаётся и запоминается. При следующих вызовах __new__ просто возвращает запомненный объект, поэтому сравнение двух объектов через is даёт True.

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

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

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

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

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

Настройка состояния в __init__

__init__ выполняется при каждом вызове класса, поэтому каждый раз сбрасывает общий объект.

Ошибка
def __init__(self):
    self.theme = "dark"  # runs again for every AppConfig()
Исправление
if cls._instance is None:
    cls._instance = super().__new__(cls)
    cls._instance.theme = "dark"

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

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

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

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

Все задачи