Vai al contenuto
code-to-code

Apro l'indice…

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

Codice pulito e test3. Scrivere un testp. 87

Scrivere un test, la palestra

Sei esercizi, il codice è giusto e i test li scrivi tu

  • 90–120 minuti di lavoro

Sei esercizi, dal ★ al ★★★, ambientati sulla Linea Menta. Questa volta il codice è già scritto, ed è giusto: non si tocca. Tocca a te scrivere i test, nel file test_<nome>.py, al posto di assert False.

Gli esercizi da scaricare

Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.

pulito-scrivere-un-test.zip30 KB

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 ha tre file in palestra/:

FileChi lo scriveCosa fai
<nome>.pynoiIl codice. Non si tocca. In cima: la storia, e nella docstring gli esempi
test_<nome>.pytuI test che mancano, al posto di assert False
test_controllo_<nome>.pynoiProva i tuoi test. Non si tocca

I passi, sempre gli stessi:

  1. Apri <nome>.py e leggi le tre righe in cima e la docstring della funzione.
  2. pytest palestra/test_<nome>.py -v: i test da scrivere sono rossi (c'è assert False), quelli già scritti verdi.
  3. Scrivi un test alla volta, al posto di assert False. Dopo ognuno, di nuovo pytest.
  4. Tutti verdi? Allora pytest palestra/test_controllo_<nome>.py -v.

Il controllo fa una cosa sola: prende il codice giusto, ci mette dentro una versione sbagliata apposta, e lancia i tuoi test. Per ogni versione sbagliata almeno uno dei tuoi test deve diventare rosso. Se non succede, il messaggio dice cosa i tuoi test non vedono:

I tuoi test restano verdi anche se con 39 passeggeri la carrozza risulta già piena. Manca un test che se ne accorga.

Non ti dice come scrivere il test: quello lo trovi tu. Se per qualche test sei bloccato da quindici minuti, apri il primo aiutino, non la soluzione.

#EsercizioCosa impariDifficoltà
1I posti in carrozzail primo assert, e i valori che contano★
2Il tabellone dei treniun test per comportamento, i nomi★★
3La media dei ritardipytest.approx★★
4La ricarica della tesserapytest.raises, match=★★
5La tariffa per etàparametrize, i confini★★★
6Il registro delle timbraturetmp_path e una fixture★★★

1 · I posti in carrozza ★

palestra/posti_carrozza.py e palestra/test_posti_carrozza.py

Ai tornelli di Porta Codice, Nadia vuole sapere quanti posti restano liberi in una carrozza da 40 posti. Con più passeggeri dei posti, i liberi sono zero, mai un numero negativo.

Python
posti_liberi(15)   # 25
posti_liberi(39)   # 1
posti_liberi(45)   # 0

Nel file di test c'è già un esempio. Scrivi i tre test che mancano: l'ultimo posto libero, la carrozza piena, la carrozza oltre la capienza.

Come provi: pytest palestra/test_posti_carrozza.py -v, poi pytest palestra/test_controllo_posti_carrozza.py -v

Aiutino 1
Ogni test è una riga: assert posti_liberi(…) == …. Gli esempi nella docstring ti dicono già i numeri.
Aiutino 2
Il controllo dice «con 39 passeggeri»: un test per ogni valore che compare nei messaggi del controllo.

2 · Il tabellone dei treni ★★

palestra/stato_treno.py e palestra/test_stato_treno.py

Sul tabellone di Via Variabile ogni treno ha uno stato: soppresso, in orario (fino a 3 minuti di ritardo compresi) oppure in ritardo di N minuti. Un treno soppresso è soppresso, qualunque ritardo abbia.

Python
stato_treno(0)                   # 'in orario'
stato_treno(4)                   # 'in ritardo di 4 minuti'
stato_treno(0, soppresso=True)   # 'soppresso'

Scrivi i tre test che mancano. Un test per comportamento, e il nome si legge come una frase: nel file ci sono già i nomi, ma sono tuoi, puoi cambiarli. Il controllo vuole almeno quattro test, ognuno con un assert e un nome di almeno tre parole dopo test_.

Come provi: pytest palestra/test_stato_treno.py -v, poi pytest palestra/test_controllo_stato_treno.py -v

Aiutino 1
Ci sono tre comportamenti: soppresso, in orario, in ritardo. I confini sono due: dove finisce «in orario» e dove comincia il ritardo.
Aiutino 2
Prova i valori 3 e 4. Poi un treno soppresso che non ha nessun ritardo: se il codice controllasse il ritardo prima della soppressione, direbbe «in orario».

3 · La media dei ritardi ★★

palestra/media_ritardi.py e palestra/test_media_ritardi.py

Ogni sera Marta Villa, a Piazza Query, vuole il ritardo medio dei treni. I sensori danno i minuti con la virgola. La funzione non arrotonda; senza ritardi la media è 0.0.

Python
media_ritardi([2, 4, 6])   # 4.0
media_ritardi([1, 2, 2])   # 1.6666666666666667
media_ritardi([])          # 0.0

Scrivi i tre test che mancano. Con i numeri con la virgola == tradisce: ti serve pytest.approx (e import pytest in cima al file). Il controllo prova anche che tu non abbia usato una tolleranza larga come una porta.

Come provi: pytest palestra/test_media_ritardi.py -v, poi pytest palestra/test_controllo_media_ritardi.py -v

Aiutino 1
Rileggi l'esempio C degli esercizi spiegati: == pytest.approx(…).
Aiutino 2
Per sapere se == basta, prova prima con ==: se il test è rosso con un numero lunghissimo dopo la virgola, è il caso di approx.
Aiutino 3
Se il controllo dice che i tuoi test restano verdi con la media sbagliata di un centesimo, la tua tolleranza (abs=) è troppo larga: toglila, approx da solo basta.

4 · La ricarica della tessera ★★

palestra/ricarica_tessera.py e palestra/test_ricarica_tessera.py

Alla biglietteria di Largo Lista si ricarica la tessera tra 1 e 150 euro, estremi compresi. Fuori da questi limiti, ValueError con un messaggio che dice l'importo sbagliato.

Python
ricarica(10.5, 20)   # 30.5
ricarica(0, 1)       # 1
ricarica(0, 0.5)     # ValueError: Importo non valido: 0.5

Scrivi i cinque test che mancano: due errori, due estremi che invece sono ammessi, e il messaggio. Ti serve pytest.raises (e import pytest).

Come provi: pytest palestra/test_ricarica_tessera.py -v, poi pytest palestra/test_controllo_ricarica_tessera.py -v

Aiutino 1
with pytest.raises(ValueError): e, dentro il blocco rientrato, la chiamata alla funzione. Il blocco è verde se l'errore arriva.
Aiutino 2
Gli estremi ammessi (1 e 150) si provano come i casi normali, con un assert: la funzione non deve dare errore.
Aiutino 3
Il controllo dice «l'errore è un TypeError invece di un ValueError»? Controlla di aver scritto il tipo preciso nel with. Per il messaggio: match="151".

5 · La tariffa per età ★★★

palestra/tariffa_eta.py e palestra/test_tariffa_eta.py

Ai tornelli di Ponte Ciclo i bambini viaggiano gratis fino a 13 anni, da 14 a 64 si paga 2.2 euro, da 65 anni 1.1. Un'età negativa è un errore. I guai stanno sui confini.

Python
tariffa(30)   # 2.2
tariffa(13)   # 0.0
tariffa(65)   # 1.1
tariffa(-1)   # ValueError

Scrivi i due test che mancano: uno con pytest.mark.parametrize, che prova tutti i valori che contano, e uno per l'errore. Il controllo vuole almeno un parametrize, e prova una versione sbagliata per ogni confine.

Come provi: pytest palestra/test_tariffa_eta.py -v, poi pytest palestra/test_controllo_tariffa_eta.py -v

Aiutino 1
La forma è quella dell'esempio E degli esercizi spiegati: ("eta", "prezzo") e una lista di coppie.
Aiutino 2
I confini sono quattro: 13 e 14, 64 e 65. Se vuoi, aggiungi anche un valore a metà di ogni fascia: ma sono i confini a fare il lavoro.

6 · Il registro delle timbrature ★★★

palestra/timbrature_csv.py e palestra/test_timbrature_csv.py

Ogni notte il deposito di Vecchia Fiera scrive le timbrature del personale in un file CSV: una riga di intestazione, poi una riga per timbratura. Ernesto Pozzi vuole sapere quante sono. La funzione legge il file: per provarla ti serve un file di prova.

badge,ora
B-01,06:10
B-12,06:14

Il file qui sopra ha 2 timbrature. L'intestazione non conta, le righe vuote nemmeno.

Nel file di test c'è un esempio che usa tmp_path. Tocca a te:

  • scrivere la fixture registro, con @pytest.fixture: riceve tmp_path, scrive un file con l'intestazione e tre timbrature, e restituisce il suo percorso;
  • scrivere i tre test che mancano. Il primo usa la fixture, gli altri due costruiscono da soli il loro file.

Come provi: pytest palestra/test_timbrature_csv.py -v, poi pytest palestra/test_controllo_timbrature_csv.py -v

Aiutino 1
Un file di prova si scrive così: file = tmp_path / "nome.csv", poi file.write_text("…", encoding="utf-8"). Il \n in una stringa è l'a capo.
Aiutino 2
La fixture è una funzione con @pytest.fixture sopra e tmp_path come parametro: scrive il file e fa return file. Un test la usa scrivendo registro tra le sue parentesi.
Aiutino 3
Per la riga vuota: un file che finisce con più di un a capo (\n\n). Se il controllo dice che le righe vuote contate non le vedi, il tuo file di prova non ne ha.

Finito? Confronta i tuoi test con le soluzioni: per ogni esercizio ci sono il ragionamento, il codice e i test sbagliati più probabili, quelli che il controllo smaschera.