Vai al contenuto
code-to-code

Apro l'indice…

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

Pronto soccorso

Qualcosa non parte?

Respira: quasi sempre è una di queste cose, e quasi sempre si sistema in un minuto.

I casi lunghi

Terminale e setup

  • command not found subito dopo un'installazione

    Chiudi e riapri il terminale: il PATH si aggiorna solo nei terminali nuovi.

  • cd: no such file or directory

    La cartella è altrove. Cercala: find ~ -maxdepth 3 -type d -name nome-cartella

  • python3 --version dice meno di 3.12

    Crea il venv con python3.12 -m venv .venv (su Ubuntu prima sudo 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 :wq e Invio.

  • unzip: command not found

    Su Ubuntu: sudo apt install unzip. Oppure scompatta da Windows e copia la cartella in Ubuntu.

Il venv e pip

  • pytest: command not found

    Il venv è spento: source .venv/bin/activate, dalla cartella del progetto. Il caso per intero →

  • No module named pytest

    Il Python acceso (nel terminale o in VS Code) non è quello del venv del progetto. Il caso per intero →

  • command not found: fastapi

    Il venv è spento: source .venv/bin/activate, poi di nuovo fastapi dev.

  • error: externally-managed-environment

    Stai installando fuori dal venv. Accendilo (il prompt inizia con (.venv)), poi pip install.

  • No module named 'sqlalchemy' (o un'altra libreria nuova)

    Hai acceso il venv di un altro giorno. cd nella 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 Mode

    Cliccaci, 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 debugger

    Manca 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 args di launch.json manca "--app-dir", "nome-cartella", o la cartella è scritta male.

  • Ho corretto il codice ma il server risponde come prima

    Senza --reload il server non riparte da solo: il bottone verde ↻ Restart.

  • /docs gira all'infinito

    Sei fermo su un breakpoint: guarda VS Code e premi ▶ Continue.

pytest

  • assert None == …

    C'è ancora pass, oppure print al posto di return: return consegna il valore, print lo mostra soltanto.

  • ModuleNotFoundError: No module named '…' (il nome del tuo file)

    Hai lanciato pytest dalla cartella sbagliata: cd nella cartella del file, poi pytest. Il caso per intero →

  • import file mismatch

    Due file di test con lo stesso nome in cartelle diverse: lancia pytest dalla cartella del singolo progetto. Il caso per intero →

  • 501 nei test

    Non 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 nuovo git push.

  • Push rifiutato: protected branch

    Hai 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 checkout

    Hai modifiche non salvate. Se ti servono: commit. Se vuoi metterle da parte: git stash, e dopo git stash pop.

  • untracked working tree files would be overwritten by merge

    Qualcuno 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 add e git commit.

  • You are in 'detached HEAD' state

    Sei 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 refused

    PostgreSQL è 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 exist

    Crealo e caricalo: createdb nome, poi psql -d nome -f nome.sql (per i test anche createdb nome_test).

  • role "…" does not exist

    WSL: sudo -u postgres createuser --superuser "$USER".

  • password authentication failed

    Su WSL host=localhost passa dalla rete e chiede la password: non scrivere host, usa il socket.

FastAPI

  • Address already in use

    C'è già un server acceso: Ctrl+C nell'altro terminale, oppure fastapi dev main.py --port 8001.

  • /docs non si apre da Windows

    Il server non è acceso in Ubuntu: lancia fastapi dev nel terminale WSL.

  • 422 Unprocessable Entity

    Il corpo non rispetta lo stampo: leggi loc (quale campo) e msg (cosa non va) nella risposta.

  • 500 Internal Server Error

    L'errore vero è nel terminale del server, non nel browser: leggi il traceback lì, dal basso.

  • Invalid args for response field

    Nel -> della rotta c'è la tabella (TrenoDB): ci va lo stampo di Pydantic (Treno).

Database da Python

  • the query has … placeholders but … parameters were passed

    Tanti %s quanti 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 argument

    TrenoDB(...) con un nome di campo sbagliato: controlla modelli.py.

  • AttributeError: 'NoneType' object has no attribute …

    db.get (o un get su un dizionario) ha dato None e sei andato avanti: manca l'if con il 404.

Postman e login

  • Postman: Could not send request, ECONNREFUSED

    Il server è spento, oppure stai usando Postman nel browser: serve l'app desktop.

  • /login risponde 422

    Nel corpo manca username o password, oppure il Body non è raw → JSON.

  • /me risponde 401 in Postman

    Authorization → Bearer Token → {{biglietto}}. Oppure il biglietto è scaduto: rifai il login.

  • {{biglietto}} resta rosso

    La variabile non esiste: lo script del login non è partito. Scripts → Post-response.

  • RuntimeError: Manca SECRET_KEY

    Manca il file .env nella cartella: rifai il comando che genera la chiave.