Vai al contenuto
code-to-code

Apro l'indice…

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

Errori e debugger6. Il debugger su FastAPI e nei testp. 152

Il debugger su FastAPI e nei test, se qualcosa va storto

Il server che non parte, il browser che aspetta, lo zip

Due parti. Prima gli errori del capitolo: il server che non parte, il breakpoint che non scatta, /docs che non risponde. Poi quelli dello zip, che non c'entrano con il tuo codice.

Ricorda come si legge un messaggio d'errore: dal basso, l'ultima riga dice che cosa. Se è un traceback, tutto il resto è in Leggere un traceback.

Gli errori del capitolo

LeggiVuol direCosa fai
Error loading ASGI app. Could not import module "main".uvicorn non trova main.py: in launch.json manca --app-dir, oppure punta a una cartella sbagliata (anche solo un gradino sopra o sotto)Negli args: "--app-dir", "palestra/centrale", cioè la cartella che contiene main.py, a partire da quella aperta in VS Code. Prova gli stessi pezzi nel terminale con python -m uvicorn
Error loading ASGI app. Attribute "x" not found in module "main".Il file c'è, ma dopo i due punti hai scritto un nome che non esisteDopo main: ci va il nome della variabile con FastAPI(): di solito app
Usage: python -m uvicorn [OPTIONS] APP e Missing argument 'APP'Negli args manca main:appAggiungilo come primo pezzo
address already in use (con Errno 48 o Errno 98)C'è già un server su quella portaSpegnilo: Ctrl+C nel terminale dove gira, oppure ■ Stop · Shift+F5. Poi di nuovo il triangolo verde
/docs gira all'infinito, la richiesta non finisceIl server è fermo su un breakpoint, e aspetta teGuarda VS Code: c'è la riga gialla. Leggi VARIABLES, poi ▶ Continue · F5 (su Mac fn+F5), tante volte quante servono
Il breakpoint non scatta, /docs risponde subitoLa richiesta non passa da quella riga: un if precedente la scavalca (un 404, un ciclo con la lista vuota)Guarda cosa ha risposto /docs. Sposta il pallino prima, oppure scegli un parametro per cui la riga viene eseguita
Il pallino è grigio e vuotoIl debugger non è attivo, o la riga non è codice (un commento, una riga vuota)Accendi il server con il triangolo verde. Sposta il pallino su una riga con del codice
Ho corretto ma risponde come primaSenza --reload il server tiene in memoria il codice vecchio↻ Restart · Cmd+Shift+F5 (Windows: Ctrl+Shift+F5)
Con --reload nei args i breakpoint non scattano, o spariscono dopo un salvataggioIl server gira in un secondo processo, che si riavvia a ogni modificaTogli --reload dagli args
F5 non parte il server, ma esegue il file apertoÈ selezionato Il file aperto nel menu di Run and Debug, non la configurazione del serverNel menu in alto, accanto al triangolo, scegli la configurazione con uvicorn
F5 chiede Select debuggerVS Code non vede .vscode/launch.json: è aperto su un'altra cartellaFile → Open Folder → proprio la cartella dello zip
Il pannello Testing è vuoto, o il test non si fermaVS Code usa un altro Python, o pytest non è acceso per quella cartellaPython: Select Interpreter → quello con .venv. Poi guarda il Pronto soccorso
assert 4.5 == 6 (o simili) senza nessun tracebackIl test è rosso per un valore, non per un errore: il codice gira ma sbagliaÈ il caso di Debug Test: il pallino dove nasce il valore, poi VARIABLES. Il metodo è in I bug silenziosi
Debug Test si ferma sul test e non sul codiceIl pallino è nel test, e non dentro main.pyMetti il pallino nella riga della rotta, o della funzione che il test chiama
Le estensioni Python e Python Debugger non ci sono (Windows con WSL)Sono installate in Windows, non in UbuntuDal pannello delle estensioni: Install in WSL: Ubuntu. In basso a sinistra deve esserci WSL: Ubuntu

Gli errori dello zip

LeggiVuol direCosa fai
Manca la risposta: al posto di None scrivi la tua.In risposte.py c'è ancora NoneScrivi la tua risposta al posto di None (un numero, senza virgolette)
Non è questo. La riga gialla non è ancora stata eseguita…La tua risposta non è quella: è un consiglio, non il valore giustoRifai la prova, guarda VARIABLES alla fermata giusta, e leggi prima della riga gialla
l'hai modificato? Riprendilo dallo zip, così com'era.Hai cambiato la riga con il triangolo ◀ in main.py, o l'hai cancellata: il test non la trova piùRimettila com'era. Il commento con ◀ non va tolto. Se il file non è più riconoscibile, riprendi main.py dallo zip
Su quella riga il programma si ferma 2 volte, non 3Il test non riesce a fermarsi dove si aspetta: i dati di SEGNALAZIONI, il for o la riga con ◀ sono cambiatiCome sopra: riprendi main.py dallo zip, e rifai l'esercizio 3 da lì.
In launch.json non c'è ancora una configurazione con "module": "uvicorn".La configurazione non c'è, o l'hai scritta con "program" invece di "module"Dentro la lista configurations, un blocco nuovo con "module": "uvicorn"
Manca "--app-dir" o La cartella di --app-dir non è quella che contiene main.pyLa cartella negli args non è palestra/centraleScrivila come percorso dalla cartella dello zip: palestra/centrale
Togli "--reload"C'è ancora --reload negli argsToglilo, con la virgola che lo precede
Prima di correggere, sopra la riga: # BUG: …Manca il commento, oppure comincia con #BUG senza spazio, o con un altro testoUna riga che comincia con # BUG:, uno spazio, e il perché
pytest: command not foundIl venv è spentosource .venv/bin/activate, dalla cartella dello zip
ModuleNotFoundError: No module named 'fastapi'FastAPI non è installato nel venvCon il venv acceso: pip install -r requirements.txt
No module named 'risposte'Hai lanciato pytest da un'altra cartellacd nella cartella dello zip, poi di nuovo pytest

Gli errori che non danno errori

launch.json si scrive, il server parte, e sembra tutto a posto. Ma il pallino resta grigio e non succede niente. Controlla tre cose, nell'ordine: stai guardando la configurazione giusta nel menu (non «Il file aperto»)? Dentro gli args c'è --reload? La richiesta passa davvero dalla riga dove hai messo il pallino?

Il test passa, ma il debugger non si è mai fermato. Il test non passava da lì. Metti un print provvisorio nella riga, o un pallino più in alto, e rilancia.

Ho fatto Restart, ma la risposta è quella di prima. Il browser ti sta rimostrando la risposta vecchia. Premi di nuovo Execute in /docs: non ricarica da solo.

Se il problema non è il codice

pytest: command not found, il pannello Testing vuoto, F5 che chiede Select debugger, il breakpoint che non si ferma, /docs che gira all'infinito: sono cure brevi nel Pronto soccorso. E se pytest non parte proprio: pytest non parte, o non trova niente.