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
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
assert 3 == 3.5, e nessun Traceback | La funzione gira e risponde male. A sinistra di == c'è quello che ha restituito, a destra quello che il test voleva | Non cercare un nome di errore: non c'è. Prevedi, metti un breakpoint, Debug Test, F10 |
| Il test è verde ma il risultato del programma è sbagliato | Il test controlla un caso solo, e quel caso va bene | Aggiungi un test con un altro caso (un valore diverso, un confine). Come: Scrivere un test |
| Il debugger si ferma, ma non vedo niente di strano | Hai guardato i valori senza una previsione: tutto sembra ragionevole | Rilancia. Prima di ogni F10, scrivi cosa ti aspetti in VARIABLES. Poi confronta |
| Ho premuto F5 troppe volte e il bug è già passato | F5 corre fino al prossimo breakpoint, anche oltre il punto che cercavi | Rilancia il test. Usa F10 per procedere di una riga, F5 solo quando sai che il giro non ti serve |
| Il valore in VARIABLES è quello vecchio | La riga gialla non è ancora stata eseguita | F10: 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 chiama | F11 (fn+F11 su Mac): entri nella funzione, e guardi il CALL STACK |
| Ho trovato la riga ma non so spiegare perché è sbagliata | Hai trovato una riga vicina al bug, non il bug | Scrivi il commento # BUG: a parole tue. Se non ci riesci, torna a prevedere un passo più indietro |
| Ho corretto, ma ora un altro test è rosso | La correzione ha cambiato un comportamento che prima andava | Leggi 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 regola | Cancellala. Torna al commento: la tua riga lo spiega? Vedi l'esempio E degli esercizi spiegati |
Ora ricevo un KeyError: 'salti' con un traceback | Hai sostituito get con le quadre, ma la chiave è ancora scritta male: il refuso, che era nascosto, ora si vede | Bene: è 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
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
AssertionError: Prima di correggere, sopra la riga: un commento che comincia con BUG… | Manca il commento, anche se la funzione è già giusta | Dentro 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 rosso | Il commento è fuori dalla funzione (sopra il def, o in cima al file), oppure manca il testo dopo i due punti | Spostalo dentro la funzione. Controlla le maiuscole: # BUG:, non # bug e non #BUG |
ERROR: file or directory not found: palestra/test_pulisci_badge.py | Hai lanciato pytest da un'altra cartella | cd nella cartella dello zip, poi di nuovo pytest |
pytest: command not found | Il venv è spento | source .venv/bin/activate, dalla cartella dello zip. Vedi pytest e il venv |
No module named pytest nel pannello Testing | VS Code usa un altro Python | Python: Select Interpreter → quello con .venv. Vedi pytest e il venv |
| Il pallino rosso è grigio, o il debugger non si ferma | Il breakpoint è su una riga che non gira, o hai lanciato il file con ▶ invece del test | Tasto destro sul test → Debug Test. Il pallino va dentro la funzione, su una riga che il test chiama |
| F10 abbassa il volume | I tasti F sono del Mac | fn+F10, oppure i pulsanti della barra del debugger |
| Nel pannello Testing non vedo i test | VS Code non ha trovato pytest, o non è aperto sulla cartella dello zip | File → Open Folder sulla cartella dello zip, poi Python: Select Interpreter |
| Il piano della storia non cambia, ma i test sono verdi | Hai guardato un vecchio output, oppure hai lanciato il programma da un'altra copia dello zip | Rilancia 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 conosciute | Rileggi 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.