pytest non parte, o non trova niente
Quasi sempre è il venv, o la cartella
Questa pagina è per te se vedi:
pytest: command not foundzsh: command not found: pytestNo module named pytestModuleNotFoundError: No module named 'prezzo_corsa'No module named 'main'import file mismatch- Il pannello Testing di VS Code è vuoto
pytest Discovery Errorin VS Code
Hai scritto il codice, lanci i test, e invece dei pallini rossi e verdi arriva un errore che non parla del tuo codice. Respira: il codice probabilmente va bene. Il problema è dove stai lanciando pytest, o con quale Python.
Il disegno: tre Python sullo stesso computer
/usr/bin/python3 il Python del sistema niente pytest
~/progetti/api-db/.venv/bin/python il venv di un progetto pytest, fastapi, psycopg
~/progetti/api-orm/.venv/bin/python il venv di un altro pytest, fastapi, sqlalchemyOgni venv è una scatola con dentro il suo Python e le sue librerie. pytest esiste solo nelle scatole dove l'hai installato. Il terminale e VS Code, ognuno per conto suo, scelgono una scatola. Se scelgono quella sbagliata, pytest non c'è, o non trova le librerie.
Prima di tutto: la diagnosi in tre comandi
Nel terminale dove lanci pytest:
pwd # dove sono?
which python # quale Python sto usando?
python -m pytest --version| Se vedi | Vuol dire |
|---|---|
which python finisce con /.venv/bin/python, e il percorso è quello del progetto | Il venv giusto è acceso |
which python dice /usr/bin/python o python not found | Il venv è spento |
which python punta al .venv di un altro progetto | Il venv acceso è quello sbagliato |
No module named pytest | In questo venv pytest non è installato |
Caso 1 · Nel terminale: pytest: command not found
Perché. Il venv è spento. Succede a ogni terminale nuovo: il venv non resta acceso da solo.
La cura.
cd ~/progetti/api-orm # la cartella dove c'è .venv
source .venv/bin/activate # il prompt ora inizia con (.venv)
pytest -vSe source risponde No such file or directory, in quella cartella il venv non c'è: o sei nella cartella sbagliata (ls -a per vedere se c'è .venv), o non l'hai ancora creato:
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtCaso 2 · Nel terminale: No module named pytest (ma il venv è acceso)
Perché. Il venv è acceso, ma è quello di un altro progetto, oppure è nuovo e vuoto.
La cura. Guarda which python: se è il venv giusto, mancano le librerie (pip install -r requirements.txt). Se è un altro venv: deactivate, poi cd nella cartella giusta e source .venv/bin/activate.
Caso 3 · In VS Code: la provetta è vuota, o dice No module named pytest
È il caso che fa perdere più tempo, perché nel terminale magari funziona tutto.
Perché. VS Code non usa il Python del terminale: ne sceglie uno suo, l'interprete. Se l'interprete non è il .venv del progetto, il pannello Testing non trova pytest, il debugger non trova FastAPI, e l'editor sottolinea gli import in giallo.
Come te ne accorgi. Apri un file .py e guarda in basso a destra: c'è scritta una versione di Python. Se accanto non c'è .venv, l'interprete è sbagliato.
La cura.
Cmd+Shift+P(Windows/WSL:Ctrl+Shift+P) → Python: Select Interpreter.- Scegli quello con
.venve il percorso del progetto giusto. Attento: se nella lista ce ne sono più di uno con.venv, guarda il percorso scritto sotto. - Non c'è nella lista? Enter interpreter path… → Find… → vai nella cartella del progetto →
.venv/bin/python. - Nel pannello Testing, il pulsante Refresh Tests (le due frecce in cerchio).
Se il pannello è ancora vuoto: mancano le impostazioni dei test. Pannello Testing → Configure Python Tests → pytest → . Root directory.
Caso 4 · VS Code è aperto sulla cartella sbagliata
Il sintomo. A sinistra, nell'elenco dei file, vedi una cartella con dentro tanti progetti invece della cartella su cui lavori. I test non vengono trovati, o ne vengono trovati troppi, e qualcuno dà errore.
Perché. VS Code cerca il venv e i test a partire dalla cartella che hai aperto. Se hai aperto progetti ma il venv è in api-orm/.venv, può non trovarlo, o sceglierne un altro.
La cura. Apri proprio la cartella del progetto (o dell'esercizio):
cd ~/progetti/api-orm
code .oppure File → Open Folder → api-orm. In basso a destra, poi, controlla che ci sia .venv.
Caso 5 · ModuleNotFoundError: No module named 'main' (o il nome del tuo file)
Perché. Il test fa from main import app, e Python cerca main.py a partire dalla cartella in cui lanci pytest. Se lanci dalla cartella sbagliata, non lo trova.
La cura. Lancia pytest dalla cartella che contiene il file del test, o dalla radice dell'esercizio se c'è un pytest.ini:
cd ~/progetti/api-orm/villa-orm
pytest -vCaso 6 · import file mismatch
import file mismatch:
imported module 'test_main' has this __file__ attribute:
.../api-db/villa-db/test_main.py
which is not the same as the test file we want to collect:
.../api-orm/villa-orm/test_main.pyPerché. Hai lanciato pytest (o VS Code l'ha fatto per te) da una cartella che contiene due file di test con lo stesso nome in posti diversi. Per Python sono lo stesso modulo, e si confonde.
La cura. Lancia pytest dalla cartella del singolo progetto (cd villa-orm, poi pytest), e apri in VS Code solo quella cartella o quella del progetto.
Caso 7 · Su Windows: in WSL va, in VS Code no
Perché. L'estensione Python è installata su Windows ma non dentro Ubuntu, oppure VS Code non è collegato a WSL.
La cura. In basso a sinistra deve esserci WSL: Ubuntu. Se non c'è: chiudi VS Code, apri il terminale di Ubuntu, cd nella cartella, code .. Poi nel pannello Extensions, accanto a Python, se c'è il pulsante Install in WSL: Ubuntu, cliccalo.
Caso 8 · Il venv ha la versione di Python sbagliata
Il sintomo. In basso a destra c'è .venv, ma con 3.10; oppure un SyntaxError su codice che al compagno funziona, per esempio una f-string con le virgolette dentro, f"{treno["codice"]}", che è valida solo dal 3.12.
Perché. Il venv nasce con il Python che lo crea. Se python3 è ancora il 3.10 di Ubuntu, il venv è 3.10 per sempre.
La cura. Il venv non si aggiusta: si butta e si rifà.
deactivate
rm -rf .venv
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txtLa prova del nove
Funziona quando, nello stesso progetto:
which pythonnel terminale finisce con.venv/bin/pythondella cartella giusta;- in basso a destra in VS Code c'è
.venv, con 3.12 o più; pytest -vnel terminale e la provetta di VS Code mostrano gli stessi test.
Per non ricascarci
- Un venv per cartella di progetto, e VS Code aperto su quella cartella.
- A ogni terminale nuovo, il primo comando è
source .venv/bin/activate. pip installsolo con(.venv)nel prompt. Se vediexternally-managed-environment, stai installando fuori dal venv: fermati e accendilo.