Qualcosa non parte?
Respira: quasi sempre è una di queste cose, e quasi sempre si sistema in un minuto.
I casi lunghi
- pytest non parte, o non trova niente · Quasi sempre è il venv, o la cartella
Terminale e setup
command not foundsubito dopo un'installazioneChiudi e riapri il terminale: il PATH si aggiorna solo nei terminali nuovi.
cd: no such file or directoryLa cartella è altrove. Cercala:
find ~ -maxdepth 3 -type d -name nome-cartellapython3 --versiondice meno di 3.12Crea il venv con
python3.12 -m venv .venv(su Ubuntu primasudo apt install python3.12 python3.12-venv).WSL: è tutto lentissimo, Git si confonde con i permessi
Stai lavorando in
/mnt/c. Sposta i progetti dentro Ubuntu, in~(per esempio~/corso).Git apre un editor strano durante un merge o un rebase
Il messaggio è già scritto: salva ed esci. nano:
Ctrl+O, Invio,Ctrl+X. vim:Esc, poi:wqe Invio.unzip: command not foundSu Ubuntu:
sudo apt install unzip. Oppure scompatta da Windows e copia la cartella in Ubuntu.
Il venv e pip
pytest: command not foundIl venv è spento:
source .venv/bin/activate, dalla cartella del progetto. Il caso per intero →No module named pytestIl Python acceso (nel terminale o in VS Code) non è quello del venv del progetto. Il caso per intero →
command not found: fastapiIl venv è spento:
source .venv/bin/activate, poi di nuovofastapi dev.error: externally-managed-environmentStai installando fuori dal venv. Accendilo (il prompt inizia con
(.venv)), poipip install.No module named 'sqlalchemy'(o un'altra libreria nuova)Hai acceso il venv di un altro giorno.
cdnella cartella di oggi,source .venv/bin/activate,pip install -r requirements.txt.No module named 'psycopg'Venv spento, oppure manca
pip install -r requirements.txt.
VS Code
In basso a sinistra c'è scritto
Restricted ModeCliccaci, poi Trust. In modalità ristretta debugger ed estensioni restano spenti.
Il pannello Testing è vuoto
Testing → Configure Python Tests → pytest →
.Root directory. E controlla di aver aperto la cartella giusta. Il caso per intero →F5 apre un menu che chiede
Select debuggerManca
launch.json: Run and Debug → create a launch.json file → Python Debugger → Python File.Il programma non si ferma sul breakpoint
Il breakpoint è su una riga mai eseguita, oppure il file in primo piano è un altro.
Il pallino del breakpoint è grigio e vuoto
Hai avviato un'altra configurazione: scegli quella giusta nel menu di Run and Debug.
Su Windows non compare Python Debugger
L'estensione è installata solo su Windows: Extensions → Install in WSL: Ubuntu.
Su Mac F10 abbassa il volume
fn+F10, oppure i pulsanti della barra del debugger.Debugger su FastAPI:
No module named 'main'Negli
argsdilaunch.jsonmanca"--app-dir", "nome-cartella", o la cartella è scritta male.Ho corretto il codice ma il server risponde come prima
Senza
--reloadil server non riparte da solo: il bottone verde ↻ Restart./docsgira all'infinitoSei fermo su un breakpoint: guarda VS Code e premi ▶ Continue.
pytest
assert None == …C'è ancora
pass, oppureprintal posto direturn:returnconsegna il valore,printlo mostra soltanto.ModuleNotFoundError: No module named '…'(il nome del tuo file)Hai lanciato pytest dalla cartella sbagliata:
cdnella cartella del file, poipytest. Il caso per intero →import file mismatchDue file di test con lo stesso nome in cartelle diverse: lancia pytest dalla cartella del singolo progetto. Il caso per intero →
501nei testNon hai ancora tolto la riga «da fare» (
raise … 501) al posto del livello.Ho modificato il file dei test per sbaglio
git restore test_nomefile.py: torna com'era all'ultimo commit.
Git e GitHub
! [rejected] … (fetch first)Su GitHub c'è un commit che tu non hai:
git pull, poi di nuovogit push.Push rifiutato:
protected branchHai fatto commit su main o sul branch della squadra:
git switch -c tuo-branch, poi push di quel branch.Il pulsante Merge pull request è grigio
Manca l'approvazione, oppure la PR va verso main invece che verso il branch della squadra.
La PR va verso main invece che verso il branch della squadra
Edit accanto al titolo della PR, e cambia la base. Dal terminale:
gh pr create --base nome-branch --fill.Your local changes to the following files would be overwritten by checkoutHai modifiche non salvate. Se ti servono: commit. Se vuoi metterle da parte:
git stash, e dopogit stash pop.untracked working tree files would be overwritten by mergeQualcuno ha committato un file che tu hai ma non tracci (spesso
.vscode): spostalo (mv .vscode /tmp/) e rifai il pull.Nel file compaiono
<<<<<<< HEAD,=======e>>>>>>>È un conflitto: tieni la versione giusta, cancella i tre segni, poi
git addegit commit.You are in 'detached HEAD' stateSei su un commit, non su un branch:
git switch main(o il tuo branch) per tornare.invalid reference: il branch della squadra «non esiste»Il tuo Git non lo conosce ancora:
git fetch, poi riprova.
PostgreSQL
Connection refusedPostgreSQL è spento. WSL:
sudo service postgresql start(ogni mattina). Mac:brew services start postgresql@16.connection failed: … No such file or directory(il socket)WSL:
export PGHOST=/var/run/postgresql. Mac:export PGHOST=/tmp. Poi riaccendi il server.database "…" does not existCrealo e caricalo:
createdb nome, poipsql -d nome -f nome.sql(per i test anchecreatedb nome_test).role "…" does not existWSL:
sudo -u postgres createuser --superuser "$USER".password authentication failedSu WSL
host=localhostpassa dalla rete e chiede la password: non scriverehost, usa il socket.
FastAPI
Address already in useC'è già un server acceso:
Ctrl+Cnell'altro terminale, oppurefastapi dev main.py --port 8001./docsnon si apre da WindowsIl server non è acceso in Ubuntu: lancia
fastapi devnel terminale WSL.422 Unprocessable EntityIl corpo non rispetta lo stampo: leggi
loc(quale campo) emsg(cosa non va) nella risposta.500 Internal Server ErrorL'errore vero è nel terminale del server, non nel browser: leggi il traceback lì, dal basso.
Invalid args for response fieldNel
->della rotta c'è la tabella (TrenoDB): ci va lo stampo di Pydantic (Treno).
Database da Python
the query has … placeholders but … parameters were passedTanti
%squanti valori nella tupla, nello stesso ordine. Un valore solo?(valore,), con la virgola.Il test dice: non è nel database
Manca
db.commit(): il carrello non è stato consegnato.TypeError: … got an unexpected keyword argumentTrenoDB(...)con un nome di campo sbagliato: controllamodelli.py.AttributeError: 'NoneType' object has no attribute …db.get(o ungetsu un dizionario) ha datoNonee sei andato avanti: manca l'ifcon il 404.
Postman e login
Postman:
Could not send request,ECONNREFUSEDIl server è spento, oppure stai usando Postman nel browser: serve l'app desktop.
/loginrisponde422Nel corpo manca
usernameopassword, oppure il Body non è raw → JSON./merisponde401in PostmanAuthorization → Bearer Token →
{{biglietto}}. Oppure il biglietto è scaduto: rifai il login.{{biglietto}}resta rossoLa variabile non esiste: lo script del login non è partito. Scripts → Post-response.
RuntimeError: Manca SECRET_KEYManca il file
.envnella cartella: rifai il comando che genera la chiave.