Vai al contenuto
code-to-code

Apro l'indice…

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

Pronto soccorsopytest

pytest non parte, o non trova niente

Quasi sempre è il venv, o la cartella

Questa pagina è per te se vedi:

  • pytest: command not found
  • zsh: command not found: pytest
  • No module named pytest
  • ModuleNotFoundError: No module named 'prezzo_corsa'
  • No module named 'main'
  • import file mismatch
  • Il pannello Testing di VS Code è vuoto
  • pytest Discovery Error in 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, sqlalchemy

Ogni 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:

Terminale
pwd                       # dove sono?
which python              # quale Python sto usando?
python -m pytest --version
Se vediVuol dire
which python finisce con /.venv/bin/python, e il percorso è quello del progettoIl venv giusto è acceso
which python dice /usr/bin/python o python not foundIl venv è spento
which python punta al .venv di un altro progettoIl venv acceso è quello sbagliato
No module named pytestIn 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.

Terminale
cd ~/progetti/api-orm        # la cartella dove c'è .venv
source .venv/bin/activate                  # il prompt ora inizia con (.venv)
pytest -v

Se 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:

Terminale
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Caso 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.

  1. Cmd+Shift+P (Windows/WSL: Ctrl+Shift+P) → Python: Select Interpreter.
  2. Scegli quello con .venv e il percorso del progetto giusto. Attento: se nella lista ce ne sono più di uno con .venv, guarda il percorso scritto sotto.
  3. Non c'è nella lista? Enter interpreter path… → Find… → vai nella cartella del progetto → .venv/bin/python.
  4. 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):

Terminale
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:

Terminale
cd ~/progetti/api-orm/villa-orm
pytest -v

Caso 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.py

Perché. 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à.

Terminale
deactivate
rm -rf .venv
python3.12 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

La prova del nove

Funziona quando, nello stesso progetto:

  • which python nel terminale finisce con .venv/bin/python della cartella giusta;
  • in basso a destra in VS Code c'è .venv, con 3.12 o più;
  • pytest -v nel 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 install solo con (.venv) nel prompt. Se vedi externally-managed-environment, stai installando fuori dal venv: fermati e accendilo.