Lanciare i test, se qualcosa va storto
Quello che leggi, cosa vuol dire, cosa fai
Questo è il capitolo dove ci si blocca di più, e quasi sempre per una riga che non si sa leggere. Qui sotto trovi le righe che vedrai davvero, con quello che vogliono dire.
Prima di tutto, tre domande, sempre nello stesso ordine:
- Dove sono?
pwd, e la rigarootdirdi pytest. - Il venv è acceso? Il prompt comincia con
(.venv)? - Cosa dice l'ultima riga? Si legge dal fondo.
Quando pytest non parte
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
pytest: command not found (bash) · zsh: command not found: pytest | Il venv è spento, o pytest non è installato | source .venv/bin/activate dalla cartella dello zip. Se non basta: pytest non parte, o non trova niente |
No module named pytest | Stai usando un Python senza pytest | Venv acceso? pip install -r requirements.txt. Il caso del pannello Testing: VS Code per Python |
no tests ran e collected 0 items | Nella cartella dove sei non ci sono file test_*.py | pwd, poi cd nella cartella giusta. Non vuol dire «tutto verde» |
ERROR: file or directory not found: test_sconto.py | Il nome del file è scritto male | ls per vedere i nomi veri. Tab completa i nomi |
ERROR: not found: …test_sconti.py::test_sconto_studenti e no match in any of … | Il file c'è, il test con quel nome no | Copia il nome dalla short test summary, o da pytest --collect-only -q |
7 deselected e niente altro | Il tuo -k non ha preso nessun test | Controlla la parola: -k cerca nel nome del test e del file. Prova pytest --collect-only -q per vedere i nomi |
Quando pytest parte ma non legge i file
Sono le E di prima del test. Il segno: ERROR collecting … e, in fondo, Interrupted: 1 error during collection. Non gira nessun test, nemmeno quelli a posto.
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
ImportError: cannot import name 'abbonamento' from 'biglietti' | Il test importa un nome che nel codice non c'è (non ancora scritto, o scritto diverso) | Controlla il nome nel file .py: maiuscole, trattini bassi |
ModuleNotFoundError: No module named 'biglietti' | pytest non trova il file .py da importare: i test stanno in una cartella, il codice in un'altra | Aggiungi al pytest.ini pythonpath = . oppure lancia pytest dalla cartella che contiene il codice |
ModuleNotFoundError: No module named 'fastapi' (o altre librerie) | Il venv acceso non ha quella libreria | pip install -r requirements.txt con il venv acceso |
SyntaxError nella parte ERRORS | Un file ha un errore di scrittura (una parentesi che manca, i due punti dimenticati) | Il traceback dice il file e la riga: Leggere un traceback |
import file mismatch | Due file di test con lo stesso nome in cartelle diverse | Lancia pytest dalla cartella di un progetto solo, o dai un nome diverso a uno dei due file. Il caso lungo: pytest non parte, o non trova niente |
Ecco il caso del ModuleNotFoundError, vero: il codice è in biglietti.py nella cartella principale, i test sono in prove/, e non c'è nessun pytest.ini.
==================================== ERRORS ====================================
___________________ ERROR collecting prove/test_biglietti.py ___________________
ImportError while importing test module '/Users/marta/corso/prova1/prove/test_biglietti.py'.
Hint: make sure your test modules/packages have valid Python names.
Traceback:
/usr/lib/python3.12/importlib/__init__.py:90: in import_module
return _bootstrap._gcd_import(name[level:], package, level)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
prove/test_biglietti.py:1: in <module>
from biglietti import prezzo, resto
E ModuleNotFoundError: No module named 'biglietti'
=========================== short test summary info ============================
ERROR prove/test_biglietti.py
!!!!!!!!!!!!!!!!!!!! Interrupted: 1 error during collection !!!!!!!!!!!!!!!!!!!!
1 error in 0.04sDel traceback ti serve la riga E in fondo e quella sopra, con il file e la riga (prove/test_biglietti.py:1). Le righe con importlib sono interne a Python e cambiano da computer a computer: saltale.
Quando i test partono, e sono rossi
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
F e AssertionError: assert 8.1 == 1.9 | Il test è partito e un confronto è falso | A sinistra quello che dà il codice, a destra quello che vuole il test. Chi ha ragione? Di solito il test |
assert None == 2.2 e where None = prezzo(1) | La funzione non restituisce niente: c'è ancora pass, manca il return, o c'è un print | Un return alla fine della funzione |
assert not True o assert False senza == | Il test voleva un vero o un falso, e il codice ha dato il contrario | La riga where dice quale chiamata ha dato quel valore |
E ? +++ sotto due righe - e + | Due testi che differiscono di poco | - è l'atteso, + è il dato, ? segna le lettere che cambiano |
E e fixture '…' not found | Il test chiede una fixture che nessuno ha preparato (nome scritto male, o mai scritta) | Controlla il nome nel test. Il muro di righe available fixtures non serve: guarda la prima riga E |
Interrupted: … stopping after 1 failures | Hai lanciato -x: si è fermato al primo rosso | È giusto così. Risolvi quello, poi rilancia |
Quando i conti non tornano
| Leggi | Vuol dire | Cosa fai |
|---|---|---|
| Il compagno vede più test di te | Lancia con un argomento (pytest .), o ha un pytest.ini diverso | Confronta le righe configfile e testpaths dell'intestazione, e il comando che avete scritto |
| I test che hai scritto non compaiono | Il file non comincia per test_, o la funzione non comincia per test_ | Rinomina: test_qualcosa.py, def test_qualcosa(): |
| Il pannello Testing non mostra i test che il terminale trova | Il pannello non ha ricaricato, o usa un altro Python | Il pulsante di Refresh nel pannello. Poi l'interprete: VS Code per Python |
| Nel pannello un test è rosso e nel terminale è verde (o viceversa) | Il pannello usa un altro Python o un'altra cartella di partenza | Confronta il Python: pytest non parte, o non trova niente |
| Hai modificato un test per sbaglio | Il test non è più quello originale | In un repository: git restore nome_del_file.py. Fuori da un repository: riprendilo da uno zip appena scompattato |
Gli errori che non danno errori
Il programma gira, il risultato è sbagliato, e pytest non dice niente di strano. Qui sono quasi sempre questi.
Tutto verde, ma i test erano pochi. Hai lanciato -k o un file solo, e hai letto «passed» come «tutto a posto». L'ultima riga ti dice anche quanti ne ha lasciati fuori: 12 deselected.
Un solo rosso, ma è un E. Se la lettera è E, il test non ha provato niente. Il codice può essere giusto o sbagliato: non lo sai.
Ho lanciato i test della cartella sbagliata. Dopo un cd a caso, la riga rootdir è di un altro progetto. Controlla pwd ogni volta che i numeri ti sembrano strani.
Ho corretto il test invece del codice. Un test non si cambia per farlo passare. Il commit è la rete: Il giro di ogni giorno.
Quando il rosso ti sembra incomprensibile, il debugger ti fa vedere cosa succede dentro: Il debugger con FastAPI e con i test.