Vai al contenuto
code-to-code

Apro l'indice…

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

Errori e debugger7. I bug silenziosip. 189

I bug silenziosi, se qualcosa va storto

Test rossi, commenti che non bastano, correzioni che non tengono

In questo capitolo il guaio più comune è il contrario degli altri: niente da leggere. Qui sotto, prima le cose che ti capitano mentre cerchi un bug, poi quelle dello zip. Per ognuna: cosa leggi, cosa vuol dire, cosa fai.

Il metodo, se ti serve ripassarlo: la teoria del capitolo. Prevedi, osserva, confronta; il commento prima della correzione; tutti i test alla fine.

Cercare il bug

LeggiVuol direCosa fai
assert 3 == 3.5, e nessun TracebackLa funzione gira e risponde male. A sinistra di == c'è quello che ha restituito, a destra quello che il test volevaNon cercare un nome di errore: non c'è. Prevedi, metti un breakpoint, Debug Test, F10
Il test è verde ma il risultato del programma è sbagliatoIl test controlla un caso solo, e quel caso va beneAggiungi un test con un altro caso (un valore diverso, un confine). Come: Scrivere un test
Il debugger si ferma, ma non vedo niente di stranoHai guardato i valori senza una previsione: tutto sembra ragionevoleRilancia. Prima di ogni F10, scrivi cosa ti aspetti in VARIABLES. Poi confronta
Ho premuto F5 troppe volte e il bug è già passatoF5 corre fino al prossimo breakpoint, anche oltre il punto che cercaviRilancia il test. Usa F10 per procedere di una riga, F5 solo quando sai che il giro non ti serve
Il valore in VARIABLES è quello vecchioLa riga gialla non è ancora stata eseguitaF10: la riga gira, poi guardi. Vedi anche Il debugger
La riga sembra giusta, ma il valore dopo non lo èIl bug sta in una funzione che quella riga chiamaF11 (fn+F11 su Mac): entri nella funzione, e guardi il CALL STACK
Ho trovato la riga ma non so spiegare perché è sbagliataHai trovato una riga vicina al bug, non il bugScrivi il commento # BUG: a parole tue. Se non ci riesci, torna a prevedere un passo più indietro
Ho corretto, ma ora un altro test è rossoLa correzione ha cambiato un comportamento che prima andavaLeggi il nuovo test rosso: cosa si aspettava? Annulla la correzione e cerca quella minima. Rilancia sempre tutti i test
Il test rosso è passato, ma ho scritto un if con un valore del testÈ una correzione che fa il furbo: riconosce il caso, non cambia la regolaCancellala. Torna al commento: la tua riga lo spiega? Vedi l'esempio E degli esercizi spiegati
Ora ricevo un KeyError: 'salti' con un tracebackHai sostituito get con le quadre, ma la chiave è ancora scritta male: il refuso, che era nascosto, ora si vedeBene: è il punto. Leggi il traceback dal basso e correggi la chiave

Il caso dell'ultima riga, con il traceback che compare davvero:

F
============================================= FAILURES =============================================
_____________________________________ test_la_somma_dei_saliti _____________________________________
palestra/test_passeggeri_del_giorno.py:16: in test_la_somma_dei_saliti
    assert passeggeri_del_giorno(GIRI) == 295
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^
palestra/passeggeri_del_giorno.py:28: in passeggeri_del_giorno
    totale = totale + giro["salti"]
                      ^^^^^^^^^^^^^
E   KeyError: 'salti'

L'ultima riga dice cosa, la riga con i ^^^ dice quale pezzo: la chiave "salti". Un bug silenzioso diventato un errore con un nome.

Gli errori dello zip

LeggiVuol direCosa fai
AssertionError: Prima di correggere, sopra la riga: un commento che comincia con BUG…Manca il commento, anche se la funzione è già giustaDentro la funzione, sopra la riga sbagliata: # BUG: cosa ho visto, e perché è sbagliato. Il test cerca # BUG: con il cancelletto, lo spazio e un testo dopo i due punti
Ho scritto il commento ma il test è ancora rossoIl commento è fuori dalla funzione (sopra il def, o in cima al file), oppure manca il testo dopo i due puntiSpostalo dentro la funzione. Controlla le maiuscole: # BUG:, non # bug e non #BUG
ERROR: file or directory not found: palestra/test_pulisci_badge.pyHai lanciato pytest da un'altra cartellacd nella cartella dello zip, poi di nuovo pytest
pytest: command not foundIl venv è spentosource .venv/bin/activate, dalla cartella dello zip. Vedi pytest e il venv
No module named pytest nel pannello TestingVS Code usa un altro PythonPython: Select Interpreter → quello con .venv. Vedi pytest e il venv
Il pallino rosso è grigio, o il debugger non si fermaIl breakpoint è su una riga che non gira, o hai lanciato il file con ▶ invece del testTasto destro sul test → Debug Test. Il pallino va dentro la funzione, su una riga che il test chiama
F10 abbassa il volumeI tasti F sono del Macfn+F10, oppure i pulsanti della barra del debugger
Nel pannello Testing non vedo i testVS Code non ha trovato pytest, o non è aperto sulla cartella dello zipFile → Open Folder sulla cartella dello zip, poi Python: Select Interpreter
Il piano della storia non cambia, ma i test sono verdiHai guardato un vecchio output, oppure hai lanciato il programma da un'altra copia dello zipRilancia python storia/deposito.py dalla cartella dello zip e confronta con la tua previsione
La storia dice «Ripassa il quaderno»Il nome che hai dato non è una delle piste conosciuteRileggi il finale: cerca chi compare nel registro per tutte e cinque le funzioni che hai corretto. Per cercare in modifiche.txt, il comando grep "troppi_km" storia/modifiche.txt mostra le righe che nominano quella funzione

Se il problema non è il codice ma l'ambiente (il venv, l'interprete, il pannello Testing vuoto), non è un bug silenzioso: è il caso più comune in assoluto, e ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente. Per il debugger che non si ferma o il pallino grigio, guarda anche l'indice del Pronto soccorso.