Vai al contenuto
code-to-code

Apro l'indice…

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

HTTP e API1. Il viaggio di una richiestap. 14

Il viaggio di una richiesta, la palestra

Sei viaggi da smontare, con i test

  • 45–60 minuti di lavoro

Sei esercizi corti, dal ★ al ★★★. In ognuno c'è un viaggio vero, fatto a InfoMenta: una richiesta, una risposta o un indirizzo, già pronto in un commento. Tu lo smonti e rispondi alle domande. Quando è tutto verde, hai finito.

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-viaggio-di-una-richiesta.zip20 KB

Prima di iniziare

Scompatta lo zip e segui il README.md che c'è dentro: venv, pip install, 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 quattro passi:

  1. Apri il file in palestra/. In alto: la storia, cosa fai, come provi. Sotto, in un commento, il viaggio da smontare.
  2. Al posto di ogni None scrivi la tua risposta: un numero senza virgolette (42), un testo tra virgolette ("Porta Codice").
  3. pytest palestra/test_<nome>.py -v, oppure la provetta di VS Code.
  4. Rosso? Leggi l'ultima riga del messaggio. Bloccato da 15 minuti? Apri il primo aiutino, non la soluzione.

All'inizio ogni test è rosso, e dice così:

E       AssertionError: Manca la risposta: al posto di None scrivi la tua.

Quando scrivi una risposta sbagliata, il test non ti dice quella giusta. Ti dice solo:

E       AssertionError: Non è questa. Rileggi la richiesta un pezzo alla volta, e riprova.

I test conoscono le risposte in due modi. Quando la risposta sta nel JSON o negli header, il test fa a InfoMenta la stessa richiesta e confronta. Quando sta solo nel testo (un percorso, un nome), il test ne conosce soltanto l'impronta: un codice calcolato dalla risposta, che dice se la tua è uguale ma da cui non si torna indietro. Maiuscole e spazi in più non contano, e 5 vale quanto "5".

#EsercizioCosa smontiDifficoltà
1La domanda di Luciauna richiesta GET★
2La risposta a Luciala sua risposta★
3Un indirizzo lungoun indirizzo con due coppie nella query★★
4L'annuncio di Martauna POST con il corpo, e la sua risposta★★
5Il tabelloneuna risposta che non è JSON★★
6I tram in lineaun corpo JSON, letto da Python★★★

1 · La domanda di Lucia ★

palestra/domanda_di_lucia.py

Lucia Ferri, la capotreno, vuole sapere quali treni sono fermi a Piazza Query, la stazione 5. Nel file c'è la richiesta che parte dal suo terminale:

Terminale
curl -v "http://127.0.0.1:8000/treni?stazione_id=5"

Le domande: il verbo; il percorso, senza la query; il valore del parametro; quante righe di header.

Come provi: pytest palestra/test_domanda_di_lucia.py -v

Aiutino 1
La riga di richiesta ha tre parole. Il percorso è la seconda, ma solo fino al ?: quello che viene dopo è la query.
Aiutino 2
Gli header sono le righe nella forma Nome: valore. La prima riga non lo è, e la riga vuota nemmeno.

2 · La risposta a Lucia ★

palestra/risposta_a_lucia.py

InfoMenta risponde alla domanda di Lucia. Nel file c'è la risposta intera, come la stampa:

Terminale
curl -i "http://127.0.0.1:8000/treni?stazione_id=5"

Le domande: il codice; il valore dell'header che dice il tipo del corpo; il codice del treno fermo a Piazza Query; quanti vagoni ha.

Come provi: pytest palestra/test_risposta_a_lucia.py -v

Aiutino 1
Il codice di stato sta nella prima riga ed è un numero. La parola che lo segue è la sua frase: non fa parte del codice.
Aiutino 2
La 2B chiede il valore dell'header, cioè quello che c'è dopo i due punti. La 2C chiede il codice del treno: è nel corpo, non nella riga di stato.

3 · Un indirizzo lungo ★★

