try, except, raise, la palestra
Sette funzioni da completare, con i test
- 60–90 minuti di lavoro
Sette esercizi, dal ★ al ★★★, uno per ogni mossa del capitolo. Ognuno è una funzione da completare, con il suo file di test: quando è tutto verde, hai finito. Sono ambientati sui tornelli, sui badge del personale e sul tablet di Lucia Ferri.
Gli esercizi da scaricare
Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.
Nello stesso zip c'è anche la storia del capitolo, Il registro sporco: la trovi nella pagina dopo.
Prima di iniziare
Scompatta lo zip e segui il README.md che c'è dentro: venv, pip install, code .. Se è la prima volta, la pagina Come si usa un esercizio lo fa con te, un comando alla volta.
Ogni esercizio, sempre gli stessi quattro passi:
- Apri il file in
palestra/. In alto: la storia, cosa fai, come provi. - Al posto di
passscrivi il codice. La docstring ha gli esempi di cosa deve uscire, errori compresi. pytest palestra/test_<nome>.py -v, oppure la provetta di VS Code.- Rosso? Leggi l'ultima riga del messaggio. Bloccato da 15 minuti? Apri il primo aiutino, non la soluzione.
Come si legge un test che si aspetta un errore
In questa palestra quasi ogni file di test ha un with pytest.raises(…). Non devi scriverlo, ma devi saperlo leggere (è nella teoria, mossa 7):
def test_un_none_e_un_bug_e_ferma_il_programma():
with pytest.raises(TypeError):
ritardo_dal_tablet(None)Si legge: chiamo la funzione con None, e mi aspetto che alzi un TypeError. Se la funzione restituisce un valore, o alza un altro errore, il test è rosso. Con match="…", il messaggio deve anche contenere quel testo. E il test con capsys legge quello che la funzione ha scritto su stdout (.out) e su stderr (.err): non lo devi toccare, ti basta sapere che lo fa.
| # | Esercizio | La mossa | Difficoltà |
|---|---|---|---|
| 1 | Il ritardo scritto a mano | l'errore preciso | ★ |
| 2 | Il binario scritto a mano | il try piccolo | ★ |
| 3 | Il totale della sera | continue nel ciclo | ★★ |
| 4 | Gli avvisi della centrale | stderr | ★★ |
| 5 | Dentro e fuori dal tornello | raise dentro | ★★ |
| 6 | Il conto del turno | try fuori | ★★ |
| 7 | La riga del capotreno | trasformare un errore | ★★★ |
1 · Il ritardo scritto a mano ★
palestra/ritardo_dal_tablet.py
Lucia scrive il ritardo a mano sul tablet. Se scrive «boh» o lascia il campo vuoto, il programma deve andare avanti con zero minuti. Se dal tablet non arriva niente (None), non è colpa di chi scrive: è un bug, e il programma deve fermarsi.
ritardo_dal_tablet("12") # 12
ritardo_dal_tablet(" 3 ") # 3
ritardo_dal_tablet("boh") # 0
ritardo_dal_tablet("") # 0
ritardo_dal_tablet(None) # TypeError: il programma si fermaCome provi: pytest palestra/test_ritardo_dal_tablet.py -v
Aiutino 1
Aiutino 2
int("boh")? Quale dà int(None)? Nell'except scrivi il nome del primo.2 · Il binario scritto a mano ★
palestra/posizione_binario.py
Il capostazione di Piazza Query scrive a mano il numero del binario, e il programma deve trovare a che posto sta nella lista dei binari. Se il testo non è un numero («tre»), risposta None. Se è un numero ma quel binario non esiste, il guaio non è nella scrittura: l'errore deve passare.
posizione_binario([1, 2, 3, 4], "3") # 2
posizione_binario([1, 2, 3, 4], " 1 ") # 0
posizione_binario([1, 2, 3, 4], "tre") # None
posizione_binario([1, 2, 3, 4], "9") # ValueError: il binario 9 non esisteCome provi: pytest palestra/test_posizione_binario.py -v
Aiutino 1
binari.index(numero) dà la posizione, e alza un ValueError se il numero non c'è. Anche int("tre") alza un ValueError. Due righe, stesso nome di errore.Aiutino 2
try solo la riga di int. L'index sta fuori, dopo l'except.3 · Il totale della sera ★★
palestra/somma_ritardi.py
A fine turno la centrale somma i ritardi scritti a mano dai capotreno. Qualcuno ha scritto «n.d.», qualcuno ha lasciato la riga vuota. La somma deve saltare quelle righe e andare avanti, non fermarsi alla prima rotta.
somma_ritardi(["5", "12", "3"]) # 20
somma_ritardi(["5", "n.d.", "3"]) # 8
somma_ritardi(["", "x"]) # 0Come provi: pytest palestra/test_somma_ritardi.py -v
Aiutino 1
try sta dentro il for, e nell'except c'è continue.Aiutino 2
try è fuori dal ciclo, o nell'except c'è un return.4 · Gli avvisi della centrale ★★
palestra/ritardi_per_treno.py
La centrale riceve righe «codice,minuti», per esempio "M12,5". Le righe rotte ("M14,cinque", "M16" senza virgola) non fermano il programma: si saltano, e si avvisa su stderr con il numero della riga (la prima è la numero 1) e il testo com'è. Il risultato è un dizionario.
ritardi_per_treno(["M12,5", "M14,cinque", "M16,0"])
# {"M12": 5, "M16": 0}
# su stderr: Riga 2 scartata: 'M14,cinque'Come provi: pytest palestra/test_ritardi_per_treno.py -v
Aiutino 1
ValueError: metti nel try la riga con split e quella con int.Aiutino 2
enumerate(righe, 1): parte da 1, come le persone. Nell'except: print(…, file=sys.stderr), poi continue.Aiutino 3
{riga!r} dentro l'f-string.5 · Dentro e fuori dal tornello ★★
palestra/durata_sosta.py
Un badge entra in un tornello e poi esce. I minuti passati dentro sono la differenza tra le due ore. Un'uscita prima dell'entrata non può essere vera: la funzione deve fermarsi con un ValueError che dice quali valori sono arrivati, non restituire un numero finto.
durata_sosta(10, 25) # 15
durata_sosta(10, 10) # 0
durata_sosta(25, 10) # ValueError: Uscita prima dell'entrata: entrata 25, uscita 10Come provi: pytest palestra/test_durata_sosta.py -v
Aiutino 1
if e un raise ValueError(…).Aiutino 2
{entrata} e {uscita}. Il test controlla proprio quelli.6 · Il conto del turno ★★
palestra/sosta_totale.py
Nadia Russo, la guardia giurata, vuole il totale dei minuti passati in galleria dai badge di una notte. Qualche passaggio ha l'uscita prima dell'entrata: il tornello ha sbagliato. Nadia non vuole fermarsi: vuole il totale dei passaggi buoni e quanti ne ha scartati.
durata_passaggio c'è già: è la funzione dell'esercizio 5, e alza il suo ValueError. Lei non si tocca. Tu scrivi sosta_totale, e decidi cosa farne dell'errore.
sosta_totale([(10, 25), (30, 40)]) # (25, 0)
sosta_totale([(10, 25), (50, 40), (60, 61)]) # (16, 1)
sosta_totale([]) # (0, 0)Come provi: pytest palestra/test_sosta_totale.py -v
Aiutino 1
try sta in sosta_totale, intorno alla chiamata a durata_passaggio.Aiutino 2
try solo la chiamata. Nell'except: un contatore che sale di uno, poi continue. La somma va dopo l'except.7 · La riga del capotreno ★★★
palestra/leggi_fermata.py
Lucia scrive una riga per ogni fermata: "M12;LL;23:14", cioè treno, sigla della stazione e ora. Il programma la trasforma in un dizionario. Ma la riga può essere incompleta, la sigla può non esistere, l'ora può essere illeggibile: così com'è, ognuno di questi guasti dà un errore diverso e muto (IndexError, KeyError, un ValueError in inglese). Tu li trasformi tutti in un ValueError che dice cosa non va e con quale testo.
leggi_fermata("M12;LL;23:14")
# {"treno": "M12", "stazione": "Largo Lista", "minuto": 1394}
leggi_fermata("M12;LL") # ValueError: Riga incompleta: 'M12;LL'
leggi_fermata("M12;XX;23:14") # ValueError: Sigla sconosciuta: 'XX'
leggi_fermata("M12;LL;23.14") # ValueError: Ora non leggibile: '23.14' (not enough values to unpack (expected 2, got 1))Come provi: pytest palestra/test_leggi_fermata.py -v
Aiutino 1
try piccoli, uno per guasto: la riga (campi[0], campi[1], campi[2] danno IndexError se mancano), la sigla (STAZIONI[sigla] dà KeyError), l'ora (da_ora_a_minuti dà ValueError).Aiutino 2
except: raise ValueError(f"…"), con il valore che è arrivato dentro, tra apici ({riga!r}).Aiutino 3
except ValueError as errore: e poi {errore} dentro l'f-string. Il test controlla che ci sia.Finito? Confronta le tue con le soluzioni: per ogni esercizio ci sono il ragionamento, il codice e le trappole più comuni. Poi la storia.