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.
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.
| # | Esercizio | Cosa impari | Difficoltà |
|---|---|---|---|
| 1 | La configurazione | launch.json, --app-dir | ★ |
| 2 | Il server fermo | un breakpoint dentro la richiesta | ★★ |
| 3 | Il ritardo che non torna | Debug 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
"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
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
/docs: quella arriva solo alla fine. Guarda il pannello VARIABLES mentre il server è fermo.Aiutino 2
totale vale quello che c'era prima di quella riga.Aiutino 3
/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
media. In VARIABLES guarda totale e n, poi calcola a mente totale diviso n: è il numero che ti aspetti?Aiutino 2
totale e n?