fastapi — правило для Cursor: что делает и как установить
Правило задаёт практики для FastAPI-проектов на Python: структура, API, модели, база данных, безопасность и тесты. Подключается к файлам по glob-шаблонам.
.cursor/rules/fastapi.mdcЧто делает fastapi
Правило направляет Cursor при работе с FastAPI-кодом. Оно охватывает структуру проекта, группировку маршрутов по доменам, dependency injection, middleware и конфигурацию. Для API задаёт ориентиры по HTTP-методам, статусам, моделям запросов и ответов, валидации, обработке ошибок и OpenAPI.
В документе также собраны правила для Pydantic, SQLAlchemy, миграций, транзакций, JWT, OAuth2, CORS, rate limiting, асинхронных операций, фоновых задач и тестов. Отдельные разделы посвящены Docker, CI/CD, логированию, мониторингу и документации.
Правило не применяется ко всему проекту автоматически: alwaysApply: false. Cursor сопоставляет его с файлами по шаблонам **/*.py, app/**/*.py, api/**/*.py, поэтому проекты с другими расширениями или путями не попадут под эти подсказки.
Какие задачи решает
- организовать FastAPI-модули по доменам
- описать модели запросов и ответов через Pydantic
- настроить обработку ошибок и валидацию API
- проверить JWT, OAuth2 и CORS
- подготовить тесты, Docker и CI/CD
Примеры запросов агенту
- Проверь структуру этого FastAPI-проекта и предложи разбиение маршрутов по доменам.
- Создай Pydantic-модели для этого API и добавь валидацию входных данных.
- Проверь обработчик и найди проблемы в статусах, ошибках и асинхронных операциях.
Как установить fastapi
Вручную: положить файлы
.cursor/rules/fastapi.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.claude/rules/fastapi.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/fastapi.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/fastapi.mdВручную: положить файлы
.clinerules/fastapi.mdПо шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules
Вопросы о fastapi
Как установить fastapi в Cursor?
Создайте или добавьте файл правила по пути .cursor/rules/fastapi.mdc.
Что делает fastapi?
Правило подсказывает Cursor, как организовывать FastAPI API, модели, работу с базой данных, аутентификацию, безопасность, тесты и развёртывание.
Какие файлы обрабатывает правило?
Оно сопоставляется с **/*.py, app/**/*.py и api/**/*.py. Поскольку alwaysApply: false, правило включается по этим glob-шаблонам, а не для каждого файла проекта.
Исходный текст
fastapi.mdc · CC0-1.0
--- description: "FastAPI best practices and patterns for building modern Python web APIs" globs: **/*.py, app/**/*.py, api/**/*.py alwaysApply: false --- # FastAPI Best Practices ## Project Structure - Use proper directory structure - Implement proper module organization - Use proper dependency injection - Keep routes organized by domain - Implement proper middleware - Use proper configuration management ## API Design - Use proper HTTP methods - Implement proper status codes - Use proper request/response models - Implement proper validation - Use proper error handling - Document APIs with OpenAPI ## Models - Use Pydantic models - Implement proper validation - Use proper type hints - Keep models organized - Use proper inheritance - Implement proper serialization ## Database - Use proper ORM (SQLAlchemy) - Implement proper migrations - Use proper connection pooling - Implement proper transactions - Use proper query optimization - Handle database errors properly ## Authentication - Implement proper JWT authentication - Use proper password hashing - Implement proper role-based access - Use proper session management - Implement proper OAuth2 - Handle authentication errors properly ## Security - Implement proper CORS - Use proper rate limiting - Implement proper input validation - Use proper security headers - Handle security errors properly - Implement proper logging ## Performance - Use proper caching - Implement proper async operations - Use proper background tasks - Implement proper connection pooling - Use proper query optimization - Monitor performance metrics ## Testing - Write proper unit tests - Implement proper integration tests - Use proper test fixtures - Implement proper mocking - Test error scenarios - Use proper test coverage ## Deployment - Use proper Docker configuration - Implement proper CI/CD - Use proper environment variables - Implement proper logging - Use proper monitoring - Handle deployment errors properly ## Documentation - Use proper docstrings - Implement proper API documentation - Use proper type hints - Keep documentation updated - Document error scenarios - Use proper versioning
© PatrickJS · CC0-1.0 · PatrickJS/awesome-cursorrules
