Il debugger su FastAPI e nei test, le soluzioni
Il ragionamento, il codice, le trappole
Per ogni esercizio, sempre lo stesso ordine: in italiano → il codice → le trappole. Per i più difficili, anche il passo per passo.
La tua soluzione è diversa ma i test sono verdi? Probabilmente va bene: la configurazione si può scrivere in più modi, e anche la correzione. Confronta il ragionamento, non le singole parole. E leggi comunque le trappole: alcune passano qualche test e si rompono su un altro.
Le soluzioni complete
La stessa cartella, con il codice al posto di pass. Aprila dopo averci provato: i test sono gli stessi.
La palestra
1 · La configurazione
In italiano. VS Code deve accendere uvicorn al posto mio. Gli dico che il modulo da lanciare è uvicorn, e gli passo gli stessi pezzi che scriverei nel terminale: l'app (main:app), e --app-dir con la cartella dove sta main.py, perché VS Code è aperto sulla cartella dello zip e main.py è due gradini più giù. Nessun --reload.
{
"version": "0.2.0",
"configurations": [
{
"name": "Il file aperto",
"type": "debugpy",
"request": "launch",
"program": "${file}",
"console": "integratedTerminal"
},
{
"name": "La centrale",
"type": "debugpy",
"request": "launch",
"module": "uvicorn",
"args": ["main:app", "--app-dir", "palestra/centrale"],
"jinja": true
}
]
}Il nome è libero: "La centrale", "Centrale", quello che ti piace. Anche "--app-dir=palestra/centrale" in un pezzo solo va bene, e così ${workspaceFolder}/palestra/centrale: sono lo stesso percorso. E "jinja": true puoi non metterlo.
Gli sbagli. Questa configurazione non ha trappole con un file di prova (non c'è un test che lancia VS Code), ma gli sbagli più comuni sono raccontati con quello che vedi nella pagina Se qualcosa va storto.
2 · Il server fermo
In italiano. Il breakpoint sta dentro il for, e per ogni segnalazione del treno la richiesta passa una volta da quella riga. M14 ha cinque segnalazioni: cinque fermate. Alla terza fermata il for è al terzo giro, e la riga gialla (totale = totale + minuti) non è ancora stata eseguita: totale ha dentro solo i primi due giri.
RISPOSTA_2A = 11
RISPOSTA_2B = 5Passo per passo. Le cinque fermate della richiesta a M14, con quello che dice VARIABLES:
| Fermata | minuti | totale (prima della riga) | totale (dopo la riga) |
|---|---|---|---|
| 1 | 2 | 0 | 2 |
| 2 | 9 | 2 | 11 |
| 3 | 3 | 11 | 14 |
| 4 | 7 | 14 | 21 |
| 5 | 4 | 21 | 25 |
La domanda 2A vuole la riga prima: alla fermata 3, 11. Dopo la quinta fermata premi Continue un'ultima volta, e /docs risponde.
Le trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
RISPOSTA_2A = 14 | È il valore dopo la riga gialla. VARIABLES mostra le variabili prima che la riga giri: 14 lo vedi solo se premi F10, o se guardi la fermata 4 | test_2a_il_totale_alla_terza_fermata |
RISPOSTA_2A = 2 | È il valore della seconda fermata: hai contato da 0. Le fermate si contano da 1, come le persone | test_2a_il_totale_alla_terza_fermata |
RISPOSTA_2B = 3 | Il treno è quello sbagliato: M12 ha tre segnalazioni, M14 cinque. La richiesta da fare è quella scritta nella domanda | test_2b_quante_fermate |
3 · Il ritardo che non torna
In italiano. Il test rosso dice che M12 dovrebbe avere ritardo medio 6 e risponde 4.5. Il debugger dice dove le due cose si separano: totale = 18 e n = 3 sono giusti, 18 / 3 fa 6, ma media esce 4.5. Quindi il guaio è nella riga che divide. 4.5 è 18 / 4: la riga divide per len(SEGNALAZIONI), cioè per il numero di treni che hanno una voce nel dizionario (quattro), e non per il numero di segnalazioni di questo treno (n).
n = len(segnalazioni)
if n == 0:
return {"codice": codice, "segnalazioni": 0, "ritardo_medio": 0}
# BUG: con M12 (4, 6 e 8) la media usciva 4.5: dividevo per i treni che hanno segnalazioni, 4, non per le segnalazioni di questo treno, 3.
media = totale / n
return {"codice": codice, "segnalazioni": n, "ritardo_medio": media}Passo per passo.
- Breakpoint sulla riga
media = totale / len(SEGNALAZIONI). - Pannello Testing → tasto destro su
test_ritardo_medio_di_m12→ Debug Test. - Il test chiama
GET /treni/M12/ritardo, e il debugger si ferma. Prevedi: ti aspetti6. - VARIABLES:
VARIABLES
codice = 'M12'
segnalazioni = [4, 6, 8]
totale = 18
minuti = 8
n = 3- Osserva:
18 / 3fa 6, e la riga dicetotale / len(SEGNALAZIONI). In WATCH scrivilen(SEGNALAZIONI): vale4. - Confronta: ti aspettavi di dividere per 3, il programma divide per 4. Il bug è lì.
- Sopra la riga scrivi
# BUG: …, poi cambilen(SEGNALAZIONI)inn, e rilanci tutti i test.
Nota che il test del treno senza segnalazioni (M16) era verde da subito: il suo if n == 0 risponde prima di arrivare alla riga sbagliata. È giusto così: non toccarlo.
Le trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
media = totale / 3 | Con M12 torna 6, il test passa. Ma il 3 è il numero di segnalazioni di M12: M14 ne ha 5 (25 / 3 fa 8.33) e T28 ne ha 2 (20 / 3 fa 6.67) | test_ritardo_medio_di_m14, test_ritardo_medio_di_t28 |
media = totale / n e via anche il blocco if n == 0: («tanto non serve») | M16 non ha segnalazioni, n vale 0, e totale / 0 si ferma con ZeroDivisionError: division by zero | test_un_treno_senza_segnalazioni |
media = totale / n, giusta, ma senza il commento sopra | Il codice è corretto e tutti i test del comportamento passano. Manca il commento: prima di correggere, # BUG: con quello che hai visto | test_prima_della_correzione_il_commento |
La prima è la più subdola: un numero scritto a mano fa passare il test che ti ha mandato lì, e rompe gli altri. Se ti ritrovi a scrivere un numero in una formula per far tornare un caso, fermati: il bug è altrove. Rilancia tutti i test, ogni volta.