Endpoints CRUD FastAPI avec Pydantic v2, Alembic et tests pytest

Prompt

Agis comme un développeur backend senior spécialisé en Python, FastAPI et SQLAlchemy.

Je veux ajouter à une API FastAPI existante un module complet pour gérer {{ressource}}.
- Champs et types : {{champs}}
- Règles métier : {{regles}}
- Base de données : {{base_donnees}}
- Accès aux données : {{acces}}

Livrables, dans cet ordre :
1. L’arborescence des fichiers (routeur, schémas, modèle, service ou repository, tests) avec une phrase qui justifie ce découpage.
2. Des schémas Pydantic v2 distincts pour la création, la mise à jour partielle et la réponse, avec des validations (`Field`, `field_validator`, `model_validator`) qui appliquent les règles métier.
3. Le modèle de base de données et sa migration Alembic, avec index et contraintes d’unicité là où c’est pertinent.
4. Un routeur avec liste paginée et filtrable, détail, création, mise à jour partielle (PATCH) et suppression. Utilise les bons codes (201, 204, 404, 409, 422) et un `response_model` sur chaque endpoint.
5. Une session de base injectée avec `Depends`, sans état global, et des transactions bien délimitées.
6. Des tests pytest avec `httpx.AsyncClient` (ou `TestClient` si l’accès est synchrone) : cas nominal, validation, ressource inexistante et conflit avec une règle métier, sur une base de test isolée.
7. Les commandes pour lancer l’application, appliquer la migration et exécuter les tests.

Contraintes :
- Python 3.11 ou plus, entièrement typé, sans dépendance inutile.
- N’invente ni champs ni règles : si quelque chose est ambigu, pose-moi la question avant d’écrire du code ou indique [À COMPLÉTER].
- Signale les décisions qui dépendent du reste de mon projet (authentification, configuration, nommage des tables).

Format : un bloc de code par fichier avec son chemin en titre, puis la liste des hypothèses à la fin.

Comment l'utiliser

Exemple d'utilisation

Exemple de résultat

from datetime import datetime, timedelta, timezone
from enum import Enum
from pydantic import BaseModel, Field, field_validator

class StatutReservation(str, Enum):
    en_attente = "en_attente"
    confirmee = "confirmee"
    annulee = "annulee"

class ReservationCreate(BaseModel):
    nom_client: str = Field(min_length=1, max_length=120)
    telephone: str = Field(pattern=r"^\+?[0-9 ]{7,20}$")
    date_heure: datetime
    couverts: int = Field(ge=1, le=12)

    @field_validator("date_heure")
    @classmethod
    def dans_la_fenetre(cls, v: datetime) -> datetime:
        if v.tzinfo is None:
            raise ValueError("la date doit inclure un fuseau horaire")
        maintenant = datetime.now(timezone.utc)
        if v < maintenant or v > maintenant + timedelta(days=60):
            raise ValueError("réservation possible uniquement d’aujourd’hui à J+60")
        return v

class ReservationUpdate(BaseModel):
    date_heure: datetime | None = None
    couverts: int | None = Field(default=None, ge=1, le=12)
    statut: StatutReservation | None = None

Informations clés

Catégorie

Programmation et développement · Python

Type de résultat

Code

Niveau

Intermédiaire

Conçu pour

ChatGPT, Claude, Gemini et Microsoft Copilot

Vérifié sur

En attente de vérification éditoriale

Variables

Ressource, Champs et types, Règles métier, Base de données et Accès aux données

Langue

Français

Prix

Gratuit, sans inscription

Mis à jour

07/11/2026

Questions fréquentes