Vai al contenuto
code-to-code

Apro l'indice…

↑ ↓ per scegliere, Invio per aprire, Esc per chiudere

Il progetto5. Un pezzo alla voltap. 175

Un pezzo alla volta, se qualcosa va storto

Gli errori del capitolo, uno per uno

Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai. Quasi tutti hanno un nome che dice già dove cercare.

La regola che vale per tutti è quella del capitolo: se non capisci dove sta il guaio, torna all'ultimo commit verde e fai il pezzo più piccolo. Un errore dopo cinque righe nuove ha cinque sospetti; dopo trenta righe nuove, trenta.

Il traceback si legge dal basso: l'ultima riga dice cosa, la riga con File … line … dice dove (Leggere un traceback).

Il test rosso, e cosa dice

Prima di tutto: un test rosso che fa il suo mestiere non è un guaio. Il primo test di ogni pezzo deve essere rosso. Il guaio è un test rosso per il motivo sbagliato.

LeggiVuol direCosa fai
assert 404 == 200La rotta non c'è. Per FastAPI è la stessa cosa se il file non esiste, se il router non è montato o se il percorso è sbagliatoControlla, in ordine: il file in app/rotte/; app.include_router(…) in main.py; il prefisso e il percorso della rotta
assert 405 == 201Il percorso c'è, ma non per quel verbo: hai scritto la GET e manca la POSTIl decoratore: @router.post(""), non @router.get("")
assert 501 == 200C'è ancora la riga del «da fare»Al suo posto, il tuo codice
ImportError o ModuleNotFoundError nel test appena scrittoIl test è rosso per il motivo sbagliato: l'import, non la rottaSistema l'import: from app.main import app, dalla cartella ritrovato/
ModuleNotFoundError: No module named 'app'Hai lanciato pytest (o fastapi dev) da un'altra cartella: Python non trova app/cd nella cartella del progetto (storia/ritrovato/): lì c'è il pytest.ini con pythonpath = .
HTTP/1.1 307 Temporary Redirect in curl -i (il TestClient dei test il redirect lo segue, e il test resta verde)La rotta è scritta @router.get("/") e il router ha già il prefisso: GET /oggetti viene mandato a /oggetti/Nel router con il prefisso, il percorso della lista è "": @router.get("")
assert 404 == 201 su una POSTCome il primo: il router non c'è, o il percorso è sbagliato. Nella storia, il livello 6 ha un file nuovo, restituzioni.py, con il suo include_routermain.py: ci sono tutte le righe include_router?

La riga 404 merita una frase in più. Capita a tutti: la rotta è scritta giusta, il test è rosso, e il guaio sta in main.py. Quando una rotta «non c'è», guarda main.py prima di guardare la rotta.

Gli errori con un nome

