Vai al contenuto
code-to-code

Apro l'indice…

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

Errori e debugger4. try, except, raisep. 85

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.

errori-try-except-raise.zip22 KB

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:

  1. Apri il file in palestra/. In alto: la storia, cosa fai, come provi.
  2. Al posto di pass scrivi il codice. La docstring ha gli esempi di cosa deve uscire, errori compresi.
  3. pytest palestra/test_<nome>.py -v, oppure la provetta di VS Code.
  4. 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):

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

#EsercizioLa mossaDifficoltà
1Il ritardo scritto a manol'errore preciso★
2Il binario scritto a manoil try piccolo★
3Il totale della seracontinue nel ciclo★★
4Gli avvisi della centralestderr★★
5Dentro e fuori dal tornelloraise dentro★★
6Il conto del turnotry fuori★★
7La riga del capotrenotrasformare 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.

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

Come provi: pytest palestra/test_ritardo_dal_tablet.py -v

Aiutino 1
È l'esempio A degli esercizi spiegati, con un altro nome.
Aiutino 2
Quale errore dà 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.

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

Come 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
È l'esempio B: nel 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.

Python
somma_ritardi(["5", "12", "3"])      # 20
somma_ritardi(["5", "n.d.", "3"])    # 8
somma_ritardi(["", "x"])             # 0

Come provi: pytest palestra/test_somma_ritardi.py -v

Aiutino 1
È l'esempio C. Il try sta dentro il for, e nell'except c'è continue.
Aiutino 2
Se il test con la riga rotta in mezzo (o all'inizio) è rosso e quello con la riga rotta in fondo è verde, il tuo 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.

Python
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
Tutte e due le righe rotte (senza virgola, minuti che non sono un numero) alzano un ValueError: metti nel try la riga con split e quella con int.
Aiutino 2
Per il numero della riga ti serve enumerate(righe, 1): parte da 1, come le persone. Nell'except: print(…, file=sys.stderr), poi continue.
Aiutino 3
Il testo della riga tra apici si ottiene con {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.

Python
durata_sosta(10, 25)   # 15
durata_sosta(10, 10)   # 0
durata_sosta(25, 10)   # ValueError: Uscita prima dell'entrata: entrata 25, uscita 10

Come provi: pytest palestra/test_durata_sosta.py -v

Aiutino 1
È l'esempio E, la parte «dentro»: un if e un raise ValueError(…).
Aiutino 2
Il messaggio deve avere i due numeri: serve un'f-string con {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.

Python
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
È l'esempio E, la parte «fuori»: il try sta in sosta_totale, intorno alla chiamata a durata_passaggio.
Aiutino 2
Nel 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.

Python
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
Tre 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
In ogni except: raise ValueError(f"…"), con il valore che è arrivato dentro, tra apici ({riga!r}).
Aiutino 3
Per l'ora il messaggio ha anche quello dell'errore originale, tra parentesi: 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.