Prima il test, se qualcosa va storto
Rossi sbagliati, rossi doppi, controlli che si lamentano
Quello che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai.
Un rosso è normale: nel TDD è il primo passo di ogni giro. La domanda non è «è rosso?» ma «è rosso per il motivo giusto?». Tutti i messaggi qui sotto sono usciti davvero da pytest.
Il rosso giusto e i rossi sbagliati
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
AssertionError: assert None == ['badge vuoto'] | Rosso giusto. La funzione c'è e risponde None (c'è ancora il pass): il test dice cosa manca | Scrivi il codice minimo che lo fa passare |
ModuleNotFoundError: No module named 'badge' e Interrupted: 1 error during collection | Rosso sbagliato. Il test non è nemmeno partito: manca il file, o l'import ha un nome storto | Controlla il nome del file e dell'import. Il rosso vero arriva dopo |
TypeError: argument of type 'NoneType' is not iterable | Rosso sbagliato. Hai scritto assert "badge vuoto" in errori_badge("") e la funzione dà None: in non funziona su None | Un confronto con == dà un rosso più chiaro: assert errori_badge("") == ["badge vuoto"] |
ValueError: not enough values to unpack (expected 4, got 1) | Il codice spacchetta i quattro pezzi prima di controllare che siano quattro | Prima len(pezzi), poi sigla, numero, reparto, cifra = pezzi |
IndexError: string index out of range | Con un badge vuoto, badge[0] non esiste | Controlla il vuoto prima di guardare dentro, oppure usa un taglio: badge[:1] non si ferma mai |
Quando il giro non va
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
| Due test rossi insieme | Hai scritto due test nuovi prima di far passare il primo | Guardane uno solo: pytest storia/test_badge.py::nome_del_test -v. Il secondo lo fai dopo |
| Il test nuovo è verde subito | Il codice faceva già quello che chiedi, oppure il test non prova niente di nuovo | Cambia l'esempio e guarda se diventa rosso. Se non ha un caso nuovo, cancellalo. Se segna un confine utile, tienilo |
| Un test vecchio diventa rosso dopo aver scritto il codice | Il codice nuovo ha rotto una regola già fatta | Non scrivere un altro test: guarda git diff, annulla l'ultima modifica con git restore se serve, e riprova più piccolo |
| Un test diventa rosso mentre pulisci | La pulizia ha cambiato il comportamento | Torna all'ultimo verde (git restore), e rifai il cambiamento in un passo più piccolo |
| Il verde ti sembra «barare» | È giusto così: il codice minimo è proprio questo | Scrivi il test seguente: sarà lui a costringere il codice a diventare vero |
I controlli dello zip
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
I tuoi test in test_badge.py non sono tutti verdi. con sotto Rosso va bene, ma solo per poco: scrivi il codice minimo che lo fa passare. | Hai un test rosso: il controllo del livello 1 aspetta che tutto sia verde | È il rosso del giro. Scrivi il codice che lo fa passare, e poi rilancia |
Prima i tuoi test in test_badge.py devono essere tutti verdi: guarda il primo controllo, quello che dice perché. | I controlli «i tuoi test controllano…» provano i tuoi test su versioni sbagliate, ma prima vogliono i tuoi test verdi | Rendi verdi i tuoi test. Poi guarda il controllo …i_tuoi_test_passano per sapere perché non lo sono |
I tuoi test restano verdi anche se il formato non si controlla più. Manca un test che se ne accorga. | Hai scritto il codice della regola, ma i tuoi test non lo provano: se la regola sparisse, resterebbero verdi | Scrivi un test per il caso che dice il messaggio, con un esempio della tabella delle regole. Rosso, poi verde |
Numeri senza un nome (riga, numero): [(34, 4)] | Alla riga 34 di badge.py c'è un 4 scritto così com'è | Una costante in maiuscolo in cima al file, e al suo posto il nome. Pytest dopo |
Ruff ha qualcosa da dire: ['badge.py:19:5: ANN201 Missing return type annotation for public function …'] | La funzione nuova non ha i tipi | Aggiungi i tipi: def cifra_di_controllo(numero: str) -> int:. Vedi anche ruff check storia/badge.py |
Nomi troppo corti: ['c'] | Una variabile di una o due lettere | Un nome che dice cosa contiene: cifra, non c |
Gli errori che non danno errori
I più difficili sono quelli senza traceback: il test è verde, ma non dovrebbe. In questo capitolo sono quasi sempre uno di questi tre.
Il test che non può diventare rosso. Se un test passa anche con la regola tolta dal codice, non prova niente. Il controllo del livello lo scopre con una versione sbagliata apposta: I tuoi test restano verdi anche se …. Prima di fidarti di un test, chiediti: se cancello la riga del codice, diventa rosso?
Il codice che si ferma al primo errore. Tutti i test provano un errore alla volta, quindi sono verdi. Serve un test con due errori nello stesso badge (livello 6).
Il numero senza nome che passa i test. Un 4 o un 10 scritto a mano funziona benissimo, e Ruff non dice niente. Lo trova il controllo di numeri_magici: la regola è delle sette regole per chi legge.
Se il problema non è il codice
pytest: command not found, No module named pytest, il pannello Testing vuoto: non è il tuo codice, è l'ambiente. Ha una pagina sua nel Pronto soccorso: pytest non parte, o non trova niente. Per lanciare un test solo, o per nome: Lanciare i test.
Non sai se hai rotto qualcosa o se era già rotto? Il debugger si ferma sulla riga e ti mostra i valori: Il debugger e i test. E per tornare all'ultimo verde: Rimettere a posto.