palestra/indirizzo_lungo.py

All'agenzia di viaggi, Rosa Bellini prepara il viaggio di un cliente da Via Variabile a Ponte Ciclo. Il programma dell'agenzia chiede a InfoMenta:

http://127.0.0.1:8000/viaggio?da=2&a=4

Le domande: l'host; la porta; il percorso; il valore del parametro a.

Come provi: pytest palestra/test_indirizzo_lungo.py -v

Aiutino 1
Disegna le parentesi sotto l'indirizzo, come nella teoria. L'host comincia dopo // e finisce ai due punti; la porta va da quei due punti alla / dopo.
Aiutino 2
Il percorso comincia con / e finisce prima del ?: niente host, niente porta, niente query.
Aiutino 3
Separa la query con &, poi ogni coppia con =: a sinistra il nome, a destra il valore. Attento a da: finisce con una a, ma il suo nome non è a.

4 · L'annuncio di Marta ★★

palestra/annuncio_di_marta.py

Marta Villa, la capostazione di Piazza Query, ha l'ascensore fermo e manda a InfoMenta un annuncio per l'app dei passeggeri. Nel file ci sono la richiesta, con il suo corpo, e la risposta:

Terminale
curl -v http://127.0.0.1:8000/annunci \
    -H "Content-Type: application/json" \
    -d '{"testo": "Ascensore di Piazza Query fermo: usate le scale"}'

Le domande: il verbo; il nome dell'header che dice «il corpo è JSON»; il codice della risposta; l'id dell'annuncio nuovo.

Come provi: pytest palestra/test_annuncio_di_marta.py -v

Aiutino 1
La 4B chiede il nome, cioè la parte prima dei due punti. È un header della richiesta: guarda sopra la riga vuota della richiesta, non nella risposta.
Aiutino 2
Il codice non è sempre 200: leggilo nella prima riga della risposta. E l'id non l'ha mandato Marta: cercalo nel corpo della risposta. È l'esempio D degli esercizi spiegati.

5 · Il tabellone ★★

palestra/tabellone.py

Il tabellone delle partenze di Porta Codice è una pagina web servita da InfoMenta. Ernesto Pozzi, il capo deposito, la chiede con curl per vedere cosa arriva davvero:

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

Le domande: di che tipo è il corpo; quanti byte è lungo; quale percorso chiede la pagina a InfoMenta, una volta aperta.

Come provi: pytest palestra/test_tabellone.py -v

Aiutino 1
Il tipo e la lunghezza del corpo li dicono due header. Per il tipo, tieni solo la parte prima del ;.
Aiutino 2
Non serve capire l'HTML. Cerca la riga con fetch: tra le virgolette c'è un indirizzo senza host e porta (è lo stesso server). Togli la query.

6 · I tram in linea ★★★

palestra/tram_in_linea.py

Ivo Brambati, il manutentore, vuole sapere quali tram hanno un guasto prima di uscire dal deposito. Chiede a InfoMenta i tram, poi legge il corpo con json.loads:

Terminale
curl -i "http://127.0.0.1:8000/treni?tipo=tram"

Le domande: quanti treni ci sono nella risposta; il codice del tram con un guasto; che tipo Python è il corpo dopo json.loads; che tipo Python è il guasto del T05.

Come provi: pytest palestra/test_tram_in_linea.py -v

Aiutino 1
Il corpo comincia con [. Che cos'è, in JSON? Quanti oggetti tra graffe ci sono dentro?
Aiutino 2
Per la 6C e la 6D rileggi la tabella «da JSON a Python» dell'esempio E. Si chiede il tipo, come lo scrive type(): la parola tra apici in <class '…'>, non il valore.
Aiutino 3
Se non sei sicura, sicuro: prova. Apri python3, incolla il corpo tra apici singoli in json.loads, e chiedi a type().

Finito? Confronta le tue risposte con le soluzioni: per ogni esercizio ci sono il ragionamento, le risposte e le trappole più comuni.