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. 149

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.

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

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.

JSON
{
    "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.

Python
RISPOSTA_2A = 11
RISPOSTA_2B = 5

Passo per passo. Le cinque fermate della richiesta a M14, con quello che dice VARIABLES:

Fermataminutitotale (prima della riga)totale (dopo la riga)
1202
29211
331114
471421
542125

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 sbagliatoCosa succedeIl 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 4test_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 personetest_2a_il_totale_alla_terza_fermata
RISPOSTA_2B = 3Il treno è quello sbagliato: M12 ha tre segnalazioni, M14 cinque. La richiesta da fare è quella scritta nella domandatest_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).

Python
    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.

  1. Breakpoint sulla riga media = totale / len(SEGNALAZIONI).
  2. Pannello Testing → tasto destro su test_ritardo_medio_di_m12 → Debug Test.
  3. Il test chiama GET /treni/M12/ritardo, e il debugger si ferma. Prevedi: ti aspetti 6.
  4. VARIABLES:
VARIABLES
  codice = 'M12'
  segnalazioni = [4, 6, 8]
  totale = 18
  minuti = 8
  n = 3
  1. Osserva: 18 / 3 fa 6, e la riga dice totale / len(SEGNALAZIONI). In WATCH scrivi len(SEGNALAZIONI): vale 4.
  2. Confronta: ti aspettavi di dividere per 3, il programma divide per 4. Il bug è lì.
  3. Sopra la riga scrivi # BUG: …, poi cambi len(SEGNALAZIONI) in n, 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 sbagliatoCosa succedeIl test rosso
media = totale / 3Con 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 zerotest_un_treno_senza_segnalazioni
media = totale / n, giusta, ma senza il commento sopraIl codice è corretto e tutti i test del comportamento passano. Manca il commento: prima di correggere, # BUG: con quello che hai vistotest_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.