Vai al contenuto
code-to-code

Apro l'indice…

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

Errori e debugger7. I bug silenziosip. 172

Il sabotatore del deposito

Cinque righe toccate, nessun errore

  • 90–120 minuti di lavoro

Milano, lunedì 14 dicembre, ore 4:30. Deposito di Porta Codice.

Il programma che prepara il piano del mattino (quali treni escono, a che ora, quali vanno in officina) ha finito il suo lavoro. Nessun errore, nessun avviso. Il piano è pulito. Ernesto Pozzi, il capo deposito, lo firma come ogni mattina.

Nadia Russo, di guardia al deposito, lo guarda per sicurezza. E si ferma su una riga: T28, segnalato ieri per i freni, nel piano esce alle 5:12.

Il commissario Mapelli arriva con il caffè in mano. Guarda il foglio, poi il programma.

«Il programma non si è rotto», dice. «L'hanno rotto. Cinque righe, e nessuna dà errore. Trovatele una alla volta, e ditemi chi è stato.»

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

Lo zip è lo stesso della palestra: la storia è nella cartella storia/.

Il piano di stanotte

Questo è quello che stampa il programma così com'è, con python storia/deposito.py:

PIANO DEL MATTINO · deposito di Porta Codice
Controlli di stanotte: tutti fatti
In officina (2): M16, T34
Escono:
  05:00  M12  binario 1  controllo rinforzato
  05:12  T28  binario 2  controllo rinforzato
  05:24  M14  binario 3  controllo rinforzato
  05:36  M18  binario 4  controllo rinforzato
  05:48  M20  binario 1  controllo rinforzato
  06:00  M22  binario 2  controllo rinforzato
  06:12  M24  binario 3  controllo rinforzato
  06:24  T26  binario 4  controllo rinforzato
  06:36  T30  binario 1  controllo normale
  06:48  T32  binario 2  controllo normale
Nel deposito: 10 treni · escono 10 · in officina 2
Firmato: Ernesto Pozzi

Sembra normale. Ma Nel deposito: 10 treni non torna con i dodici treni parcheggiati. Questa è solo una delle cose che non tornano. Il programma ha dodici treni, e per ognuno decide: officina o uscita.

Le regole del deposito

RegolaDove sta nel programma
Un treno con tre segnalazioni dei freni o più resta in officinatroppe_segnalazioni
Un treno con 9000 km o più dall'ultima revisione va in revisione (i km nel registro sono testo: "9300")troppi_km
I treni non controllati stanotte si segnalano in cima al pianonon_controllati
Escono tutti i treni che non sono in officina, nell'ordine dei binaritreni_che_escono
Il controllo a bordo dipende dall'ora: prima delle 6:00 doppio, fino alle 6:36 rinforzato, dopo normalecontrollo_a_bordo

I treni escono uno ogni 12 minuti, dalle 5:00.

I file

FileCosa c'èSi tocca?
dati_deposito.pyI dodici treni di stanotte: km (come testo), segnalazioni dei freni, controllo fattoNo, si legge
deposito.pyIl programma del piano. Cinque funzioni sono state toccate, una per livello. In fondo, il pianoSì, solo questo
test_deposito.pyI test. Usano treni di prova, non quelli di stanotte: nessun test ti dice dove sta il sabotatoreNo
modifiche.txtIl registro delle modifiche a deposito.py: chi, quando, quale funzione, quale rigaNo, si legge alla fine
verifica.pyIl commissario controlla il nome che gli daiNo

Un treno, in dati_deposito.py, è un dizionario:

Python
{"codice": "T28", "km": "5200", "segnalazioni": 3, "controllato": False}

Come si gioca

Un livello alla volta, sempre così:

  1. Prevedi il piano. Leggi il livello e scrivi, su un foglio, cosa cambierà nel piano quando la funzione sarà giusta (quale riga, quale numero). Poi python storia/deposito.py e tieni il foglio.
  2. pytest storia -v -k livello_1 (poi livello_2, …). Il test è rosso, senza traceback: leggi la differenza.
  3. Un breakpoint nella funzione, Debug Test sul test rosso, F10 un passo alla volta. Prevedi, osserva, confronta.
  4. Sopra la riga sbagliata, # BUG: cosa ho visto, e perché è sbagliato. Poi correggi il minimo.
  5. Rilancia i test del livello (compreso quello del commento) e di nuovo python storia/deposito.py. Il piano è cambiato come avevi previsto? Se no, hai imparato una cosa su un bug o sul tuo modo di prevedere.

Livello 1 · La segnalazione di T28

«T28 ha tre segnalazioni dei freni. Doveva restare in officina.»

troppe_segnalazioni(treno): vero se il treno ha tre segnalazioni o più.

La cosa nuova: il confine. Il test lo prova sul valore esatto (tre), sotto (due) e sopra (cinque): un confine si controlla sul confine.

Prevedi. Quando la funzione è giusta, T28 sparisce dai treni che escono. Cosa succede agli orari di chi viene dopo?

