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:
- Prevedi: leggi il codice e scrivi su un foglio che errore ti aspetti e a quale riga. Prima di aprire la risposta.
- In italiano: cosa fa il programma, a parole.
- Passo per passo: il traceback vero, letto dal basso, blocco per blocco.
- 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.
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 vale0. - 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 basso | Cosa leggo |
|---|---|
| Ultima riga | ZeroDivisionError: division by zero: una divisione per zero |
| Riga di codice | media = minuti_totali / corse_fatte |
| I segni | La ^ è 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.
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 diTARIFFE.- Chi legge il dizionario è
prezzo: lì si rompe. Ma ci è arrivato passando datotale, 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:
| Blocco | Riga | Funzione | Cosa fa |
|---|---|---|---|
| 3, il più in basso | 5 | prezzo | TARIFFE[zona]: qui si rompe |
| 2 | 11 | totale | somma + prezzo(zona): chiama prezzo |
| 1, il più in alto | 16 | <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:
def con_sconto(prezzo):
return prezzo * 0.9corse.py:
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.9e3.0 * 0.9funzionano."1.80" * 0.9no: 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'| Blocco | File | Riga | Funzione | Cosa fa |
|---|---|---|---|---|
| 2, il più in basso | listino.py | 2 | con_sconto | prezzo * 0.9: qui si rompe (la ^ è sotto il *) |
| 1 | corse.py | 5 | <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.
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| Blocco | File | Di chi è | Cosa fa |
|---|---|---|---|
| 2, il più in basso | /usr/lib/python3.12/statistics.py | Di Python | mean ha trovato la lista vuota, e ha alzato l'errore |
| 1 | ritardo_medio.py | Tuo | chiama 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.
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:
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.
getnon si arrabbia: restituisceNone.- È la riga dopo che si arrabbia:
None["ritardo"].
Il disegno. Le variabili quando cerca_treno ha risposto:
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 subscriptableLeggilo dal basso, come sempre.
| Dal basso | Cosa leggo |
|---|---|
| Ultima riga | TypeError: 'NoneType' object is not subscriptable: hai usato le quadre su None |
| Il blocco più in basso | centrale.py, riga 14, minuti_di_ritardo: treno["ritardo"], con la ^ sulle quadre |
| Il blocco sopra | centrale.py, riga 19, ritardo: chiama minuti_di_ritardo(codice). È la rotta |
| Tutti i blocchi più in alto | Percorso 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.