pytest и Testcontainers для Python-сервисов | ТЕРАКОР
Назад Python
Python Средний (Middle) обновлено 18.11.2026 ~7 мин чтения

Тестирование Python-сервисов: pytest, Testcontainers и контрактные проверки

Стратегия тестов Python-backend: пирамида проверок, Testcontainers для PostgreSQL, контрактные тесты API и Definition of Done, которое ловит регрессии до релиза.

Редакция ТЕРАКОР
Автор Редакция ТЕРАКОР Основатель ТЕРАКОР, практикующий разработчик и Tech Lead
Тестирование Python-сервисов: pytest, Testcontainers и контрактные проверки

В 2026 году работодатели ожидают от Python-разработчика не только умение писать endpoint, но и культуру проверки: автотесты, изоляция зависимостей и понятный сигнал «можно выкатывать». Разрозненные unit-тесты на моках больше не закрывают риск интеграции с реальной базой, очередью и схемой API.

ТЕРАКОР встраивает тестирование в учебный проект с первого прикладного модуля. Причина простая: навык «сначала воспроизвести, потом чинить» дешевле учить рано, чем переучивать Middle-специалиста, привыкшего к ручным проверкам на стенде после деплоя.

Пирамида, которая работает в backend

Классическая пирамида жива, если её применяют к рискам, а не к проценту покрытия строчек. Для Python-сервиса разумная структура выглядит так:

  • Unit — чистая доменная логика без I/O: расчёты, политики, конечные автоматы, парсеры.
  • Integration — реальная PostgreSQL/Redis в контейнере, миграции, репозитории, транзакции.
  • Contract — совместимость API-схемы и ключевых сценариев клиента, включая негативные коды.
  • Smoke — короткий набор после деплоя на стенде: здоровье, логин, один критичный бизнес-путь.

Ошибка команд — перекос в моки на всём. Мок хорош для изоляции алгоритма; он плох как единственная защита для SQL и схемы. Другая ошибка — тысячи хрупких e2e, которые падают от порядка запуска. Баланс важнее фанатизма.

Зачем Testcontainers

Мок базы скрывает индексы, ограничения, транзакции и отличия SQL-диалекта. Testcontainers поднимает настоящий PostgreSQL на время теста и даёт воспроизводимость CI. Да, тесты длиннее unit-набора — зато ловят класс дефектов, который иначе уходит в production: неверный тип колонки, забытый unique, гонку при уровне изоляции, несовместимость миграции с кодом.

Практический порядок, который стабильно работает:

  1. Поднять контейнер один раз на сессию pytest, а не на каждый тест.
  2. Прогнать миграции до набора кейсов.
  3. Чистить данные транзакцией или truncate между кейсами.
  4. Фиксировать версию образа БД, чтобы «зелёное у разработчика» совпадало с CI.
  5. Отделять медленные интеграционные маркеры, чтобы локально можно было гонять быстрый контур.

Не пересоздавайте кластер на каждый тест без необходимости: вы заплатите минутами CI и получите тот же класс проверок дешевле через изоляцию данных.

Что именно проверять на интеграции

Фокус на рисках изменения схемы и границ транзакций: создание сущности с ограничениями, повтор уникального ключа, откат при ошибке, чтение после commit, поведение cascade. Если тест только «вставил и прочитал happy-path», ценность контейнера почти не использована.

Контрактные проверки API

Храните OpenAPI или набор golden-ответов под версионным контролем. В CI сравнивайте текущую схему с baseline. Отдельно гоняйте негативные сценарии: 422 на неверной модели, 409 на конфликте, идемпотентность повтора POST с тем же ключом, стабильность кодов ошибок при эволюции полей.

Контрактный тест — это не «сгенерировали клиент и забыли». Это сигнал, что потребитель не сломается молча. Для внутренних API полезно версионировать ожидания потребителей и падать сборку при несовместимости, а не узнавать о проблеме на чужом стенде через неделю.

Стабильность CI и борьба с флейками

Флейк — это долг с процентами. Команда, которая «перезапускает до зелёного», учит себя игнорировать сигнал. Изолируйте нестабильный тест, разберитесь: гонка по времени, общий стейт, зависимость от порядка, внешний сервис без заглушки. Пока флейк живёт в основной ветке, доверие к CI падает, и люди начинают мержить «несмотря на красное».

Имена тестов должны читаться как спецификация риска: test_create_order_rejects_duplicate_idempotency_key понятнее, чем test_order_2. Падающий лог обязан показывать входные данные и ожидаемый инвариант.

Что включать в Definition of Done

  1. Новый код покрыт тестом на риск, а не на строчки ради процента.
  2. Есть хотя бы один интеграционный сценарий для изменения схемы данных.
  3. Падающий тест имеет читаемое имя и стабилен на CI.
  4. Флейки изолируются и чинятся, а не «перезапускаются до зелёного».
  5. Для API-изменения есть проверка контракта или явная пометка breaking change.

Данные тестов и фабрики

Хрупкие тесты часто рождаются из копипасты JSON и ручных INSERT. Используйте фабрики объектов и явные билдеры состояния: так проще выразить предусловие «заказ в статусе paid» без зависимости от случайного порядка фикстур. Для интеграционного контура держите минимальный набор справочников, необходимых сценарию, а не полный дамп production.

Секреты и персональные данные в фикстурах запрещены. Даже в учебных репозиториях ТЕРАКОР это правило соблюдается: привычка тащить «боевой кусок» в тест потом дорого обходится compliance.

Скорость обратной связи

Разделите пайплайн: быстрый unit-контур на каждый push, интеграционный — на PR и по расписанию ночью при необходимости. Разработчик должен получать сигнал за минуты, а не ждать полный suite, чтобы узнать о опечатке в доменной функции. Маркеры pytest и правильная параллелизация (с изоляцией данных) здесь важнее покупки более мощного CI-раннера.

Измеряйте время suite как метрику здоровья инженерии. Когда прогон расползается, люди перестают запускать тесты локально — и качество падает раньше, чем краснеет main.

Связь тестов с релизным риском

Не все проверки одинаково ценны перед выкладкой. Для релиза важны сценарии денег, прав доступа, идемпотентности и миграций. Помечайте их явно и не позволяйте «зелёному» unit-набору маскировать отсутствие этих проверок. В отчёте CI должно быть видно: критичный контур пройден, а не просто «98% passed».

Такая дисциплина ускоряет онбординг Junior-специалистов и снижает стоимость сопровождения сервиса. В программах ТЕРАКОР студент сдает учебный сервис вместе с pytest-контуром и контейнером БД: без этого модуль не считается закрытым. Работодателю нужен не «человек, который писал тесты когда-то», а инженер, для которого проверка — часть поставки.

Обсуждение во ВКонтакте

Войдите через VK, чтобы оставить комментарий. Сообщения видны друзьям и подписчикам.

Практика

Задачники по теме

Закрепите материал на задачах с критериями проверки.

3 задачника

Все задачники