# pyright

Правило задаёт рекомендации по настройке Pyright и basedpyright для Python-проектов. Пригодится, если хотите сделать проверку типов строже и последовательнее.

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

## Что делает

Правило охватывает настройки проекта, строгую диагностику и аннотации типов. Оно советует хранить конфигурацию в `pyrightconfig.json` или `pyproject.toml`, начинать с базовых проверок и ужесточать их постепенно. Для аргументов функций предлагаются абстрактные типы, а для возвращаемых значений — конкретные.

Отдельные рекомендации касаются `Any`, комментариев подавления ошибок, псевдонимов типов и синтаксиса подсказок типов. Для библиотек без встроенных типов предусмотрена папка `stubs/`; правило также советует использовать виртуальные окружения и настроить Pyright на их поиск. Строгие проверки требуют исправить существующие ошибки или явно задать исключения.

## Установка

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

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

### Claude Code

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

### Codex

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

### GitHub Copilot

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

### Windsurf (Devin Desktop)

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

### Cline

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

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

## Когда брать
- настроить проверки типов на уровне проекта
- сократить использование `Any` в аннотациях
- указывать код ошибки при подавлении диагностики
- объявлять псевдонимы типов через `TypeAlias`
- поддерживать заглушки типов для библиотек

## Примеры запросов агенту
- Настрой проверки типов в моём Python-проекте по правилу pyright.
- Проверь аннотации в `src` и предложи, где заменить `Any` на `object`.
- Подскажи, как настроить `pyrightconfig.json` для строгой проверки типов.

## Похожие
- [pyright-lsp](https://affpapa.org/nevibecode/plugins/pyright-lsp.md) — плагин · ★ 44967
- [winui3](https://affpapa.org/nevibecode/rules/winui3.md) — правило · ★ 40478
- [vue](https://affpapa.org/nevibecode/rules/vue.md) — правило · ★ 40478
- [vsixtoolkit](https://affpapa.org/nevibecode/rules/vsixtoolkit.md) — правило · ★ 40478
- [use-cliche-data-in-docs](https://affpapa.org/nevibecode/rules/use-cliche-data-in-docs.md) — правило · ★ 40478
- [update-docs-on-code-change](https://affpapa.org/nevibecode/rules/update-docs-on-code-change.md) — правило · ★ 40478
- [update-code-from-shorthand](https://affpapa.org/nevibecode/rules/update-code-from-shorthand.md) — правило · ★ 40478

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

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

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