Vai al contenuto
code-to-code

Apro l'indice…

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

Il database nell'API6. I test con il databasep. 152

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.

db-test-con-il-database.zip17 KB

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:

  1. Apri il file test_….py in palestra/. In alto: la storia, cosa fai, come provi.
  2. Al posto di ogni pytest.fail(...) scrivi il tuo test. La docstring dice cosa deve controllare.
  3. pytest palestra/test_<nome>.py -v.
  4. 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.

#EsercizioCosa impariDifficoltà
1Il collaudo delle stazionila risposta e il database★
2I test che si pestano i pieditest indipendenti★★
3Il treno di provauna 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.

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

Come 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
Ogni test ha due parti: la risposta (client.post, poi status_code) e il database (sql(...)).
Aiutino 2
Dopo la ricarica la prossima stazione è la numero 7. Puoi scriverlo nel test: risposta.json()["id"].
Aiutino 3
Nel secondo test il database deve avere ancora sei stazioni: 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
Il test che apre la segnalazione 10 è il primo. Gli altri non possono sperare che qualcuno l'abbia aperta: la inseriscono loro.
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
Per chiudere la segnalazione che hai inserito, usa il suo id nell'indirizzo: 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.

Python
@pytest.fixture
def treno_nuovo(sql):
    ...            # inserisce il M30 e restituisce l'id

Come 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
La fixture è come quella degli esercizi spiegati (E): INSERT … RETURNING id e return.
Aiutino 2
Il M30: ("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
Per il terzo test la segnalazione la inserisci tu, dentro il test, con treno_id uguale al parametro treno_nuovo. Poi controlla il 409 e che il treno sia ancora nel database.