Programma Lezione 241 di 250 · Progetto finale: rilascialo (impacchetta il tuo progetto)
Progetto finale: rilascialo (impacchetta il tuo progetto)

Scrivere un banco di test

Una cartella tests/ vuota non inganna nessuno. Nel momento in cui un revisore vede dei test veri, succedono due cose: si fida di più del codice, e si fida di più di te, perché i test sono la prova che hai pensato a che cosa significa "giusto". Nel repository vero li farai girare con pytest (un solo comando, visto nella prossima lezione). Ma sotto il cofano, un framework di test non è magia -> è un ciclo che fa girare la tua funzione su input noti e controlla l'uscita. Costruire tu stesso quel ciclo, una volta, toglie il mistero a tutto quanto.

Quindi questa lezione è il testing, insegnato come semplice codice deterministico. Scrivi un piccolo banco:

  • run_checks(fn, cases) -> cases è una lista di coppie (args_tuple, expected). Chiama fn(*args) per ogni caso, confronta il risultato con expected, e restituisci una lista di {"args": args, "ok": bool} che registra quali casi sono passati. Se fn solleva un errore mentre la chiami, quel caso è un fallimento (ok=False), non un crash che fa cadere tutta l'esecuzione -> un vero esecutore di test segnala il fallimento e va avanti.
  • all_pass(results) -> True solo se c'è almeno un risultato e ognuno ha ok=True. Una lista di risultati vuota significa che non è stato verificato niente, quindi non è un successo. È il segnale di "build verde": un solo booleano che dice che tutta la batteria è a posto.

Perché conta la regola dell'"almeno uno": una batteria di test che fa girare in silenzio zero test e riporta un successo è peggio che nessun test, perché dà una falsa sicurezza. Proteggere il caso vuoto è la differenza tra un banco che significa qualcosa e uno che dice sempre sì.

Esempio svolto. Diciamo che il tuo progetto espone add(a, b). Scrivi i casi [((1, 2), 3), ((0, 0), 0), ((5, 5), 10)]. Un sommatore corretto li passa tutti e tre -> all_pass è True. Una versione bacata che sottrae restituisce -1, 0, 0 -> due casi falliscono, all_pass è False, e il tuo banco ha appena beccato una regressione. È tutto il valore dei test in una frase: una funzione corretta e una rotta ti danno risposte diverse, automaticamente.

Costruiscilo con un semplice try/except intorno alla chiamata così una funzione che solleva errori conta come un caso fallito. Premi Run per mettere al banco un sommatore corretto e vedere ogni caso diventare verde.

Tocca a te

Costruisci un banco di test minimo. Scrivi run_checks(fn, cases) dove cases è una lista di (args_tuple, expected): chiama fn(*args) per ciascuno, e restituisci una lista di {"args": args, "ok": bool} che segna quali casi corrispondono a expected (una funzione che solleva errori rende quel caso ok=False, senza crash). Scrivi all_pass(results) che restituisce True solo quando c'è almeno un risultato e ogni ok è True (una lista vuota è False). Una funzione corretta e una bacata devono ricevere verdetti diversi.

Hai notato un problema in questa lezione? Segnalalo · Chiedi qualcosa su questa lezione

Questo esercizio si apre presto

Finisci la lezione precedente e questa si sblocca. L'intero corso è gratuito, senza account, e puoi leggere questa lezione subito.