Vai al contenuto
code-to-code

Apro l'indice…

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

Errori e debugger7. I bug silenziosip. 168

I bug silenziosi, la palestra

Cinque funzioni che sembrano giuste, e un test rosso

  • 60–90 minuti di lavoro

Cinque esercizi, dal ★ al ★★★, in centrale e al deposito della Linea Menta. In ogni file c'è una funzione già scritta, che sembra giusta e non dà errori. Il suo test è rosso e non ha un traceback. Il bug lo trovi tu.

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-bug-silenziosi.zip18 KB

Nello stesso zip c'è anche la storia del capitolo, Il sabotatore del deposito: la trovi nella pagina dopo.

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 passi, quelli della teoria:

  1. pytest palestra/test_<nome>.py -v. Leggi il test rosso: a sinistra di == c'è quello che la funzione ha restituito.
  2. Prevedi. Con carta e penna: sui dati del test, cosa dovrebbe fare la funzione, riga per riga.
  3. Osserva. Un breakpoint dentro la funzione, tasto destro sul test rosso → Debug Test, F10 (fn+F10 su Mac) un passo alla volta, VARIABLES.
  4. Confronta. Dove quello che vedi si separa dalla previsione, c'è il bug.
  5. Il commento. Sopra la riga sbagliata: # BUG: cosa ho visto, e perché è sbagliato.
  6. Correggi il minimo, poi rilancia tutti i test del file.

Ogni file ha due tipi di test: quelli del comportamento, e uno che controlla che il commento # BUG: ci sia. Finché non lo scrivi, quel test resta rosso anche se la funzione è già giusta.

Gli aiutini sono in ordine, dal più leggero. Prima prova per un quarto d'ora da solo.

#EsercizioCosa faiDifficoltà
1I ritardi registratiUn elenco che perde dei treni★
2Il badge sporcoUna pulizia che non pulisce★
3Chi entra in officinaEntra chi non dovrebbe★★
4I passeggeri del giornoUn totale che esce zero★★
5Il treno più in ritardoUn codice vero, ma di un altro treno★★★

1 · I ritardi registrati ★

palestra/treni_registrati.py

Il programma di fine giornata elenca i treni di cui è stato registrato il ritardo. Un treno puntuale ha ritardo 0: è registrato. Un treno senza dato ha ritardo None: non è registrato.

Python
treni_registrati({"M12": 0, "M14": 5, "M16": None})   # ["M12", "M14"]

Come provi: pytest palestra/test_treni_registrati.py -v

Aiutino 1
Prevedi su carta cosa deve uscire per il test rosso, poi guarda cosa esce. Quale treno manca? Che ritardo ha?
Aiutino 2
Un breakpoint sulla riga dell'if, F5 a ogni giro. Per l'if, quali valori contano come «falso»? Il capitolo Le condizioni ne ha l'elenco, nella sezione su vero e falso.

2 · Il badge sporco ★

palestra/pulisci_badge.py

I badge arrivano dal tornello di Largo Lista come li scrive il personale: con spazi in più, a volte in minuscolo. La funzione li deve riportare alla forma del registro: senza spazi intorno, tutto maiuscolo.

Python
pulisci_badge("  b-07 ")   # "B-07"
pulisci_badge("B-03")      # "B-03"

Come provi: pytest palestra/test_pulisci_badge.py -v

Aiutino 1
Il test rosso mostra gli spazi: guarda bene il messaggio, con repr o in VARIABLES. Gli spazi sono ancora lì quando arriva la return?
Aiutino 2
Prevedi cosa vale testo dopo la riga con strip(), poi premi F10 e guarda. Un metodo delle stringhe cambia la stringa, o ne restituisce una nuova? Lo trovi in Le stringhe.

3 · Chi entra in officina ★★

palestra/ammessi_in_officina.py

Nell'officina del deposito di Porta Codice, piena di treni smontati, entra solo il personale in servizio e del reparto officina. L'elenco del mattino non dà errori, ma qualcuno entra che non dovrebbe.

Python
ammessi_in_officina([
    {"nome": "Ivo", "attivo": True, "reparto": "officina"},
    {"nome": "Sergio", "attivo": True, "reparto": "macchinisti"},
])   # ["Ivo"]

Come provi: pytest palestra/test_ammessi_in_officina.py -v

Aiutino 1
Quale dei test rossi ha una persona sola? Debug Test su quello: il debugger si ferma una volta sola e hai il tempo di guardare.
Aiutino 2
Prevedi se Sergio entra. Poi F10 sull'if e guarda cosa fa il programma: lo mette nella lista o no?
Aiutino 3
Leggi la condizione ad alta voce, come una frase. Poi leggi la storia qui sopra, in grassetto. Sono la stessa frase? Gli operatori and e or sono in Le condizioni.

4 · I passeggeri del giorno ★★

palestra/passeggeri_del_giorno.py

A fine giornata la centrale somma i passeggeri saliti in ogni giro. Il totale di oggi esce 0, ed è impossibile.

Python
passeggeri_del_giorno([
    {"treno": "M12", "saliti": 120, "scesi": 95},
    {"treno": "M14", "saliti": 80, "scesi": 100},
])   # 200

Un dettaglio della consegna: un giro senza il dato dei saliti non vale zero. Il programma deve fermarsi con un KeyError, così qualcuno se ne accorge. Il quarto test lo controlla.

Come provi: pytest palestra/test_passeggeri_del_giorno.py -v

Aiutino 1
Breakpoint sulla riga che aggiorna il totale. In VARIABLES, giro ha i numeri giusti. Prevedi cosa aggiunge la riga: aggiunge davvero quel numero?
Aiutino 2
Confronta, lettera per lettera, la chiave che usa la riga con le chiavi che vedi in giro nel pannello VARIABLES.
Aiutino 3
Una volta sistemata la chiave, il test che vuole il KeyError ti dice se la lettura è quella giusta. Quale lettura di un dizionario si ferma quando la chiave manca, e quale invece risponde con un ripiego? Lo trovi in I dizionari.

5 · Il treno più in ritardo ★★★

palestra/treno_piu_in_ritardo.py

Ogni sera la centrale cerca il treno con più minuti di ritardo, per mandarlo per primo a controllo. Il programma risponde sempre con un codice di treno vero. Ma a volte non è quello giusto.

Python
treno_piu_in_ritardo([("M12", 4), ("M14", 11), ("T28", 2)])   # "M14"

A parità di ritardo vince il treno che viene prima nell'elenco. La lista ha almeno un treno.

Come provi: pytest palestra/test_treno_piu_in_ritardo.py -v

Attenzione: uno dei test è verde anche con il bug. Chiediti perché, prima di fidarti.

Aiutino 1
Un breakpoint sulla riga dell'if e uno sulla return. Prima di ogni F5 scrivi cosa ti aspetti in massimo e in codice. Il debugger ti dice tutto quello che serve.
Aiutino 2
Quando la funzione arriva alla return, cosa c'è in codice? Da dove viene quel valore: da quale giro? Guarda anche il test verde: in quale posizione sta il treno vincente?
Aiutino 3
codice cambia a ogni giro. Il programma ha bisogno di ricordare il codice solo del giro in cui massimo cambia. Una variabile in più, e la return la usa. Se ti serve ripassare come funziona il for: Liste e cicli.