Vai al contenuto
code-to-code

Apro l'indice…

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

HTTP e API2. Verbi e codicip. 52

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

LeggiVuol direCosa fai
AssertionError: Manca la risposta: al posto di None scrivi la tua.C'è ancora il NoneScrivi 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 giustaPrima 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 OKHai scritto anche la frase: per Python 200 OK non è un valoreSolo 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.pyHai 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 8000InfoMenta è spenta, o è accesa su un'altra portaNel primo terminale: fastapi dev palestra/infomenta.py, e lascialo acceso
zsh: no matches found: e l'indirizzoSul Mac: l'indirizzo ha un ? e non è tra virgoletteLe virgolette doppie intorno all'indirizzo, come nelle domande: curl -i "http://127.0.0.1:8000/orari?stazione_id=1"
curl non stampa nienteHai dimenticato -i, e la risposta ha il corpo vuoto: un 301 o un 204Rimetti -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 finitiCtrl+C nel terminale del server e riaccendi: tutto torna com'era. I test ripartono sempre da InfoMenta appena accesa
Address already in useC'è già un server acceso sulla porta 8000, in un altro terminaleSpegnilo 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 syntax

Si legge dal basso: cosa (SyntaxError), dove (line 17 del tuo file), quale pezzo (le frecce sotto OK).

I codici che si confondono

La coppiaCome li distinguiSulla Linea Menta
401 o 403401: «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 405404: 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 giustiGET /treno/1: 404. DELETE /stazioni/1: 405, allow: GET
404 di FastAPI o 404 della funzioneGuarda 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 422422: 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 204Tutti «bene». 201: ho creato, ed ecco la cosa nuova con il suo id. 204: fatto, corpo vuoto. 200: tutto il restoPOST di un treno: 201. DELETE: 204. GET, PUT, PATCH: 200
422 dopo una PUTLa 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 503500: un incidente, un'eccezione che nessuno aspettava. 503: un cartello, «giù apposta, torna più tardi», spesso con retry-afterLa 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.