Vai al contenuto
code-to-code

Apro l'indice…

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

HTTP e API2. Verbi e codicip. 40

Verbi e codici, la palestra

Dodici richieste a InfoMenta, dodici codici da prevedere

  • 45–60 minuti di lavoro

Una mattina sulla Linea Menta, prima e dopo l'apertura. Quattro esercizi, dal ★ al ★★★, con tre domande ciascuno. Ogni domanda è una richiesta a InfoMenta, già scritta come comando curl, e la risposta è un numero: il codice che InfoMenta manda indietro. Alla fine avrai visto dal vivo tutti e dodici i codici del capitolo.

Gli esercizi da scaricare

Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.

http-verbi-e-codici.zip16 KB

Prima di iniziare

Scompatta lo zip e segui il README.md che c'è dentro: venv, pip install -r requirements.txt, code .. Se è la prima volta, la pagina Come si usa un esercizio lo fa con te, un comando alla volta.

Ogni esercizio, sempre gli stessi passi:

  1. Apri il file in palestra/. In alto: la storia, cosa fai, come provi. Sotto, le tre domande.
  2. Per ogni domanda, leggi il comando e le due righe di storia, e scrivi il codice al posto di None: RISPOSTA_1 = 200, senza virgolette.
  3. pytest palestra/test_<nome>.py -v, oppure la provetta di VS Code. Il test non ti dice il codice giusto: ti dice solo se il tuo lo è.
  4. Poi, per ogni domanda, la prova dal vivo: InfoMenta accesa, il comando curl -i della domanda, e la prima riga della risposta.

Per la prova dal vivo servono due terminali, tutti e due nella cartella dello zip e con il venv acceso. Nel primo terminale (il server):

Terminale
fastapi dev palestra/infomenta.py

Nel secondo terminale, il comando della domanda. I test, invece, non hanno bisogno del server acceso: fanno la stessa richiesta da soli, con TestClient.

#EsercizioDomandeCosa allenaDifficoltà
1Prima dell'apertura1–3tre GET: c'è, non c'è, è altrove★
2I treni del giorno4–6POST, PUT e DELETE★★
3Il giro di Nadia7–9il badge, e un server che si rompe★★
4L'app di Rosa10–12quando va male: di chi è la colpa?★★★

1 · Prima dell'apertura ★

palestra/prima_dell_apertura.py

Sono le cinque del mattino. Ernesto Pozzi, il capo deposito, prova InfoMenta prima che apra la linea: tre GET, che leggono e non cambiano niente.

Domanda 1. La stazione 6 è Vecchia Fiera, chiusa al pubblico da vent'anni. Ernesto chiede la sua scheda.

Terminale
curl -i http://127.0.0.1:8000/stazioni/6

Domanda 2. Il treno 1, l'M12, c'è: è fermo a Porta Codice. Ma Ernesto scrive di fretta.

Terminale
curl -i http://127.0.0.1:8000/treno/1

Domanda 3. Gli orari stavano in /orari; da quest'anno stanno in /partenze, per sempre. Ernesto ha ancora il vecchio indirizzo tra i preferiti. Che codice risponde InfoMenta a questo comando, così com'è scritto?

Terminale
curl -i "http://127.0.0.1:8000/orari?stazione_id=1"

Come provi: pytest palestra/test_prima_dell_apertura.py -v

Aiutino 1
Domanda 1: il codice dice com'è andata la richiesta, non com'è la stazione. La scheda di Vecchia Fiera c'è? Che InfoMenta la dia aperta o chiusa, sta scritto nel corpo.
Aiutino 2
Domanda 2: confronta il percorso con quelli degli esercizi spiegati, lettera per lettera. Domanda 3: «spostato per sempre» ha un codice suo. E curl, senza altre opzioni, non va a cercare il nuovo indirizzo: si ferma alla prima risposta.

2 · I treni del giorno ★★

palestra/treni_del_giorno.py

Ernesto prepara i treni del giorno: uno nuovo entra in servizio, uno è stato riparato, uno va in revisione. Tre richieste che cambiano i dati.

Domanda 4. Il nuovo M18 entra in servizio a Porta Codice. I dati sono tutti giusti, e nessun altro treno usa il codice M18.

Terminale
curl -i -X POST http://127.0.0.1:8000/treni \
     -H "Content-Type: application/json" \
     -d '{"codice": "M18", "tipo": "metro", "vagoni": 4, "stazione_id": 1}'

Domanda 5. Il T09 (il treno 5) aveva le porte bloccate: le hanno riparate. Ernesto vuole togliere il guasto, e manda soltanto il campo che cambia. Guarda il verbo.

