Vai al contenuto
code-to-code

Apro l'indice…

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

Errori e debugger6. Il debugger su FastAPI e nei testp. 146

Il debugger su FastAPI e nei test, la palestra

La centrale che sbaglia la media

  • 45–60 minuti di lavoro

Tre esercizi su un'unica API: la centrale della Linea Menta, che raccoglie i ritardi segnalati dai capotreno. Una rotta sola, GET /treni/{codice}/ritardo, che risponde con il ritardo medio di un treno. Qualcosa nei conti non torna: nell'ultimo esercizio lo troverai con il debugger.

Gli esercizi da scaricare

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

errori-debugger-fastapi-e-test.zip13 KB

La storia

Notte alla centrale. Lucia Ferri, capotreno su M12, ha segnalato tre ritardi durante il giro: 4, 6 e 8 minuti. La centrale, sul suo schermo, scrive che il ritardo medio di M12 è di 4,5 minuti. Lucia fa il conto a mente: la media non può essere quella.

Prima di iniziare

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

L'API è in palestra/centrale/main.py. Non è ancora accesa: per accenderla con il debugger ti serve la configurazione, ed è il primo esercizio.

#EsercizioCosa impariDifficoltà
1La configurazionelaunch.json, --app-dir★
2Il server fermoun breakpoint dentro la richiesta★★
3Il ritardo che non tornaDebug Test, e il commento # BUG:★★★

1 · La configurazione ★

.vscode/launch.json

Aggiungi, accanto a «Il file aperto», una configurazione che accende la centrale: uvicorn, l'app main:app, la cartella di main.py con --app-dir, e niente --reload. Il nome lo scegli tu.

Prova: pytest palestra/test_launch.py -v. Poi, per vedere se funziona davvero: Run and Debug → la tua configurazione → il triangolo verde, e nel browser http://127.0.0.1:8000/docs.

Aiutino 1
Ripassa la tabella «riga / vuol dire» della teoria. Quali due pezzi ti servono dopo "module"?
Aiutino 2
main.py non sta nella cartella aperta in VS Code. In quale cartella sta? Scrivila come percorso, a partire dalla cartella dello zip.
Aiutino 3
Gli args sono una lista di pezzi: l'app, poi --app-dir, poi il suo valore. Tre pezzi in tutto.

2 · Il server fermo ★★

palestra/risposte.py, domande 2A e 2B

Accendi la centrale con la tua configurazione. In palestra/centrale/main.py c'è una riga con il triangolo ◀, dentro il for: mettici il breakpoint. Poi da /docs: GET /treni/{codice}/ritardo, codice M14, Execute.

Il browser resta ad aspettare: è giusto, il server è fermo. Guarda VARIABLES in VS Code, e premi ▶ Continue per passare alla fermata dopo.

  • 2A. Alla terza fermata, quanto vale totale?
  • 2B. In tutto, quante volte si ferma il server su quel breakpoint, per quella richiesta?

Scrivi i numeri in risposte.py al posto di None, poi pytest palestra/test_risposte.py -v (o -k 2a per una domanda sola).

Aiutino 1
Il valore che cerchi non è nella risposta di /docs: quella arriva solo alla fine. Guarda il pannello VARIABLES mentre il server è fermo.
Aiutino 2
La riga gialla non è ancora stata eseguita: totale vale quello che c'era prima di quella riga.
Aiutino 3
Per 2B guarda cosa succede dopo l'ultima fermata. Quando /docs smette di girare?

3 · Il ritardo che non torna ★★★

palestra/centrale/main.py e palestra/centrale/test_main.py

I test della centrale sono rossi, e nessuno ha un traceback: la rotta risponde, ma con un numero sbagliato. Trova il bug con Debug Test: il breakpoint in main.py, poi nel pannello Testing tasto destro sul test rosso → Debug Test.

Prima di correggere, sopra la riga sbagliata, un commento che comincia con BUG:, seguito da cosa hai visto nel debugger e perché è sbagliato. Poi la correzione, la più piccola possibile. Infine pytest palestra/centrale/test_main.py -v: tutto verde.

Dopo la correzione, con il server acceso dal debugger, ricorda il ↻ Restart.

Aiutino 1
Metti il breakpoint sulla riga che calcola media. In VARIABLES guarda totale e n, poi calcola a mente totale diviso n: è il numero che ti aspetti?
Aiutino 2
Il risultato è diverso dal tuo conto. Quale altro numero c'è nella riga della media, oltre a totale e n?
Aiutino 3
In WATCH (il pannello delle domande) scrivi quell'espressione: quanto vale? E cosa dovresti dividere, invece?
Aiutino 4
Hai corretto e il test è ancora rosso, o ne è diventato rosso un altro? Rileggi tutti i test: la correzione vale per ogni treno, anche per quello senza segnalazioni.