Python 312 FastAPI Best Practices Cursorrules Prom

Cursor-Regel für FastAPI mit Python-3.12-spezifischen Idiomen und Best Practices.

Original-Beschreibung der Autoren: Cursor rules for Python FastAPI development with best practices.

Die Regel

---
description: "Cursor rules for Python FastAPI development with best practices."
globs: **/*
alwaysApply: false
---
Here are some best practices and rules you must follow:

- You use Python 3.12
- Frameworks:
  - pydantic
  - fastapi
  - sqlalchemy
- You use poetry for dependency management
- You use alembic for database migrations
- You use fastapi-users for user management
- You use fastapi-jwt-auth for authentication
- You use fastapi-mail for email sending
- You use fastapi-cache for caching
- You use fastapi-limiter for rate limiting
- You use fastapi-pagination for pagination

1. **Use Meaningful Names**: Choose descriptive variable, function, and class names.
2. **Follow PEP 8**: Adhere to the Python Enhancement Proposal 8 style guide for formatting.
3. **Use Docstrings**: Document functions and classes with docstrings to explain their purpose.
4. **Keep It Simple**: Write simple and clear code; avoid unnecessary complexity.
5. **Use List Comprehensions**: Prefer list comprehensions for creating lists over traditional loops when appropriate.
6. **Handle Exceptions**: Use try-except blocks to handle exceptions gracefully.
7. **Use Virtual Environments**: Isolate project dependencies using virtual environments (e.g., `venv`).
8. **Write Tests**: Implement unit tests to ensure code reliability.
9. **Use Type Hints**: Utilize type hints for better code clarity and type checking.
10. **Avoid Global Variables**: Limit the use of global variables to reduce side effects.

These rules will help you write clean, efficient, and maintainable Python code.

So nutzt du sie

Die Regel kopieren (Button oben) oder als Datei herunterladen und im Projekt unter .cursor/rules/ ablegen — Cursor lädt sie beim nächsten Start automatisch. Ältere Cursor-Versionen lesen alternativ eine einzelne .cursorrules-Datei im Projektstamm; dort einfach den Regel-Text ohne den Kopfblock zwischen den ----Zeilen einfügen.

Der Regel-Text ist englisch — Cursor versteht ihn unabhängig von der Sprache, in der Sie mit dem Editor chatten.

Im Detail

Eine umfassendere Variante der FastAPI-Regel, zugeschnitten auf Python 3.12 und dessen neuere Sprachfeatures (z. B. verbesserte Typannotationen, Performance-Verbesserungen im Interpreter). Sie kombiniert FastAPI-Konventionen mit modernen Python-3.12-Idiomen, sodass generierter Code sowohl Framework- als auch Sprachversion-gerecht ausfällt. Sinnvoll für Projekte, die bewusst auf Python 3.12 setzen und nicht nur generische, versionsunabhängige FastAPI-Muster wollen. Bei älteren Python-Versionen im Projekt kann die Regel zu inkompatiblen Vorschlägen führen.

Praxis-Tipp

Vor Einsatz die eigene Python-Version prüfen – bei Projekten unter 3.12 lieber die einfachere py-fast-api-Regel nutzen, um Versionskonflikte zu vermeiden.

Lizenz & Quelle

• Lizenz: CC0 1.0
• Quelle: PatrickJS/awesome-cursorrules (GitHub)

Lade …