Terminale
curl -i -X PUT http://127.0.0.1:8000/treni/5 \
     -H "Content-Type: application/json" \
     -d '{"guasto": null}'

Domanda 6. L'M14 (il treno 2) va in revisione per un mese: Ernesto lo toglie da InfoMenta. Il treno 2 c'è.

Terminale
curl -i -X DELETE http://127.0.0.1:8000/treni/2

Come provi: pytest palestra/test_treni_del_giorno.py -v

Aiutino 1
Tre richieste andate bene, o quasi: la prima cifra è quasi sempre un 2. Ma «tutto bene» ha tre codici diversi: quello per «ecco la risposta», quello per «creato», quello per «fatto, niente da mostrare».
Aiutino 2
Domanda 5: rileggi l'esempio B degli esercizi spiegati. La PUT sostituisce il treno intero: quanti campi le arrivano qui?

3 · Il giro di Nadia ★★

palestra/giro_di_nadia.py

Nadia Russo, la guardia giurata, fa il giro dei controlli. Il registro del deposito è solo per il capo deposito: Nadia controlla che resti chiuso a chi non deve leggerlo. Poi passa dai tornelli di Vecchia Fiera.

Domanda 7. Il registro si apre con un badge, mandato nell'header Authorization. Nadia prova senza: nessun header.

Terminale
curl -i http://127.0.0.1:8000/deposito/registro

Domanda 8. Marta Villa, la capostazione di Piazza Query, prova con il suo badge, B-07. InfoMenta lo conosce: è un badge vero. Ma il registro è solo per il capo deposito.

Terminale
curl -i http://127.0.0.1:8000/deposito/registro -H "Authorization: Bearer B-07"

Domanda 9. InfoMenta calcola quanti passeggeri sono passati da ogni tornello: i passeggeri del giorno divisi per i tornelli aperti. Vecchia Fiera esiste, ma è chiusa: i suoi tornelli aperti sono zero.

Terminale
curl -i http://127.0.0.1:8000/stazioni/6/affluenza

Come provi: pytest palestra/test_giro_di_nadia.py -v

Aiutino 1
Domande 7 e 8: le due domande del capitolo sono «chi sei?» e «puoi?». A quale delle due InfoMenta non sa rispondere, senza badge? E con il badge di Marta?
Aiutino 2
Domanda 9: in Python, 10 // 0 che cosa fa? Se succede dentro il server, e nessuno l'ha previsto, di chi è la colpa: di Nadia o di InfoMenta? La prima cifra viene da lì.

4 · L'app di Rosa ★★★

palestra/app_di_rosa.py

Rosa Bellini lavora in un'agenzia di viaggi. Stamattina accompagna un gruppo di turisti sulla Linea Menta e usa l'app InfoMenta dal telefono. Non tutto va liscio.

Domanda 10. Rosa cerca un viaggio e tocca due volte Largo Lista (la stazione 3): partenza e arrivo sono la stessa stazione. I due numeri sono scritti giusti, e la stazione 3 esiste.

Terminale
curl -i "http://127.0.0.1:8000/viaggio?da=3&a=3"

Domanda 11. Con l'app, Rosa manda un annuncio all'altoparlante di Porta Codice. Non lo sente arrivare e lo rimanda: quattro volte, una dietro l'altra, in meno di un minuto. L'altoparlante ne accetta al massimo tre al minuto. Che codice risponde InfoMenta al quarto?

Terminale
curl -i -X POST http://127.0.0.1:8000/annunci \
     -H "Content-Type: application/json" \
     -d '{"testo": "Gruppo Bellini: ci vediamo al tornello 3"}'

Domanda 12. Un turista ha una valigia pesante: Rosa cerca un ascensore. Stamattina gli ascensori della linea sono in manutenzione, fino alle 6.

Terminale
curl -i http://127.0.0.1:8000/ascensori

Come provi: pytest palestra/test_app_di_rosa.py -v

Aiutino 1
Domanda 10: i dati sono del tipo giusto, quindi FastAPI li lascia passare. È la funzione di InfoMenta a dire «questa domanda non ha senso». Rileggi la coppia «400 o 422?» nella teoria.
Aiutino 2
Domanda 11: i primi tre annunci passano. Il quarto è uno di troppo: c'è un codice che vuol dire proprio «rallenta». Domanda 12: il server non si è rotto per sbaglio; il servizio è giù apposta, e lo sa.

Finito? Confronta le tue risposte con le soluzioni: per ogni domanda c'è il perché, la risposta vera di InfoMenta presa con curl -i, e le risposte sbagliate più comuni.