try, except, raise, se qualcosa va storto
Gli errori di chi gestisce gli errori
Il capitolo più difficile del libro ha un'ironia: gli errori nuovi li fai proprio mentre impari a gestire gli errori. Per ognuno: cosa leggi, cosa vuol dire, cosa fai. Si legge sempre dal basso, come in Leggere un traceback.
Gli errori del capitolo
Prima quelli che danno un messaggio.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
SyntaxError: expected ':' sulla riga dell'except | Hai scritto except ValueError senza i due punti | Aggiungi : in fondo alla riga. Vale anche per try e per else |
SyntaxError: expected 'except' or 'finally' block | C'è un try, ma sotto non c'è nessun except | Ogni try vuole il suo except. Controlla che l'except sia allineato al try |
IndentationError: expected an indented block after 'except' statement | Sotto l'except non c'è niente di rientrato | Dentro l'except scrivi almeno una riga (un continue, un print, un return), rientrata di quattro spazi |
NameError: name 'sys' is not defined dentro l'except | Scrivi file=sys.stderr ma in cima al file manca import sys | import sys in cima. Vedrai anche During handling of the above exception: non è un secondo guaio, è la storia di come ci sei arrivato. Vale l'ultimo errore |
ValueError: too many values to unpack (expected 2) | Una riga ha più pezzi di quelli che hai previsto (a;b;c spezzata in due nomi) | È un guaio di dati: metti la riga con lo split dentro il try, e salta la riga rotta |
TypeError: int() argument must be a string, a bytes-like object or a real number, not 'NoneType' | Alla funzione è arrivato None: nessuno ha dato il valore. Non è un testo scritto male, è un valore perso | Non gestirlo con except TypeError. Risali: chi doveva mandare un testo e ha mandato None? Il debugger è fatto per questo |
ValueError: list.remove(x): x not in list, o … is not in list | Un remove o un index non ha trovato l'elemento. Se il try lo conteneva insieme a un int, ti sei preso un messaggio sbagliato; se era fuori, l'errore è finalmente visibile | Se l'elemento può mancare davvero, un if x in lista: prima. Se non può, hai un bug da correggere: controlla da dove arriva quel valore |
Failed: DID NOT RAISE ValueError | Il test si aspettava un errore e la funzione non l'ha alzato | Manca il raise (c'è un print o un return?), oppure la condizione dell'if non scatta con quel valore |
AssertionError: Regex pattern did not match. con Expected regex e Actual message | L'errore c'è, ma il messaggio non contiene il testo che il test cerca | Confronta le due righe: manca il valore dentro il messaggio? Un apostrofo diverso? Il messaggio deve contenere il testo del test, parola per parola |
Failed: Doveva fermarsi con un errore, ha restituito None | Hai scritto return None (o niente) dove la funzione doveva fermarsi | raise ValueError(…): un errore non è un valore |
Gli errori che non danno errori
Sono i più insidiosi di questo capitolo: il programma gira, nessun traceback, e il risultato è sbagliato. Cinque forme.
Un bug nascosto da un except: da solo. ritardo("12") risponde 0 perché nel try c'è un refuso (testi al posto di testo) e il NameError è stato mangiato. Per trovarlo: togli l'except (o mettici il nome preciso) e rilancia. Il traceback compare subito. Esempio A degli esercizi spiegati.
Una riga rotta che conta come quella prima. Nel ciclo hai un try e un except con solo un print, senza continue: dopo l'except il codice va avanti, e usa il valore dell'ultima riga buona.
for testo in ["5", "boh"]:
try:
minuti = int(testo)
except ValueError:
print("riga rotta")
print(minuti)5
riga rotta
5Il secondo 5 è quello del giro prima, e viene contato due volte. Se la riga rotta è la prima, invece, esce un UnboundLocalError (o un NameError, fuori da una funzione): meno insidioso, perché almeno si vede. La cura è sempre continue nell'except.
Un try intorno a tutto il ciclo. Il programma non dà errori, ma il risultato ha meno righe del previsto. Cura: sposta il try dentro il ciclo, intorno alla riga che può fallire.
Un avviso che non compare. Il programma scarta le righe rotte, ma non vedi niente. Controlla due cose: print(…, file=sys.stderr) c'è davvero? E hai lanciato il programma con 2> (che porta stderr in un file)? Gli avvisi sono lì, in avvisi.txt.
Un avviso che sporca il risultato. È il contrario: gli avvisi compaiono dentro il file dei risultati. Vuol dire che nel print manca file=sys.stderr: è finito su stdout.
Gli errori dello zip
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
No module named 'ritardo_dal_tablet' | Hai lanciato pytest da una cartella che non è quella dello zip | cd nella cartella dello zip (quella con palestra e storia), poi di nuovo pytest |
assert None == 12 | La funzione restituisce None: c'è ancora pass, manca il return, oppure hai messo un print al posto del return | return consegna il valore, print lo mostra soltanto |
Failed: DID NOT RAISE ValueError in un test che si aspetta un errore | Vedi sopra | Alza l'errore con raise |
Un test rosso nell'esercizio 6 che parla di durata_passaggio | Hai modificato durata_passaggio: doveva restare com'era | Riprendila dallo zip. L'errore si gestisce in sosta_totale, non lì |
Nella storia, il quaderno si ferma con un ValueError e un traceback | leggi_registro non sta usando il try: alla prima riga rotta si ferma | Livello 3: il try va dentro il ciclo, intorno a leggi_timbratura |
Nella storia, il quaderno stampa None per un livello | Quel livello è ancora pass | Scrivi la funzione: None vuol dire «da scrivere» |
| Nella storia, centinaia di righe di avvisi sporcano il quaderno | È giusto: sono su stderr | python storia/tornelli.py 2> scarti.txt |
Se il problema non è il codice
pytest: command not found, No module named pytest, il pannello Testing vuoto: non è il tuo codice, è l'ambiente. Ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente.
Per capire quale errore scegliere dalla lista dei nomi: Gli errori per nome. Per capire se un errore va corretto o gestito: Correggere o gestire. Il prontuario ha una voce per ogni errore: Gli errori.