Aiutino 1
Il test rosso è quello del «tre segnalazioni». Debug Test su quello, breakpoint sulla return, e in WATCH scrivi l'espressione della riga.
Aiutino 2
Il valore vale 3, e la regola dice «tre o più». Leggi la riga ad alta voce: «segnalazioni maggiore di 3». Il 3 è compreso?

Livello 2 · I chilometri

«M20 ha 11500 km dall'ultima revisione. Perché esce?»

troppi_km(treno): vero se il treno ha 9000 km o più.

La cosa nuova: due numeri che sono testo. I km del registro arrivano come stringhe, e Python confronta le stringhe in un altro modo.

Prevedi. Quali treni, oltre a M20, dovrebbero finire in officina per i km? Guarda dati_deposito.py.

Aiutino 1
In WATCH scrivi l'espressione della riga con i km di M20: treno['km'] >= '9000'. Cosa risponde? Era quello che prevedevi?
Aiutino 2
Confronta "11500" con "9000" come farebbe un dizionario di parole: si guarda la prima lettera. Quale viene prima, 1 o 9?
Aiutino 3
I numeri si confrontano bene solo quando sono numeri. int("11500") trasforma il testo in numero. Il confine resta 9000, e ora è un numero.

Livello 3 · I controlli

«Il piano dice che i controlli sono tutti fatti. Nadia dice che T28 non l'ha controllato nessuno.»

non_controllati(treni): i codici dei treni senza il controllo di stanotte, nell'ordine della lista. Se sono tutti controllati, la lista è vuota.

La cosa nuova: un return che finisce nel posto sbagliato. Il debugger ti fa contare i giri del ciclo: quanti sono? Lo spiega Le funzioni.

Prevedi. Con i treni di stanotte, quanti giri deve fare il ciclo? E quanti ne fa?

Aiutino 1
Metti un breakpoint dentro il for e premi F5. Quante fermate hai? Prevedevi dodici.
Aiutino 2
Il programma si ferma al primo treno. Guarda con quale rientro è scritta la riga return: è allineata al for o al suo interno?

Livello 4 · Chi esce

«Il piano dice dieci treni nel deposito. Ne abbiamo dodici.»

treni_che_escono(treni, in_officina): i treni che escono, cioè tutti tranne quelli in officina, nell'ordine della lista. La lista treni che ricevi non va cambiata: serve ancora dopo, per contare.

La cosa nuova: due nomi per la stessa lista. Si disegna come in Etichette e scatole: un'etichetta in più sulla stessa scatola.

Prevedi. Dopo la funzione, quanti treni ha la lista treni? E quale riga del piano ti dice se hai ragione?

Aiutino 1
In WATCH scrivi len(treni) e premi F10 un passo alla volta nella funzione. Cambia? Prima di tutto, perché non lo hai toccato tu?
Aiutino 2
In WATCH scrivi escono is treni: is chiede se sono la stessa scatola. Cosa risponde? E la prima riga della funzione?
Aiutino 3
list(treni) fa una scatola nuova con gli stessi treni dentro: una copia.

Livello 5 · Il controllo a bordo

«Prima delle sei il controllo a bordo è doppio. Nel piano è tutto rinforzato.»

controllo_a_bordo(minuti_uscita): «doppio» prima delle 6:00 (360), «rinforzato» prima delle 6:36 (396), «normale» dopo.

La cosa nuova: due if di fila, quando serviva una catena. Il debugger ti mostra la variabile controllo che cambia nome nella stessa chiamata.

Prevedi. Con i treni che escono, quanti dovrebbero avere il controllo doppio? E quanti ne ha adesso?

Aiutino 1
Fai Debug Test sul test «prima delle sei» e premi F10 passo dopo passo. Guarda controllo dopo ogni riga: quante volte cambia?
Aiutino 2
Quando l'ora è 300, entrambe le condizioni sono vere: 300 è minore di 360 e anche di 396. Il secondo if non sa che il primo c'è già stato.

Il finale

Il piano è a posto, la verità no. Cinque righe sono state cambiate a mano, da qualcuno. modifiche.txt è il registro delle modifiche a deposito.py: una riga per ogni modifica, con la data, la persona, la funzione e il testo della riga com'è diventata.

data  ora   | chi               | funzione     | la riga, come è diventata   | messaggio

Una persona sola compare nel registro per tutte e cinque le funzioni che hai corretto. Chi ha toccato più righe in tutto non è per forza lei. Chi ha toccato una riga sola, nemmeno.

  • Per ognuna delle cinque funzioni che hai corretto, cerca in modifiche.txt le righe che la nominano: chi compare?
  • Quali nomi compaiono in tutte e cinque?
  • Ernesto Pozzi firma il piano: è per questo che l'ha scritto?

Quando hai un nome:

Terminale
python storia/verifica.py "Nome Cognome"

Se è sbagliato, per le piste più probabili il commissario ti dice dove hai preso la strada sbagliata.