Vai al contenuto
code-to-code

Apro l'indice…

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

Errori e debugger2. Gli errori per nomep. 26

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 vedono

Prova con due programmi quasi uguali. Nel primo manca un segno, nel secondo una variabile.

Python
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.

Python
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

NomeVuol direIl caso più piccoloDove guardi
SyntaxErrorPython non capisce come è scritta la rigaun : che manca, una parentesi aperta e mai chiusala ^, e la riga sopra
IndentationErrorIl rientro è sbagliato: è un SyntaxError con un nome più precisoil print sotto un if senza rientrola riga indicata
NameErrorHai usato un nome che non esiste (ancora)Treno al posto di trenoil nome tra apici, e il suggerimento
TypeErrorIl tipo di un valore non va bene per quell'operazione"Ritardo: " + 4, o int(None)i ^^^ e il tipo nominato
ValueErrorIl tipo va bene, ma il contenuto noint("12a")il valore tra apici
KeyErrorLa chiave non è nel dizionariobinari["M18"]la chiave, tra apici nell'ultima riga
IndexErrorLa posizione non esiste nella listafermate[0] su una lista vuotal'indice e quanto è lunga la lista
AttributeErrorL'oggetto non ha quel metodo o quell'attributo"M12".append("!")il tipo dell'oggetto e il nome dopo il punto
ZeroDivisionErrorHai diviso per zerototale / len(corse) con corse vuotail 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.

Python
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 3

Dopo 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.

Python
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 defined

totale 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?

Python
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:

Python
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.

Python
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'è:

binari = {"M12": 1, "M14": 2}binaridict"M12"1"M14"2
Il dizionario dei binari, senza M18

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.

Python
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 range

In 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.

Python
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:

Python
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.

Python
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 zero

Il ^ 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 leggie nonLa differenza
TypeErrorValueErrorTipo sbagliato (int(None)) contro contenuto sbagliato (int("12a"))
KeyErrorIndexErrorCerchi per nome in un dizionario, contro per posizione in una lista
NameErrorAttributeErrorIl nome da solo (Treno) contro il nome dopo un punto (fermate.apend)
SyntaxErrorIndentationErrorIl 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.
  • SyntaxError e IndentationError: il programma non parte, nemmeno la prima riga gira. Tutti gli altri: parte, e si ferma a metà.
  • IndentationError è un SyntaxError più 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, e NoneType vuol dire che era None.
  • Did you mean quasi sempre ha ragione.