Endpoint CRUD in FastAPI con Pydantic v2, Alembic e test pytest

Prompt

Agisci come sviluppatore backend senior specializzato in Python, FastAPI e SQLAlchemy.

Voglio aggiungere a un’API FastAPI esistente un modulo completo per gestire {{risorsa}}.
- Campi e tipi: {{campi}}
- Regole di business: {{regole}}
- Database: {{database}}
- Accesso ai dati: {{accesso}}

Consegna, in quest’ordine:
1. La struttura dei file (router, schemi, modello, service o repository, test) con una frase che giustifichi la suddivisione.
2. Schemi Pydantic v2 separati per creazione, aggiornamento parziale e risposta, con validazioni (`Field`, `field_validator`, `model_validator`) che applichino le regole di business.
3. Il modello del database e la relativa migrazione Alembic, con indici e vincoli di unicità dove servono.
4. Un router con elenco paginato e filtrabile, dettaglio, creazione, aggiornamento parziale (PATCH) ed eliminazione. Usa i codici corretti (201, 204, 404, 409, 422) e un `response_model` su ogni endpoint.
5. La sessione del database iniettata con `Depends`, senza stato globale e con transazioni ben delimitate.
6. Test con pytest e `httpx.AsyncClient` (o `TestClient` se l’accesso è sincrono): caso felice, validazione, risorsa inesistente e conflitto con una regola di business, su un database di test isolato.
7. I comandi per avviare l’app, applicare la migrazione ed eseguire i test.

Vincoli:
- Python 3.11 o superiore, tutto tipizzato, nessuna dipendenza superflua.
- Non inventare campi né regole: se qualcosa è ambiguo, chiedimelo prima di scrivere codice o segnalo con [DA COMPLETARE].
- Indica quali decisioni dipendono dal resto del mio progetto (autenticazione, configurazione, nomi delle tabelle).

Formato: un blocco di codice per file con il percorso come titolo e, alla fine, l’elenco delle ipotesi.

Come usarlo

Esempio d'uso

Esempio di risultato

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

class StatoPrenotazione(str, Enum):
    in_attesa = "in_attesa"
    confermata = "confermata"
    annullata = "annullata"

class PrenotazioneCreate(BaseModel):
    nome_cliente: str = Field(min_length=1, max_length=120)
    telefono: str = Field(pattern=r"^\+?[0-9 ]{7,20}$")
    data_ora: datetime
    coperti: int = Field(ge=1, le=12)

    @field_validator("data_ora")
    @classmethod
    def nella_finestra(cls, v: datetime) -> datetime:
        if v.tzinfo is None:
            raise ValueError("la data deve includere il fuso orario")
        adesso = datetime.now(timezone.utc)
        if v < adesso or v > adesso + timedelta(days=60):
            raise ValueError("prenotazioni ammesse solo da oggi a 60 giorni")
        return v

class PrenotazioneUpdate(BaseModel):
    data_ora: datetime | None = None
    coperti: int | None = Field(default=None, ge=1, le=12)
    stato: StatoPrenotazione | None = None

Dati chiave

Categoria

Programmazione e sviluppo · Python

Tipo di output

Codice

Livello

Intermedio

Pensato per

ChatGPT, Claude, Gemini e Microsoft Copilot

Verificato in

In attesa di verifica editoriale

Variabili

Risorsa, Campi e tipi, Regole di business, Database e Accesso ai dati

Lingua

Italiano

Prezzo

Gratuito, senza registrazione

Aggiornato

07/11/2026

Domande frequenti