Verbi e codici, se qualcosa va storto
I messaggi della palestra, e i codici che si confondono
In questo capitolo non scrivi codice che si rompe: scrivi numeri. Quindi i guai sono di due tipi: i messaggi della palestra (e di curl), e i codici che si somigliano.
I messaggi
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
AssertionError: Manca la risposta: al posto di None scrivi la tua. | C'è ancora il None | Scrivi il codice: RISPOSTA_1 = 200 |
AssertionError: Non è questo codice. Rileggi la richiesta un pezzo alla volta, poi provala con curl -i. | La tua previsione è sbagliata. Il test, apposta, non dice quella giusta | Prima la prima cifra: di chi è la colpa? Poi la tabella dei dodici nella teoria. Poi lancia il curl -i della domanda e guarda la prima riga |
SyntaxError: invalid syntax, con le frecce sotto OK in RISPOSTA_1 = 200 OK | Hai scritto anche la frase: per Python 200 OK non è un valore | Solo il numero: RISPOSTA_1 = 200. Si ferma tutto il file, anche le altre due risposte |
ERROR: file or directory not found: palestra/test_prima_dell_apertura.py | Hai lanciato pytest da un'altra cartella (da dentro palestra/, o da quella sopra) | cd ~/corso/http-verbi-e-codici, poi di nuovo |
curl: (7) Failed to connect to 127.0.0.1 port 8000 | InfoMenta è spenta, o è accesa su un'altra porta | Nel primo terminale: fastapi dev palestra/infomenta.py, e lascialo acceso |
zsh: no matches found: e l'indirizzo | Sul Mac: l'indirizzo ha un ? e non è tra virgolette | Le virgolette doppie intorno all'indirizzo, come nelle domande: curl -i "http://127.0.0.1:8000/orari?stazione_id=1" |
curl non stampa niente | Hai dimenticato -i, e la risposta ha il corpo vuoto: un 301 o un 204 | Rimetti -i: la prima riga c'è sempre |
| Dal vivo esce un codice diverso da quello del test (409 alla domanda 4, 404 alla 6, 429 a ogni annuncio) | InfoMenta si ricorda le richieste di prima: il treno c'è già, è già stato tolto, gli annunci del minuto sono finiti | Ctrl+C nel terminale del server e riaccendi: tutto torna com'era. I test ripartono sempre da InfoMenta appena accesa |
Address already in use | C'è già un server acceso sulla porta 8000, in un altro terminale | Spegnilo con Ctrl+C di là. Oppure fastapi dev palestra/infomenta.py --port 8001, e nei comandi 8001 al posto di 8000 |
Un esempio vero: la risposta scritta con la frase, RISPOSTA_1 = 200 OK. pytest si ferma prima ancora di lanciare i test (accorciato):
______________________ ERROR collecting palestra/test_prima_dell_apertura.py _______________________
…
palestra/test_prima_dell_apertura.py:12: in <module>
from prima_dell_apertura import RISPOSTA_1, RISPOSTA_2, RISPOSTA_3
E File "~/corso/http-verbi-e-codici/palestra/prima_dell_apertura.py", line 17
E RISPOSTA_1 = 200 OK
E ^^
E SyntaxError: invalid syntaxSi legge dal basso: cosa (SyntaxError), dove (line 17 del tuo file), quale pezzo (le frecce sotto OK).
I codici che si confondono
| La coppia | Come li distingui | Sulla Linea Menta |
|---|---|---|
| 401 o 403 | 401: «chi sei?», il server non sa chi sei. 403: «so chi sei, ma non puoi» | Senza badge, o con un badge inventato: 401. Con il badge vero di Marta: 403 |
| 404 o 405 | 404: il percorso non c'è, o la cosa non c'è. 405: il percorso c'è, ma non con quel verbo. Il 405 porta l'header allow con i verbi giusti | GET /treno/1: 404. DELETE /stazioni/1: 405, allow: GET |
| 404 di FastAPI o 404 della funzione | Guarda il detail. Not Found: il percorso non esiste (una lettera, una barra). Una frase in italiano: il percorso c'è, è la cosa a mancare | /treno/1: Not Found. /treni/99: Treno non trovato |
| 400 o 422 | 422: i dati non vanno (manca un campo, il tipo è sbagliato) e lo dice FastAPI da solo, con un detail a lista. 400: i dati vanno, ma la domanda non ha senso, e lo dice la funzione, con una frase | /stazioni/abc: 422. Un viaggio da Largo Lista a Largo Lista: 400 |
| 200, 201 o 204 | Tutti «bene». 201: ho creato, ed ecco la cosa nuova con il suo id. 204: fatto, corpo vuoto. 200: tutto il resto | POST di un treno: 201. DELETE: 204. GET, PUT, PATCH: 200 |
| 422 dopo una PUT | La PUT vuole tutti i campi. Se ne mandi solo alcuni, quelli che mancano sono un errore | {"guasto": null} con la PUT: 422. Con la PATCH: 200 |
| 500 o 503 | 500: un incidente, un'eccezione che nessuno aspettava. 503: un cartello, «giù apposta, torna più tardi», spesso con retry-after | La divisione per zero dei tornelli di Vecchia Fiera: 500. Gli ascensori in manutenzione: 503 |
Il 500: non è colpa tua
Un 500 vuol dire che il server si è rotto mentre rispondeva. Chi ha fatto la richiesta non ha sbagliato niente, e dal client non può sapere di più: il corpo dice solo Internal Server Error.
Il perché sta nel terminale del server: lì c'è un traceback, e si legge dal basso, come quelli di Python. L'ultima riga dice cosa è successo (ZeroDivisionError), la riga File … line … del tuo file dice dove. Come si fa: Leggere un traceback.
Quando le API le scrivi tu, un 500 lo trovi così: nel terminale del server, oppure nei test, dove l'errore arriva con la riga del tuo codice. Per fermarti proprio su quella riga e guardare dentro le variabili: Il debugger su FastAPI e nei test.
Il 301 che curl non segue
curl -i sul vecchio indirizzo degli orari mostra il 301, con location: /partenze?stazione_id=1, e un corpo vuoto. Non è un errore: curl, senza altre opzioni, non va al nuovo indirizzo. Con -L ci va, e ti mostra le due risposte, il 301 e poi il 200. Il browser, invece, il rimando lo segue sempre da solo: per questo nella barra dell'indirizzo vedi comparire /partenze.
Se il problema non è il codice
pytest: command not found, command not found: fastapi, No module named pytest, il pannello Testing vuoto: non è la tua risposta, è l'ambiente. Il venv è spento, o VS Code usa un altro Python. Ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente. Per tutto il resto, il Pronto soccorso.