﻿---
title: "15. Unit Test Generator: тесты по коду"
description: "LangChain-агент пишет набор pytest-тестов по модулю: happy path, границы и ошибки; результат проверяется запуском."
---

Генерация тестов — лучший первый агентный сценарий в разработке, потому что
результат проверяется автоматически: тесты либо проходят, либо нет.

## Задача

По Python-файлу получить набор тестов pytest: обычные случаи, границы, ошибки.
Граница: агент не знает требований, поэтому тесты проверяют поведение, а не
соответствие замыслу.

## Архитектура

```mermaid
flowchart LR
  C["Код"] --> P["Промпт тест-инженера"]
  P --> L["Модель"]
  L --> T["Файл тестов"]
  T --> R["pytest"]
  R -->|"провал"| L
```

В примере цикл отсутствует: тесты генерируются один раз и сохраняются в файл.
Проверка запуском — задача человека или CI.

## Поток

1. Код читается из файла или аргумента.
2. Промпт требует конкретные практики: фикстуры, `parametrize`, проверку исключений.
3. Результат печатается или пишется в `--output`.

## Что в коде

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

## Чему учит

- **Проверяемость важнее качества текста.** Тест можно запустить — это
  объективный критерий.
- **Требования в промпте.** Перечисление практик (фикстуры, параметризация,
  исключения) заметно повышает качество.
- **Вывод только кода.** Указание «только файл» избавляет от разбора Markdown.

## Где сломается

- **Тесты проверяют реализацию, а не поведение.** Агент «подгоняет» ожидания под
  текущий код, включая его баги.
- **Пропущенные границы.** Деление на ноль, пустой ввод, отрицательные значения —
  часто забываются.
- **Несуществующие импорты.** Модель придумывает имена функций и фикстур.
- **Хрупкие тесты.** Проверка точных строк вместо поведения.
- **Нет запуска.** Сгенерированные тесты не выполняются, поэтому ошибки остаются.

## Как улучшить

- Запускать `pytest` сразу и возвращать ошибку в модель — это
  [reflection](https://wpcraft.ru/aia/patterns/reflection.md) с внешним сигналом.
- Требовать хотя бы один тест на исключение и один на границу для каждой функции.
- Считать покрытие, а не число тестов.
- Проверять, что тесты падают на намеренно сломанной версии кода (мутационная
  проверка).

## Связь с другими разделами

- [Разработка](https://wpcraft.ru/aia/use-cases/software-development.md) — метрики и риски.
- [Reflection](https://wpcraft.ru/aia/patterns/reflection.md) — цикл с проверкой запуском.
- [LangChain](https://wpcraft.ru/aia/frameworks/langchain.md) — фреймворк.

## Материалы и источники

- [pytest](https://docs.pytest.org) — фреймворк тестов, под который генерируются файлы.