LeggiVuol direCosa fai
InvalidRequestError: Instance '<OggettoDB at 0x…>' is not persistent within this SessionHai fatto db.refresh su un oggetto che non è stato salvato: manca il db.commit()add, commit, e solo dopo refresh
IntegrityError: (psycopg.errors.NotNullViolation) null value in column "registrato_da" of relation "oggetti" violates not-null constraintUna colonna NOT NULL è rimasta vuota: qui, il valore finto non l'hai messoOggettoDB(**dati.model_dump(), registrato_da=ADDETTO_FINTO)
IntegrityError: (psycopg.errors.ForeignKeyViolation) … Key (stazione_id)=(9) is not present in table "stazioni"Il valore punta a una riga che non esiste, e nessuno l'ha controllatoPrima della scrittura: db.get(StazioneDB, dati.stazione_id), e se è None rispondi tu
IntegrityError: (psycopg.errors.UniqueViolation) duplicate key value violates unique constraint "…_key"Hai scritto un valore che deve essere unico, e c'è già: il database ha detto noControlla prima, e rispondi 409
UniqueViolation … "prenotazioni_pkey", Key (id)=(1) already existsHai scritto tu l'id: lo sceglie il databaseTogli id=… dall'oggetto
ResponseValidationError … Input should be a valid dictionary or object to extract fields from, con 'input': NoneLa rotta ha restituito None: manca l'if … is None con il 404L'if, prima del return
ResponseValidationError … Field required, con 'input': (<modelli.CampoDB object at 0x…>,)Hai usato db.execute(…).all(): arrivano righe, non oggettidb.scalars(…).all()
AttributeError: 'NoneType' object has no attribute 'stato'db.get ha dato None e sei andato avantiSubito dopo: if oggetto is None: e il 404
UnmappedInstanceError: Class 'builtins.NoneType' is not mappedA db.delete hai passato None: la riga non c'eraif … is None con il 404, prima di db.delete
NoInspectionAvailable: No inspection system is available for object of type <class 'pydantic._internal._model_construction.ModelMetaclass'>A db.get hai passato lo stampo (Prenotazione) al posto della classe-tabelladb.get(PrenotazioneDB, …): dentro va la classe con il DB
OperationalError: … database "ritrovato" does not existDATABASE_URL (o il valore di ripiego in database.py) punta a un database che non hai creatocreatedb ritrovato, poi psql -d ritrovato -f schema.sql
ProgrammingError: (psycopg.errors.UndefinedTable) relation "stazioni" does not existIl database c'è, ma è vuotopsql -d ritrovato -f schema.sql, poi i dati
422 Unprocessable Content in /docsIl corpo che hai mandato non rispetta lo stampo: manca un campo, o un valore non è ammesso (una categoria che non c'è, un documento di cinque cifre)Leggi il detail della risposta: dice quale campo e cosa non va

Gli errori che non danno errori

Sono i peggiori: non c'è un messaggio, c'è un risultato strano.

VediVuol direCosa fai
Tutti i test sono verdi, ma in /docs la rotta non salva nienteIl test controlla la risposta e non il database. Manca il commit, e il test non se n'è accortoAggiungi un test che guarda dentro il database (sql("SELECT …")): è l'esempio D
/docs mostra [] o una lista più corta del previstoStai guardando il tuo database, e quello è vuoto (o sbagliato). Il test, invece, ha il suopsql -d ritrovato -c "SELECT count(*) FROM oggetti": se è 0, carica i dati
I test passano, e dopo aver provato /docs i dati sono cambiati/docs lavora sul tuo database e ci scrive davvero. I test no: hanno il loroNormale. Per ripartire dai dati di prova: rilancia il file .sql dei dati
L'oggetto restituito compare ancora nell'elencoLa rotta della restituzione ha scritto la restituzione e non ha cambiato lo statooggetto.stato = "restituito" prima del commit
Il filtro con due parametri ne ignora unoHai scritto elif al posto del secondo ifUn if per filtro, tutti separati
Un oggetto compare con un filtro e non con un altroIl where di un filtro cancella quello dell'altro: hai scritto domanda = select(…).where(…) invece di domanda = domanda.where(…)Il filtro si aggiunge alla domanda che hai già
Il segno particolare esce nel JSON pubblicoLo stampo di risposta lo include: l'hai copiato da OggettoNuovoLo stampo Oggetto, quello senza il segno

Gli errori del metodo

Non danno un messaggio, ma costano ore. Un test verde che non guarda il database non dice «fatto».

SuccedePerchéCosa fai
«Ho scritto tutti i modelli, tutti gli stampi e tutte le rotte, e adesso non parte»Hai fatto a strati: il primo test è arrivato dopo dodici coseCommenta tutto tranne un pezzo: lascia una rotta sola, e falla camminare. Poi il pezzo dopo
Due test rossi nello stesso momento, e non so quale causa cosaHai cominciato il pezzo 4 senza finire il 3Torna all'ultimo commit verde (git status, poi git restore), e rifai un pezzo solo
«Il test è verde, quindi è fatto»Il test dice «fatto» per quello che controlla. Manca la prova in /docsProva la rotta a mano, e guarda cosa è cambiato nel database
Il progetto «funziona» ma non so a che punto sonoNon c'è un elenco dei pezzi, né commit che li raccontanoIl README.md («A che punto siamo»), e git log --oneline: un commit per pezzo
Un 1 sparso in tre rotte, e nessuno si ricorda cosa vuol direUn valore finto senza nome, senza commento, in tre postiUna costante con il suo commento FINTO, in un file solo. grep -rn FINTO app/ la ritrova
Una funzione «se avanza tempo» fatta prima delle tre indispensabiliL'ordine dei lavori non c'è, o non è stato seguitoRimettila in fondo alla tabella: prima le tre funzioni, poi il login, poi il resto
Non so da dove ricominciareSei fermo troppo in altoIl pezzo più piccolo: la rotta che risponde [], senza il database. Poi il database

Gli errori della palestra

I test rossi che incontrerai di più negli esercizi.

LeggiVuol direCosa fai
Un filtro che non trova niente non è un errore: 200 e una lista vuotaHai risposto 404 a una lista che non ha trovato nienteUna lista si restituisce sempre, anche vuota. Il 404 è per «una cosa sola» (la scheda)
Con due filtri servono tutte e due le condizioniIl secondo filtro è ignorato: elif al posto di ifUn if per filtro
La prenotazione non è nel database: c'è il db.commit()?Hai usato db.flush() al posto di db.commit(), o non hai fatto il commitdb.commit(). flush manda i comandi, ma non conferma
Lo slot è campo + giorno + oraNel controllo dello slot ti manca una delle tre condizioniTre condizioni nel where: campo, giorno, ora
Il Campo 9 non esiste: prima db.get, e se è None il 404Hai scritto direttamente la prenotazione, e il database ha detto no con un ForeignKeyViolationIl controllo del campo, prima del controllo dello slot
La riga c'è ancora: manca db.commit()?La disdetta non è stata confermatadb.commit() dopo db.delete(…)
Con un 422 non si scrive nienteHai scritto prima di controllareI controlli prima della scrittura; per i 422 degli stampi se ne occupa FastAPI
Le due scritture vanno insieme: la restituzione E lo stato dell'oggetto, con un commit soloManca la modifica dello stato, o hai scritto due commitCambia oggetto.stato, db.add(restituzione), un db.commit() solo

Tutto il resto: il Pronto soccorso sul sito.