Vai al contenuto
code-to-code

Apro l'indice…

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

Errori e debugger1. Leggere un tracebackp. 7

Leggere un traceback, esercizi spiegati

Cinque traceback, letti dal basso

  • 20 minuti di lettura

Cinque programmi che si piantano, dal più semplice. Ognuno ha lo stesso ritmo:

  1. Prevedi: leggi il codice e scrivi su un foglio che errore ti aspetti e a quale riga. Prima di aprire la risposta.
  2. In italiano: cosa fa il programma, a parole.
  3. Passo per passo: il traceback vero, letto dal basso, blocco per blocco.
  4. Cosa portiamo a casa: la cosa da ricordare.

Se vuoi, lancia i programmi anche tu: ricopiali in un file e usa python nomefile.py. Prima di leggere il traceback, però, prevedi.


A · La media di nessuno

Il tablet di Lucia Ferri calcola il ritardo medio per corsa. Ma il turno è appena cominciato.

Python
minuti_totali = 38
corse_fatte = 0

media = minuti_totali / corse_fatte
print("Ritardo medio per corsa:", media)

Che errore ti aspetti? A quale riga? Il programma stampa qualcosa?

Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Il programma si ferma alla riga 4 (conta dall'alto: la riga 3 è vuota), con un ZeroDivisionError. Non stampa niente: la print è la riga dopo.

  • Alla riga 4 si divide per corse_fatte, che vale 0.
  • Il nome ti dice già la storia: dividere per zero.

In italiano. Divido i minuti per le corse fatte. Ma le corse fatte sono zero, e per zero non si divide.

Passo per passo.

Traceback (most recent call last):
  File "/home/lucia/linea-menta/media.py", line 4, in <module>
    media = minuti_totali / corse_fatte
            ~~~~~~~~~~~~~~^~~~~~~~~~~~~
ZeroDivisionError: division by zero
Dal bassoCosa leggo
Ultima rigaZeroDivisionError: division by zero: una divisione per zero
Riga di codicemedia = minuti_totali / corse_fatte
I segniLa ^ è sotto la /: il guaio è la divisione, non il nome media
File …media.py, riga 4, <module>: nel programma principale

Un blocco solo, il caso più semplice: ultima riga, riga di codice, numero. Fine.

Cosa portiamo a casa. Con un blocco solo hai già tutto. Il nome dell'errore è all'inizio dell'ultima riga, il numero di riga è nel blocco File, e la ^ sta sul simbolo che ha fatto scattare l'errore.


B · Chi ha chiamato chi

Il distributore di Via Variabile somma il prezzo dei biglietti. Una zona è scritta in un modo che il listino non conosce.

Python
TARIFFE = {"urbana": 2.2, "extraurbana": 3.1}


def prezzo(zona):
    return TARIFFE[zona]


def totale(zone):
    somma = 0
    for zona in zone:
        somma = somma + prezzo(zona)
    return somma


print("Totale:", totale(["urbana", "urbana"]))
print("Totale:", totale(["urbana", "suburbana"]))

La prima print va. La seconda? Che errore, e in quale funzione si ferma?

Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Stampa Totale: 4.4, poi si ferma con un KeyError: 'suburbana', dentro la funzione prezzo, alla riga 5.

  • "suburbana" non è una chiave di TARIFFE.
  • Chi legge il dizionario è prezzo: lì si rompe. Ma ci è arrivato passando da totale, chiamata dalla riga 16.

In italiano. totale scorre le zone e per ognuna chiede il prezzo a prezzo. Alla zona "suburbana", prezzo va a cercare nel listino una chiave che non c'è.

Passo per passo.

Totale: 4.4
Traceback (most recent call last):
  File "/home/lucia/linea-menta/biglietti.py", line 16, in <module>
    print("Totale:", totale(["urbana", "suburbana"]))
                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/lucia/linea-menta/biglietti.py", line 11, in totale
    somma = somma + prezzo(zona)
                    ^^^^^^^^^^^^
  File "/home/lucia/linea-menta/biglietti.py", line 5, in prezzo
    return TARIFFE[zona]
           ~~~~~~~^^^^^^
KeyError: 'suburbana'

Qui i blocchi sono tre. Leggili dal basso, e poi risali:

BloccoRigaFunzioneCosa fa
3, il più in basso5prezzoTARIFFE[zona]: qui si rompe
211totalesomma + prezzo(zona): chiama prezzo
1, il più in alto16<module>totale([…, "suburbana"]): chiama totale con la zona sbagliata

L'ultima riga dà il nome della chiave: 'suburbana'. Il blocco 3 dice dove la cerca. Il blocco 1 mostra chi ha passato quella zona: la riga 16, con la lista in cui compare "suburbana".

Cosa portiamo a casa. Il blocco più in basso dice dove Python non ce l'ha fatta. Per capire da dove viene il valore storto, risali di un blocco alla volta: ogni blocco è una chiamata.


C · Due file

I messaggi dell'altoparlante di Ponte Ciclo calcolano lo sconto per gli abbonati. Il calcolo sta in un file, listino.py, e il programma che lo usa in un altro, corse.py.

listino.py:

Python
def con_sconto(prezzo):
    return prezzo * 0.9

corse.py:

Python
import listino

prezzi = [2.0, 3.0, "1.80"]
for prezzo in prezzi:
    print(listino.con_sconto(prezzo))

Si lancia python corse.py. Quanti prezzi stampa prima di fermarsi? E in quale file si ferma?

Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Stampa 1.8 e 2.7, poi si ferma sul terzo prezzo, "1.80": è un testo, non un numero. L'errore è un TypeError, e la riga che si rompe è la 2 di listino.py.

  • 2.0 * 0.9 e 3.0 * 0.9 funzionano.
  • "1.80" * 0.9 no: un testo si può ripetere ("ab" * 3), ma non per un numero con la virgola.

In italiano. corse.py passa ogni prezzo a con_sconto, che sta in un altro file. Il terzo prezzo è tra virgolette, e con_sconto non sa cosa farsene.

Passo per passo.

1.8
2.7
Traceback (most recent call last):
  File "/home/lucia/linea-menta/corse.py", line 5, in <module>
    print(listino.con_sconto(prezzo))
          ^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/lucia/linea-menta/listino.py", line 2, in con_sconto
    return prezzo * 0.9
           ~~~~~~~^~~~~
TypeError: can't multiply sequence by non-int of type 'float'
BloccoFileRigaFunzioneCosa fa
2, il più in bassolistino.py2con_scontoprezzo * 0.9: qui si rompe (la ^ è sotto il *)
1corse.py5<module>chiama con_sconto(prezzo)

Entrambi i file sono tuoi, e il blocco in basso è nell'altro file. Aprirai listino.py alla riga 2, e vedrai una moltiplicazione che sembra giusta. Il bug non è lì: è nel dato. Il blocco sopra ti riporta a corse.py, dove "1.80" è scritto tra virgolette.

Cosa portiamo a casa. Il traceback può passare da un file all'altro: il nome del file è in ogni blocco File. Il blocco più in basso è nel file dove si rompe; il dato storto spesso viene dal file di sopra.


D · Il blocco che non è tuo

Marta Villa vuole il ritardo medio di oggi, ma al mattino presto la lista dei ritardi è vuota. Per la media usa una funzione già pronta di Python.

Python
import statistics

ritardi = []
print("Ritardo medio:", statistics.mean(ritardi))

Il traceback avrà un blocco solo, o più d'uno?

Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Più d'uno: uno è del programma (riga 4), l'altro è dentro statistics.py, che è di Python.

  • La riga che chiama mean è la tua: la 4.
  • mean è la funzione che si rompe, e sta nella libreria standard.

In italiano. statistics.mean fa la media dei numeri di una lista. Con la lista vuota non ha niente da mediare, e lo dice con un errore.

Passo per passo.

Traceback (most recent call last):
  File "/home/lucia/linea-menta/ritardo_medio.py", line 4, in <module>
    print("Ritardo medio:", statistics.mean(ritardi))
                            ^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.12/statistics.py", line 486, in mean
    raise StatisticsError('mean requires at least one data point')
statistics.StatisticsError: mean requires at least one data point
BloccoFileDi chi èCosa fa
2, il più in basso/usr/lib/python3.12/statistics.pyDi Pythonmean ha trovato la lista vuota, e ha alzato l'errore
1ritardo_medio.pyTuochiama mean(ritardi)

Il blocco più in basso non è tuo: /usr/lib/python3.12/ è la libreria standard. Non lo apri, non lo tocchi. Il messaggio dice già tutto: serve almeno un dato (at least one data point), e ritardi è vuota.

Il blocco che guardi è quello più in basso che è tuo: il 1, alla riga 4. Lì ti chiedi: cosa ho passato a mean? Una lista vuota.

Il disegno.

inizio traceback con due blocchi passo ultima riga: StatisticsError passo parto dal blocco più in basso finché il file è di lib/python3.12 passo salgo di un blocco fine guardo la riga 4 di ritardo_medio.pytraceback con due blocchiultima riga: StatisticsErrorparto dal blocco più inbassoil file è dilib/python3.12salgo di un bloccoguardo la riga 4 diritardo_medio.pysìno
Quale blocco guardare

Cosa portiamo a casa. Quando in fondo c'è un file di lib/python3.12 o di site-packages, risali al primo blocco che è tuo. La libreria ha ragione: sei tu che le hai dato qualcosa che non poteva usare.


E · Il server che dice 500

La centrale ha un server con un solo percorso: GET /treni/{codice}/ritardo, che dice quanti minuti di ritardo ha un treno. Il codice:

Python
from fastapi import FastAPI

app = FastAPI()

TRENI = {"M12": {"ritardo": 2}, "M14": {"ritardo": 0}}


def cerca_treno(codice):
    return TRENI.get(codice)


def minuti_di_ritardo(codice):
    treno = cerca_treno(codice)
    return treno["ritardo"]


@app.get("/treni/{codice}/ritardo")
def ritardo(codice: str):
    return {"codice": codice, "minuti": minuti_di_ritardo(codice)}

Un tabellone chiede /treni/M99/ritardo, e il browser mostra solo Internal Server Error. Il traceback è nel terminale del server. Prima di leggerlo: quale riga del tuo codice si romperà, e perché?

Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

La riga return treno["ritardo"], dentro minuti_di_ritardo. M99 non è nei treni, quindi TRENI.get("M99") dà None, e su None le quadre non si possono usare.

  • get non si arrabbia: restituisce None.
  • È la riga dopo che si arrabbia: None["ritardo"].

Il disegno. Le variabili quando cerca_treno ha risposto:

TRENI = {"M12": {"ritardo": 2}, "M14": {"ritardo": 0}} codice = "M99" treno = NoneTRENIcodicetrenodict"M12""M14"dict"ritardo"2dict"ritardo"0str"M99"NoneTypeNone
Dopo cerca_treno("M99")

In italiano. La rotta chiama minuti_di_ritardo, che chiama cerca_treno. Per M99 cerca_treno non trova niente e risponde None. minuti_di_ritardo ci prova lo stesso a leggere ["ritardo"], e l'errore scoppia lì.

Passo per passo. Nel terminale del server il traceback è lungo. Qui lo mostriamo con gli estremi: l'inizio, i blocchi in mezzo (tutti di librerie) tagliati, e la fine.

INFO:     127.0.0.1:62332 - "GET /treni/M99/ritardo HTTP/1.1" 500 Internal Server Error
ERROR:    Exception in ASGI application
Traceback (most recent call last):
  File "/home/lucia/linea-menta/.venv/lib/python3.12/site-packages/uvicorn/protocols/http/httptools_impl.py", line 422, in run_asgi
    result = await app(  # type: ignore[func-returns-value]
             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/lucia/linea-menta/.venv/lib/python3.12/site-packages/uvicorn/middleware/proxy_headers.py", line 63, in __call__
    return await self.app(scope, receive, send)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  (… tanti altri blocchi, tutti di uvicorn, fastapi, starlette e anyio …)
  File "/home/lucia/linea-menta/.venv/lib/python3.12/site-packages/fastapi/telemetry/_api.py", line 244, in _run_sync_endpoint
    return function(**arguments)
           ^^^^^^^^^^^^^^^^^^^^^
  File "/home/lucia/linea-menta/centrale.py", line 19, in ritardo
    return {"codice": codice, "minuti": minuti_di_ritardo(codice)}
                                        ^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/home/lucia/linea-menta/centrale.py", line 14, in minuti_di_ritardo
    return treno["ritardo"]
           ~~~~~^^^^^^^^^^^
TypeError: 'NoneType' object is not subscriptable

Leggilo dal basso, come sempre.

Dal bassoCosa leggo
Ultima rigaTypeError: 'NoneType' object is not subscriptable: hai usato le quadre su None
Il blocco più in bassocentrale.py, riga 14, minuti_di_ritardo: treno["ritardo"], con la ^ sulle quadre
Il blocco sopracentrale.py, riga 19, ritardo: chiama minuti_di_ritardo(codice). È la rotta
Tutti i blocchi più in altoPercorso con site-packages: librerie, si saltano

I tuoi blocchi sono due, e sono in fondo. Quello che conta, il più in basso, è il 14. Quello sopra (il 19) è la rotta: ti dice che il guaio è nato da una richiesta.

Non ti serve contare le librerie, né leggerle. Scorri dal basso, e quando il percorso smette di avere site-packages e comincia con la tua cartella, sei arrivato.

Cosa portiamo a casa. Un traceback lungo è un traceback normale con in mezzo tanto rumore. Si legge uguale: l'ultima riga per il nome, il primo percorso tuo dal basso per il punto.