Vai al contenuto
code-to-code

Apro l'indice…

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

Il progetto4. La cartella del progettop. 131

La cartella del progetto, se qualcosa va storto

Gli errori della cartella e i test rossi della palestra

Gli errori che vedrai di più in questo capitolo. Per ognuno: cosa leggi, cosa vuol dire, cosa fai. In ordine di quando capitano: prima l'ambiente, poi il database, poi il codice.

LeggiVuol direCosa fai
command not found: pytest (o fastapi, pip)Il venv è spento: il terminale non conosce i comandi che hai installatosource .venv/bin/activate, dalla cartella del progetto. Controlla con which python: deve nominare .venv. Se continua: pytest non parte, o non trova niente
ModuleNotFoundError: No module named 'app'Python non trova il pacchetto app/: pytest.ini manca, non ha pythonpath = ., o hai lanciato pytest da un'altra cartellals deve mostrare pytest.ini e app/. Se ci sono, apri il pytest.ini e controlla la riga pythonpath = .
ModuleNotFoundError: No module named 'dotenv' (o fastapi, sqlalchemy, psycopg, httpx)La libreria non è nel venv: venv spento, o manca pip install -r requirements.txtAccendi il venv, poi pip install -r requirements.txt. Se il nome manca dal file, aggiungilo
Path does not exist app/main.py (da fastapi dev)Sei in un'altra cartellacd nella cartella del progetto. fastapi dev app/main.py parte sempre da lì
database "ritrovato" does not exist (dentro un OperationalError)PostgreSQL c'è, ma non il databasecreatedb ritrovato, poi psql -d ritrovato -f schema.sql
connection failed … No such file or directoryPostgreSQL è spento, o psycopg lo cerca nel posto sbagliatoMac: brew services start postgresql@16. Se continua: export PGHOST=/tmp (WSL: /var/run/postgresql)
relation "oggetti" does not exist (UndefinedTable)Il database c'è, ma è vuoto: schema.sql non è mai stato caricatopsql -d ritrovato -f schema.sql
column stazioni.linea does not exist (UndefinedColumn)modelli.py ha una colonna che il database non ha: i due non coincidonoRileggi schema.sql: comanda lui. Aggiungi la colonna lì (e rifai il database) oppure togli la riga dal modello
Could not parse SQLAlchemy URL from given URL stringDATABASE_URL c'è, ma è vuota: nel .env c'è la riga senza il valorecat .env: DATABASE_URL=postgresql+psycopg:///ritrovato, tutto attaccato
null value in column "stato" of relation "oggetti" violates not-null constraint (NotNullViolation)La colonna ha un DEFAULT in schema.sql, ma modelli.py non lo sa: SQLAlchemy ha mandato NULLmapped_column(server_default="in deposito"), con il valore dello schema.sql
Input should be a valid dictionary or instance of Oggetto (model_type)Hai dato a Pydantic un oggetto OggettoDB, e lo stampo di risposta non sa leggere gli attributimodel_config = ConfigDict(from_attributes=True) nello stampo di risposta
Input should be 'ombrelli', 'borse', … (literal_error)Non è un guaio: è lo stampo che fa il suo lavoro. La categoria non è nella listaCorreggi il dato. Se la categoria deve esistere, aggiungila a schema.sql e al Literal
404 Not Found su una rotta di un routerIl router c'è, ma main.py non lo montaapp.include_router(oggetti.router) in main.py. Guarda /docs: se la rotta non compare, non è montata
git status mostra .env o .venv/ tra i file da salvareIl .gitignore manca, o ha una riga scritta maleControlla con git check-ignore -v .env. Se è già stato salvato in un commit: la storia lunga

Nella palestra i test rossi parlano da soli; i più tipici:

Il test diceVuol direCosa fai
Manca httpx: senza, il TestClient di FastAPI non parterequirements.txt non ha tutte le librerieControlla il nome: tutto minuscolo, senza spazi, una libreria per riga
Hai ignorato anche .env.example: il modello deve andare su GitHubNel .gitignore c'è .env* o un modello troppo largoUna riga per il .env, esatta
«…» sembra avere utente e password: nel modello non ci vannoHai copiato il .env veroIl modello ha solo DATABASE_URL=postgresql+psycopg:///prenota_sala
sale: schema.sql ha […], il modello ha […]Le colonne di modelli.py non sono quelle (o non nell'ordine) di schema.sqlUna colonna, una riga, nello stesso ordine. Il messaggio ti mostra le due liste
sale.note: in schema.sql può essere NULL (str | None)Una colonna facoltativa scritta senza | NoneMapped[str | None]
La sessione è rimasta aperta: get_db deve chiuderla alla fineget_db apre la sessione senza il withwith Session(engine) as db: e yield db dentro
NameError: name 'router' is not definedNell'esercizio 8 manca la riga router = …Falla in sale.py, sopra la rotta
PostgreSQL non risponde, quindi i test non possono partirePostgreSQL è spentoMac: brew services start postgresql@16 · WSL: sudo service postgresql start

Gli errori che non danno errori

Il guaio di questo capitolo è il silenzio: il progetto parte, e fa la cosa sbagliata. Quattro modi in cui succede.

Il .env che nessuno legge. Un .env scritto male non dà errori: si usa il valore di riserva. Se il file si chiama env, o .env.txt, o sta in un'altra cartella, load_dotenv() non lo trova. Non si lamenta: database.py usa il valore di riserva. Il programma parte, su un database che forse non è quello che credi. Se il database «sembra vuoto», stampa DATABASE_URL:

Terminale
python -c "from app.database import DATABASE_URL; print(DATABASE_URL)"

I test che scrivono nel tuo database. Se nel conftest.py la riga con os.environ va dopo l'import dell'app, i test girano sul database del tuo .env, e tabelle_come_nuove ne butta le tabelle. Nessun errore: ti accorgi che i dati sono spariti. Controllo semplice: un dato di prova nel tuo database (INSERT), pytest, e il dato c'è ancora.

modelli.py che non copia schema.sql. Una colonna scritta Mapped[str] che nel database è facoltativa non dà nessun errore finché un giorno arriva una riga con NULL. I test della palestra (esercizio 6) fanno proprio questo confronto: nel tuo progetto, rileggi le due cose una accanto all'altra a ogni modifica.

Il .env già finito su Git. Il .gitignore non toglie quello che c'è già. git status non nomina il .env, perché è «già tracciato», ma ogni modifica finisce nei commit. Controllo: git ls-files non deve mai nominare .env. Se lo nomina: git rm --cached .env, e cambia la password (la storia la ricorda).

Se il problema non è la cartella

Connection refused, role "…" does not exist, pg_isready che dice no response: non è la cartella, è PostgreSQL, e se ne parla nel libro Il banco di lavoro. Se pytest non parte o non trova i test, il Pronto soccorso ha la cura.