# asyncio

Правило для Cursor задаёт, как писать асинхронный код на Python: единая точка входа, задачи без утечек, никаких блокировок цикла событий.

- правило · `type=rule` · Cursor · ★ 3579
- Автор: sanjeed5
- Лицензия: CC0-1.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/sanjeed5/awesome-cursor-rules-mdc/tree/HEAD/rules-mdc/asyncio.mdc
- Обновлён: 2026-05-19
- HTML: https://affpapa.org/nevibecode/rules/asyncio

## Что делает

Правило подключается к Cursor и применяется ко всем файлам `**/*.py`. Внутри — набор требований к коду на `asyncio` с примерами «плохо» и «хорошо»: запускать приложение через `asyncio.run()`, а не вручную крутить цикл событий, хранить ссылку на объект задачи из `asyncio.create_task()`, иначе сборщик мусора может её забрать и исключение потеряется. Для параллельной работы нескольких корутин правило советует `asyncio.gather()`, а `asyncio.wait()` — когда нужен контроль над условием завершения.

Отдельный раздел — про блокировки. Тяжёлые вычисления и синхронный ввод-вывод нельзя выполнять прямо в корутине: цикл событий встанет, и всё остальное подождёт. Такие куски правило велит уводить в `loop.run_in_executor()` с `ThreadPoolExecutor` или `ProcessPoolExecutor`. В разработке рекомендуется включать `debug=True` у `asyncio.run()` — тогда Python предупредит о корутинах, которые никто не дождался.

Правило рассчитано на Python со стандартной библиотекой `asyncio`, без сторонних фреймворков. Если в проекте уже есть свой стиль работы с задачами, часть требований придётся переписать под него — это повод сверить правило с текущим кодом до включения.

## Установка

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

**Вручную: положить файлы**
- Файл: `.cursor/rules/asyncio.mdc` — Во frontmatter: description, globs, alwaysApply

### Claude Code

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

### Codex

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

### GitHub Copilot

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

### Windsurf (Devin Desktop)

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

### Cline

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/sanjeed5/awesome-cursor-rules-mdc/tree/HEAD/rules-mdc/asyncio.mdc

## Когда брать
- поймать корутину, которую забыли дождаться
- разложить тяжёлые вычисления по исполнителям, чтобы не морозить цикл событий
- запустить несколько запросов параллельно вместо последовательных ожиданий
- сохранить ссылку на задачу и не потерять её исключение
- выбрать между gather и wait для группы задач

## Примеры запросов агенту
- Проверь этот файл на правила asyncio: где цикл событий блокируется?
- Перепиши запуск так, чтобы использовался asyncio.run() с debug=True
- Разнеси эти три запроса через asyncio.gather()

## Похожие
- [asyncio-concurrency-patterns](https://affpapa.org/nevibecode/skills/asyncio-concurrency-patterns.md) — скилл · 489 установок
- [async-python-patterns](https://affpapa.org/nevibecode/skills/async-python-patterns.md) — скилл · 18055 установок
- [rust-async-patterns](https://affpapa.org/nevibecode/skills/rust-async-patterns.md) — скилл · 20625 установок
- [m07-concurrency](https://affpapa.org/nevibecode/skills/m07-concurrency.md) — скилл · 3500 установок
- [csharp-concurrency-patterns](https://affpapa.org/nevibecode/skills/csharp-concurrency-patterns.md) — скилл · 1600 установок
- [rust-systems-programming](https://affpapa.org/nevibecode/skills/rust-systems-programming.md) — скилл · 485 установок

Из того же набора: [sanjeed5/awesome-cursor-rules-mdc](https://affpapa.org/nevibecode/by/sanjeed5/awesome-cursor-rules-mdc.md) — 69 карточек

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

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