# python-tests

Правило python-tests задаёт конвенции написания тестов на pytest: структуру AAA, именование test_given_when_then и выбор между mocker, monkeypatch и MagicMock.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1627 у репозитория
- Автор: microsoft
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/microsoft/hve-core/tree/HEAD/.github/instructions/coding-standards/python-tests.instructions.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/python-tests

## Что делает

Правило применяется к файлам `**/*.py` и описывает, как писать тесты на pytest с BDD-стилем именования: `test_given_context_when_action_then_expected`. Каждый тест делится на блоки Arrange/Act/Assert, разделённые пустой строкой и комментарием, с одной проверкой на тест.

Отдельная таблица разводит три способа мокирования: `mocker` из pytest-mock — основной выбор для новых проектов и миграций, `monkeypatch` — для простых подмен атрибутов и переменных окружения, прямой импорт `unittest.mock.MagicMock()` — только для тестовых стабов-данных, а не для spy-объектов с проверкой вызовов. В существующих проектах `unittest.mock` оставляют как есть и переводят на `mocker` только при редактировании файла.

Правило требует зеркалить имя файла модулю (`parser.py` → `test_parser.py`), выносить общие фикстуры в `conftest.py` и использовать `@pytest.mark.parametrize` для тестов с несколькими комбинациями входа и выхода. Логгер-моки проверять не нужно. Все конвенции из python-script.instructions.md применяются дополнительно.

## Установка

### GitHub Copilot (родная платформа)

**Вручную: положить файлы**
- Файл: `.github/instructions/python-tests.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/python-tests.md` — Поле paths во frontmatter ограничивает файлы: applyTo из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/python-tests.mdc` — Во frontmatter: description, globs, alwaysApply. applyTo из источника → globs, иначе правило само не подключится

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/python-tests.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/python-tests.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/microsoft/hve-core/tree/HEAD/.github/instructions/coding-standards/python-tests.instructions.md

## Когда брать
- определить структуру AAA в тестах pytest
- выбрать между mocker, monkeypatch и MagicMock
- назвать тестовые методы в стиле given-when-then
- мигрировать @patch на mocker.patch без потери логики
- разнести фикстуры по conftest.py

## Примеры запросов агенту
- Напиши тесты для `parser.py` по правилам python-tests
- Перепиши тест с `@patch` на `mocker.patch` по конвенции python-tests
- Добавь параметризованный тест для DataProcessor по правилу python-tests

## Похожие
- [python-testing-patterns](https://affpapa.org/nevibecode/skills/python-testing-patterns.md) — скилл · 36943 установки
- [python-testing](https://affpapa.org/nevibecode/skills/laurigates-python-testing.md) — скилл · 468 установок
- [run-python-tests](https://affpapa.org/nevibecode/skills/run-python-tests.md) — скилл · ★ 6244 у репозитория
- [Python Unit Test Generator — Comprehensive, Coverage-Mapped & Production-Ready](https://affpapa.org/nevibecode/prompts/python-unit-test-generator-comprehensive-coverage-mapped-production-ready.md) — промпт · ★ 178201 у репозитория
- [Pytest Testing](https://affpapa.org/nevibecode/skills/pytest-testing.md) — скилл · 555 установок
- [pytest-skill](https://affpapa.org/nevibecode/skills/pytest-skill.md) — скилл · 442 установки

Из того же набора: [microsoft/hve-core](https://affpapa.org/nevibecode/by/microsoft/hve-core.md) — 148 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
