Moduli e file, se qualcosa va storto
Tredici errori, tredici uscite
Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.
Ricorda come si legge un traceback: dal basso. L'ultima riga dice cosa, la riga con i ^^^ dice quale pezzo, la riga File … line … dice dove. Tutto il resto è nel capitolo Leggere un traceback.
I file
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
FileNotFoundError: [Errno 2] No such file or directory: 'dati/salite.csv' | Il percorso relativo parte dalla cartella da cui lanci, e da lì quel file non c'è. Quasi mai è il codice: è il terminale che sta in un'altra cartella | pwd, e rileggi il percorso partendo da lì. Lancia dalla cartella giusta, oppure, se il file sta sempre accanto al programma, Path(__file__).parent / "salite.csv" |
UnicodeDecodeError: 'charmap' codec can't decode byte 0x9d in position 35: character maps to <undefined> | Manca encoding="utf-8", e Python ha usato la codifica del sistema (il suo modo di scrivere le lettere), che non è UTF-8. Succede su Windows fuori da WSL | open(percorso, encoding="utf-8"). Sempre, anche quando sul tuo computer funziona senza |
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xf2 in position 31: invalid continuation byte | Hai messo encoding="utf-8", ma il file non è in UTF-8: l'ha salvato un altro programma, spesso Excel | Aprilo in VS Code, clic sulla codifica in basso a destra → Save with Encoding → UTF-8. Oppure leggilo con la sua codifica, per esempio encoding="latin-1" |
TypeError: write() argument must be str, not int | write vuole testo, e gli hai dato un numero | f.write(f"{treno},{minuti}\n"): la f-string fa il testo, e l'a capo lo metti tu |
KeyError: 'urbana\n' | La chiave arriva da un file e si porta dietro l'a capo | strip() sulla riga, prima di usarla |
I CSV e i JSON
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
ValueError: invalid literal for int() with base 10: 'minuti' | Stai convertendo in numero l'intestazione, o un campo scritto male | L'intestazione si salta: righe[1:]. Un numero scritto male si salta con try ed except ValueError, come al livello 4 della storia |
ValueError: not enough values to unpack (expected 2, got 1) | La riga ha meno campi di quelli che spacchetti: spesso è una riga vuota, magari l'ultima del file | strip(), poi if riga == "": continue |
ValueError: too many values to unpack (expected 3) | La riga ha più campi del previsto: c'è una virgola dentro un campo | Se il campo è tra virgolette, usa il modulo csv. Se no, la riga è rotta: saltala e dillo su stderr |
TypeError: the JSON object must be str, bytes or bytearray, not TextIOWrapper | Hai dato a json.loads un file aperto | Con un file aperto json.load; json.loads, con la s, è per le stringhe |
I moduli
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
ModuleNotFoundError: No module named 'tariffe' | Python non trova tariffe.py nella cartella del programma che lanci: il file sta altrove, o il nome è scritto diverso | Il modulo va nella stessa cartella del file che lanci. Controlla le lettere: tarife non è tariffe |
ModuleNotFoundError: No module named 'tariffe.py'; 'tariffe' is not a package | Hai scritto import tariffe.py | Il nome del modulo è senza .py: import tariffe |
NameError: name 'math' is not defined. Did you forget to import 'math'? | Usi un modulo che in questo file non hai importato | import math in cima al file. Ogni file importa quello che usa: l'import di un altro file non vale qui |
AttributeError: module 'csv' has no attribute 'reader' | Nella tua cartella c'è un file che si chiama csv.py, e Python importa quello al posto del modulo vero | Rinomina il tuo file, per esempio leggi_csv.py. Lo stesso per json.py, math.py, random.py: mai il nome di un modulo della libreria standard |
Gli errori che non danno errori
I più difficili sono quelli senza traceback: il programma gira, il risultato è sbagliato. In questo capitolo sono quasi sempre uno di questi quattro.
Il file che si svuota. Hai aperto con "w" un file che volevi allungare: "w" lo cancella appena lo apri, prima ancora di scrivere. Il registro di ieri non c'è più, e nessuno te lo dice. Per aggiungere in fondo: "a". Lo stesso succede nel terminale con >: python programma.py > registro.txt svuota registro.txt prima di cominciare.
La riga con \n in fondo. riga == "urbana" è False, riga in fermate è False, if riga != "" lascia passare le righe vuote, che sono "\n". Nessun errore, solo confronti che non tornano mai. Per vedere quello che non si vede, stampa la riga con le virgolette, con il !r del capitolo Le stringhe: print(f"{riga!r}") mostra 'urbana\n'. La cura è sempre la stessa: strip() appena leggi la riga.
Le lettere strane. Però è tardi diventa Però è tardi. Il file è in UTF-8, ma è stato letto con un'altra codifica: manca encoding="utf-8". A volte arriva un UnicodeDecodeError, a volte solo queste lettere storte.
Le righe che spariscono in silenzio. Un continue o un except che salta una riga senza dirlo: il programma arriva in fondo, ma con meno dati di quelli che credi. Ogni riga saltata si segnala su stderr. Vale la regola di sempre: gli errori non si nascondono.
Per trovarli, il debugger: un breakpoint dentro il for che legge le righe, F10 un giro alla volta, e in VARIABLES guardi riga così com'è, con il suo \n. Come si fa: Il debugger, passo per passo.
Se il problema non è il codice
pytest: command not found, No module named pytest, il pannello Testing vuoto, No module named 'avvisi': non è il tuo codice, è l'ambiente, o la cartella da cui lanci pytest. Ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente.