I test con il database, la palestra
Tre esercizi da scaricare, in cui i test li scrivi tu
- 60–90 minuti di lavoro
Tre esercizi, dal ★ al ★★★. Questa volta l'API è già scritta e giusta: quello che scrivi tu sono i test. Quando il tuo test passa sull'API giusta, e (la prova del nove) diventa rosso se l'API è sbagliata, hai finito.
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, createdb, psql -f, code .. Se è la prima volta, la pagina Come si usa un esercizio lo fa con te.
Per ogni esercizio:
- Apri il file
test_….pyinpalestra/. In alto: la storia, cosa fai, come provi. - Al posto di ogni
pytest.fail(...)scrivi il tuo test. La docstring dice cosa deve controllare. pytest palestra/test_<nome>.py -v.- Rosso? Leggi l'ultima riga del messaggio. Bloccato da 15 minuti? Apri il primo aiutino, non la soluzione.
Il file conftest.py non si tocca, ma leggilo: è quello del capitolo. Le API (stazioni.py, segnalazioni.py, treni.py) neppure.
| # | Esercizio | Cosa impari | Difficoltà |
|---|---|---|---|
| 1 | Il collaudo delle stazioni | la risposta e il database | ★ |
| 2 | I test che si pestano i piedi | test indipendenti | ★★ |
| 3 | Il treno di prova | una fixture che prepara i dati | ★★★ |
1 · Il collaudo delle stazioni ★
palestra/test_stazioni.py
Marta Villa apre le stazioni nuove con POST /stazioni. Ernesto Pozzi vuole due test prima di mettere l'API sulla linea: uno per la stazione nuova, uno per il nome già usato.
risposta = client.post("/stazioni", json={"nome": "Corso Classe", "aperta": True, "tornelli": 6})
risposta.status_code # 201
sql("SELECT * FROM stazioni WHERE id = %s", (7,)) # la riga, nel database dei testCome provi: pytest palestra/test_stazioni.py -v. Poi la prova del nove: in stazioni.py cambia db.commit() in db.flush(). Il tuo primo test diventa rosso? Rimetti db.commit().
Aiutino 1
client.post, poi status_code) e il database (sql(...)).Aiutino 2
risposta.json()["id"].Aiutino 3
len(sql("SELECT * FROM stazioni")).2 · I test che si pestano i piedi ★★
palestra/test_segnalazioni.py
Lucia Ferri ha scritto tre test per il registro di Ivo. In ordine sembrano filare: il secondo chiude la segnalazione che ha aperto il primo, il terzo conta quelle aperte comprese quella del primo. Ma il database torna come nuovo prima di ogni test, e due test su tre sono rossi.
Riscrivi test_risolvi_la_segnalazione_di_prima e test_le_aperte_sono_sette: ognuno si prepara da solo i suoi dati con sql("INSERT …"), senza contare su nessun altro.
Come provi: pytest palestra/test_segnalazioni.py -v, poi pytest palestra/test_isolamento.py -v: quest'ultimo lancia i tuoi test uno alla volta e dice quali non reggono da soli.
Aiutino 1
Aiutino 2
sql("INSERT INTO segnalazioni (treno_id, autore_id, descrizione, gravita) VALUES (%s, %s, %s, %s) RETURNING id", (2, 2, "…", 1)) restituisce una lista con una riga: l'id è [0]["id"].Aiutino 3
client.put(f"/segnalazioni/{nuova}/risolvi"). Nel terzo test non serve l'id: ti basta inserirne una aperta.3 · Il treno di prova ★★★
palestra/test_treni.py
Tre test sull'API di Ernesto hanno bisogno dello stesso treno nuovo, il M30. Scriverlo tre volte è noioso. Scrivi una fixture treno_nuovo, poi i tre test: mandare il treno in officina, toglierlo, non toglierlo se ha segnalazioni.
@pytest.fixture
def treno_nuovo(sql):
... # inserisce il M30 e restituisce l'idCome provi: pytest palestra/test_treni.py -v. Poi la prova del nove: in treni.py togli db.commit() dal DELETE: deve diventare rosso il tuo secondo test.
Aiutino 1
INSERT … RETURNING id e return.Aiutino 2
("M30", 6, 0, True, 1) per codice, vagoni, km, in servizio, stazione. sql(...) dà una lista: restituisci riga[0]["id"], non la lista.Aiutino 3
treno_id uguale al parametro treno_nuovo. Poi controlla il 409 e che il treno sia ancora nel database.