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.
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/:
| File | Chi lo scrive | Cosa fai |
|---|---|---|
<nome>.py | noi | Il codice. Non si tocca. In cima: la storia, e nella docstring gli esempi |
test_<nome>.py | tu | I test che mancano, al posto di assert False |
test_controllo_<nome>.py | noi | Prova i tuoi test. Non si tocca |
I passi, sempre gli stessi:
- Apri
<nome>.pye leggi le tre righe in cima e la docstring della funzione. pytest palestra/test_<nome>.py -v: i test da scrivere sono rossi (c'èassert False), quelli già scritti verdi.- Scrivi un test alla volta, al posto di
assert False. Dopo ognuno, di nuovo pytest. - 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.
| # | Esercizio | Cosa impari | Difficoltà |
|---|---|---|---|
| 1 | I posti in carrozza | il primo assert, e i valori che contano | ★ |
| 2 | Il tabellone dei treni | un test per comportamento, i nomi | ★★ |
| 3 | La media dei ritardi | pytest.approx | ★★ |
| 4 | La ricarica della tessera | pytest.raises, match= | ★★ |
| 5 | La tariffa per età | parametrize, i confini | ★★★ |
| 6 | Il registro delle timbrature | tmp_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.
posti_liberi(15) # 25
posti_liberi(39) # 1
posti_liberi(45) # 0Nel 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
assert posti_liberi(…) == …. Gli esempi nella docstring ti dicono già i numeri.Aiutino 2
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.
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
Aiutino 2
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.
media_ritardi([2, 4, 6]) # 4.0
media_ritardi([1, 2, 2]) # 1.6666666666666667
media_ritardi([]) # 0.0Scrivi 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
== pytest.approx(…).Aiutino 2
== basta, prova prima con ==: se il test è rosso con un numero lunghissimo dopo la virgola, è il caso di approx.Aiutino 3
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.
ricarica(10.5, 20) # 30.5
ricarica(0, 1) # 1
ricarica(0, 0.5) # ValueError: Importo non valido: 0.5Scrivi 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
assert: la funzione non deve dare errore.Aiutino 3
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.
tariffa(30) # 2.2
tariffa(13) # 0.0
tariffa(65) # 1.1
tariffa(-1) # ValueErrorScrivi 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
("eta", "prezzo") e una lista di coppie.Aiutino 2
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:14Il 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: ricevetmp_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
file = tmp_path / "nome.csv", poi file.write_text("…", encoding="utf-8"). Il \n in una stringa è l'a capo.Aiutino 2
@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
\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.