Gli errori per nome
Nove nomi che dicono già metà del guaio
- 10 minuti di lettura
Nell'ultima riga di un traceback c'è sempre un nome: KeyError, TypeError, NameError. Come si legge il resto lo hai visto in Leggere un traceback. Qui impari a riconoscere il nome: ti dice a che famiglia appartiene il guaio, prima ancora di guardare la riga.
Sono nove. Con questi nove risolvi quasi tutto quello che ti capita all'inizio.
Il disegno: prima di partire, a metà strada
Gli errori arrivano in due momenti diversi, e il momento è già un indizio.
PRIMA DI PARTIRE A METÀ STRADA
Python legge tutto il file Python esegue una riga alla volta
e non capisce come è scritto e a una riga non può andare avanti
SyntaxError NameError TypeError
IndentationError KeyError IndexError
AttributeError ValueError
→ nemmeno la prima riga gira ZeroDivisionError
→ le righe prima sono già state
eseguite: i loro print si vedonoProva con due programmi quasi uguali. Nel primo manca un segno, nel secondo una variabile.
print("Controllo i ritardi")
ritardo = 7
if ritardo > 5
print("Avvisa la centrale") File "/home/lucia/linea-menta/sintassi.py", line 3
if ritardo > 5
^
SyntaxError: expected ':'La scritta «Controllo i ritardi» non compare: Python ha letto tutto il file, ha visto che la riga 3 era scritta male e non ha cominciato nemmeno Nota anche che non c'è la parola Traceback: il SyntaxError ha un'altra forma, la ^ indica dove Python si è perso.
print("Controllo i ritardi")
ritardi = [3, 7, 2]
print(ritardo)Controllo i ritardi
Traceback (most recent call last):
File "/home/lucia/linea-menta/nome.py", line 3, in <module>
print(ritardo)
^^^^^^^
NameError: name 'ritardo' is not defined. Did you mean: 'ritardi'?Qui la prima riga gira: «Controllo i ritardi» è stampato, poi il programma si ferma alla riga 3.
I nove nomi
| Nome | Vuol dire | Il caso più piccolo | Dove guardi |
|---|---|---|---|
SyntaxError | Python non capisce come è scritta la riga | un : che manca, una parentesi aperta e mai chiusa | la ^, e la riga sopra |
IndentationError | Il rientro è sbagliato: è un SyntaxError con un nome più preciso | il print sotto un if senza rientro | la riga indicata |
NameError | Hai usato un nome che non esiste (ancora) | Treno al posto di treno | il nome tra apici, e il suggerimento |
TypeError | Il tipo di un valore non va bene per quell'operazione | "Ritardo: " + 4, o int(None) | i ^^^ e il tipo nominato |
ValueError | Il tipo va bene, ma il contenuto no | int("12a") | il valore tra apici |
KeyError | La chiave non è nel dizionario | binari["M18"] | la chiave, tra apici nell'ultima riga |
IndexError | La posizione non esiste nella lista | fermate[0] su una lista vuota | l'indice e quanto è lunga la lista |
AttributeError | L'oggetto non ha quel metodo o quell'attributo | "M12".append("!") | il tipo dell'oggetto e il nome dopo il punto |
ZeroDivisionError | Hai diviso per zero | totale / len(corse) con corse vuota | il denominatore: da dove arriva lo zero? |
Ogni nome ha la sua voce nel Prontuario degli errori: qui c'è il ragionamento, lì la scheda da tenere aperta.
SyntaxError e IndentationError
IndentationError è un SyntaxError più preciso: Python sa che il guaio è il rientro e te lo dice con il suo nome. Per questo, se ti chiedono «come si chiama l'errore?», rispondi con il nome scritto nell'ultima riga, quello più preciso.
print("Controllo i ritardi")
ritardo = 7
if ritardo > 5:
print("Avvisa la centrale") File "/home/lucia/linea-menta/rientro.py", line 4
print("Avvisa la centrale")
^^^^^
IndentationError: expected an indented block after 'if' statement on line 3Dopo i due punti di un if (o di un for, o di una def) la riga successiva deve essere spostata a destra. Python te lo dice anche con parole: «mi aspettavo un blocco rientrato dopo l'if della riga 3».
NameError
Il nome che hai scritto non esiste. Le cause sono tre, in ordine di frequenza: l'hai scritto diverso da come l'hai creato (Treno e treno per Python sono due nomi), non l'hai ancora creato, oppure l'hai creato dentro una funzione e lo cerchi fuori.
def somma_ritardi(ritardi):
totale = 0
for ritardo in ritardi:
totale = totale + ritardo
return totale
print(somma_ritardi([3, 7, 2]))
print(totale)12
Traceback (most recent call last):
File "/home/lucia/linea-menta/funzione.py", line 8, in <module>
print(totale)
^^^^^^
NameError: name 'totale' is not definedtotale esiste solo dentro la funzione, e solo finché gira. Fuori, il valore arriva con il return: risultato = somma_ritardi(...). Più sull'argomento in Le funzioni.
Quando il nome somiglia a uno che esiste, Python aggiunge Did you mean, come nell'esempio in alto: ha trovato ritardi vicino a ritardo. Il suggerimento è quasi sempre giusto: leggilo.
TypeError e ValueError
Le due coppie più confuse. La differenza sta in una domanda: è il tipo, o è il contenuto?
print("Leggo il ritardo")
ritardo = None
minuti = int(ritardo)Leggo il ritardo
Traceback (most recent call last):
File "/home/lucia/linea-menta/tipo.py", line 3, in <module>
minuti = int(ritardo)
^^^^^^^^^^^^
TypeError: int() argument must be a string, a bytes-like object or a real number, not 'NoneType'int() sa trasformare un testo o un numero. None non è né l'uno né l'altro: è il tipo che non va. Stessa funzione, adesso con un testo:
print("Leggo il ritardo")
ritardo = "12a"
minuti = int(ritardo)Leggo il ritardo
Traceback (most recent call last):
File "/home/lucia/linea-menta/valore.py", line 3, in <module>
minuti = int(ritardo)
^^^^^^^^^^^^
ValueError: invalid literal for int() with base 10: '12a'Un testo va benissimo per int(), ma "12a" non è un numero: è il contenuto che non va. L'altro TypeError che incontrerai di continuo è la somma di tipi diversi: "Ritardo: " + 4 (un testo più un numero).
KeyError e IndexError
Le due «cose che non ci sono». La prima si cerca per nome, la seconda per posizione.
print("Cerco il binario")
binari = {"M12": 1, "M14": 2}
print(binari["M18"])Cerco il binario
Traceback (most recent call last):
File "/home/lucia/linea-menta/chiave.py", line 3, in <module>
print(binari["M18"])
~~~~~~^^^^^^^
KeyError: 'M18'Il disegno. Il dizionario in cui M18 non c'è:
L'ultima riga ti restituisce la chiave che hai cercato: 'M18', con gli apici. Se è '1' con gli apici e tu pensavi a un numero, hai una chiave testo contro chiavi numero.
print("Cerco la prima fermata")
fermate = []
print(fermate[0])Cerco la prima fermata
Traceback (most recent call last):
File "/home/lucia/linea-menta/indice.py", line 3, in <module>
print(fermate[0])
~~~~~~~^^^
IndexError: list index out of rangeIn una lista di tre elementi le posizioni sono 0, 1, 2: la 3 non esiste. IndexError non ti dice quale indice: lo leggi nei ^^^ e nella riga di codice. Per i dizionari e le liste: I dizionari e Le liste e i cicli.
AttributeError
Hai scritto un punto e dopo un nome che quell'oggetto non ha. Il messaggio dice di che tipo è l'oggetto, ed è la parte che conta.
fermate = ["Porta Codice", "Via Variabile"]
fermate.apend("Largo Lista")Traceback (most recent call last):
File "/home/lucia/linea-menta/apend.py", line 2, in <module>
fermate.apend("Largo Lista")
^^^^^^^^^^^^^
AttributeError: 'list' object has no attribute 'apend'. Did you mean: 'append'?Anche qui c'è il Did you mean. Ma il caso da riconoscere subito è un altro:
def capolinea_di(treno):
capolinea = {"M12": "Vecchia Fiera", "M14": "Ponte Ciclo"}
return capolinea.get(treno)
nome = capolinea_di("M16")
print(nome.upper())Traceback (most recent call last):
File "/home/lucia/linea-menta/nessuno.py", line 6, in <module>
print(nome.upper())
^^^^^^^^^^
AttributeError: 'NoneType' object has no attribute 'upper''NoneType' object has no attribute … vuol dire: quella cosa era None. get non ha trovato la chiave e ha risposto None, poi tu hai usato .upper() come se avesse trovato qualcosa. Il bug non è nella riga che si rompe, ma in quella dove None è nato. Lo rivedrai identico quando scriverai le API.
ZeroDivisionError
Il più facile: hai diviso per zero. La domanda utile è da dove arriva lo zero.
print("Calcolo la media")
ritardi = []
media = sum(ritardi) / len(ritardi)
print(media)Calcolo la media
Traceback (most recent call last):
File "/home/lucia/linea-menta/zero.py", line 3, in <module>
media = sum(ritardi) / len(ritardi)
~~~~~~~~~~~~~^~~~~~~~~~~~~~
ZeroDivisionError: division by zeroIl ^ sta sull'operatore, la divisione. A destra c'è len(ritardi), che con una lista vuota fa zero. La riga è scritta bene: è la lista a essere vuota.
Le coppie da non confondere
| Se leggi | e non | La differenza |
|---|---|---|
TypeError | ValueError | Tipo sbagliato (int(None)) contro contenuto sbagliato (int("12a")) |
KeyError | IndexError | Cerchi per nome in un dizionario, contro per posizione in una lista |
NameError | AttributeError | Il nome da solo (Treno) contro il nome dopo un punto (fermate.apend) |
SyntaxError | IndentationError | Il nome generico contro quello più preciso: vale quello scritto in fondo |
Una cosa sola da portarti: il nome non ti dice cosa fare. Ti dice dove guardare. Se l'errore è un tuo sbaglio o una situazione che può capitare davvero, lo decidi nel capitolo Correggere o gestire.
Ricorda
- Il nome è l'inizio dell'ultima riga del traceback.
SyntaxErroreIndentationError: il programma non parte, nemmeno la prima riga gira. Tutti gli altri: parte, e si ferma a metà.IndentationErrorè unSyntaxErrorpiù preciso: rispondi con il nome scritto in fondo.TypeError: il tipo non va.ValueError: il tipo va, il contenuto no.KeyError: manca la chiave.IndexError: manca la posizione.NameError: nome da solo.AttributeError: nome dopo un punto, eNoneTypevuol dire che eraNone.Did you meanquasi sempre ha ragione.