VS Code per Python, le soluzioni
Il ragionamento, i gesti, le trappole
Per ogni missione, sempre lo stesso ordine: in italiano → il codice (qui: i gesti in VS Code e i comandi equivalenti) → le trappole. Per le più difficili, anche il passo per passo.
La tua strada è diversa ma i test sono verdi? Probabilmente va bene: in VS Code spesso ci sono tre modi di fare la stessa cosa (menu, palette dei comandi, scorciatoia). Confronta il risultato, non i gesti.
Le soluzioni complete
La stessa cartella, con il codice al posto di pass. Aprila dopo averci provato: i test sono gli stessi.
I passi 2, 4, 6 e 9 della checklist non hanno missione, quindi non hanno soluzione: li controlli con gli occhi, come dice la palestra.
1 · La cartella giusta
In italiano. Il programma cerca orari.txt nella cartella da cui parte, e il ▶ parte dalla cartella aperta. Quindi bisogna aprire campo, non la cartella sopra.
I gesti.
- Dalla cartella della missione:
code campo. - Apri
dove_sono.pye premi ▶.
Il codice (soluzione.sh, quello che fa il ▶):
cd campo
python3 dove_sono.pyLe trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
python3 campo/dove_sono.py (dalla cartella della missione: è come aprire in VS Code la cartella sopra) | Il programma parte da 01-cartella, non da campo. «Gli orari non li trovo», e traccia.txt dice la cartella sbagliata | test_e_partito_dalla_cartella_del_progetto |
La trappola è subdola perché il programma gira: non c'è nessun errore, solo una cartella diversa. Il sintomo vero è un dato che «non si trova». Il rimedio è sempre lo stesso: guarda il nome in cima all'Explorer.
2 · L'interprete del tabellone
In italiano. Il programma deve essere eseguito dal Python che sta dentro campo/tabellone/.venv, non da quello dell'archivio. In VS Code è la scelta dell'interprete; a mano, è il percorso del Python che metti davanti al nome del file.
I gesti.
code campo/tabellone.- Apri
chi_sono.py. In basso a destra, controlla l'interprete: deve passare pertabellone. Se no: palette dei comandi → Python: Select Interpreter, e il.venvcon il percorso giusto (o Enter interpreter path…). - ▶.
Il codice:
cd campo/tabellone
.venv/bin/python chi_sono.pyLe trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
../archivio/.venv/bin/python chi_sono.py (è scegliere il .venv dell'archivio) | Il programma gira senza errori, ma lo ha eseguito il Python dell'archivio: traccia.txt contiene il suo percorso | test_lo_ha_eseguito_il_venv_del_tabellone |
È la trappola vera di questo capitolo: nell'elenco di Select Interpreter le due voci si chiamano uguale (.venv), e il progetto sbagliato si vede solo dal percorso scritto sotto. Il programma gira lo stesso, e il guaio arriva dopo, quando manca un pacchetto o ce n'è uno di troppo.
3 · Il pannello Testing
In italiano. Il pannello ha bisogno di tre informazioni: usa pytest, non usare unittest, cerca nella cartella aperta. Configure Python Tests le scrive per te nel .vscode/settings.json.
Il codice (il file che VS Code scrive):
{
"python.testing.pytestArgs": [
"."
],
"python.testing.unittestEnabled": false,
"python.testing.pytestEnabled": true
}Passo per passo.
- Testing (la provetta) → Configure Python Tests.
- Primo menu, il framework: pytest. VS Code scrive
pytestEnabled: trueeunittestEnabled: false. - Secondo menu, dove cercare: . Root directory. VS Code scrive
pytestArgs: ["."]: il punto è la cartella aperta. - VS Code crea
.vscode/settings.json(se non c'era) e ci mette le tre righe. - I test compaiono nel pannello: ▶, e due verdi e uno rosso.
Le trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
Scegliere unittest al posto di pytest: pytestEnabled false, unittestEnabled true | unittest non sa cos'è test_biglietti.py (non ha classi): il pannello resta vuoto | test_pytest_e_acceso, test_unittest_e_spento |
"python.testing.pytestArgs": ["tests"] | pytest cerca in una cartella tests che non esiste: il pannello è vuoto, con un errore | test_pytest_cerca_nella_cartella_del_progetto |
Un commento // ... dentro il settings.json | VS Code lo accetta senza fiatare. Il test no: il file non è JSON | test_pytest_e_acceso, test_unittest_e_spento, test_pytest_cerca_nella_cartella_del_progetto |
Le prime due sono i due errori classici del menu Configure Python Tests: si sceglie la riga sbagliata perché sono tutte vicine. Quando il pannello resta vuoto, la prima cosa da fare è aprire .vscode/settings.json e leggere le tre righe.
La terza non è un errore di VS Code: è un errore di chi legge il file con un programma. Lo stesso settings.json con un commento va benissimo per VS Code, e rompe un json.loads.
4 · Il file messo in ordine
In italiano. Format Document dà al file il formato di Ruff. Un formato è una serie di regole fisse; a mano, correggerne solo qualcuna non basta.
I gesti.
code campo, poi apriturni_di_servizio.py.- Tasto destro → Format Document (e Ruff, se te lo chiede).
- Salva.
Il codice (lo stesso formattatore, dal terminale):
cd campo
ruff format turni_di_servizio.py1 file reformattedIl comando ruff c'è nel venv dello zip, perché requirements.txt lo installa. L'estensione di VS Code ha il suo, e non serve il venv: il risultato è lo stesso.
Le trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
tr "'" '"' sul file: cambiare a mano solo le virgolette | Le virgolette sono doppie, ma restano gli spazi sbagliati, le righe vuote mancanti e la riga lunga | test_niente_righe_troppo_lunghe, test_il_file_e_formattato_come_ruff |
Il formato non è «le virgolette giuste»: è tutto insieme, e non si fa a mano. Quello che passa è test_il_programma_fa_ancora_le_stesse_cose: la sostituzione ha lasciato il programma uguale. Un formato che cambia il comportamento è un bug, non un formato.
5 · Formatta quando salvi
In italiano. Servono due impostazioni nel settings.json della cartella: una dice quando formattare (editor.formatOnSave), una dice chi (editor.defaultFormatter dentro il blocco [python]). La riga che c'era già (python.defaultInterpreterPath) deve restare.
Il codice:
{
"python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
"editor.formatOnSave": true,
"[python]": {
"editor.defaultFormatter": "charliermarsh.ruff"
}
}Passo per passo.
- Apri
.vscode/settings.json. C'è una riga sola,python.defaultInterpreterPath. - Dopo quella riga, aggiungi una virgola: ora non è più l'ultima.
- Aggiungi
"editor.formatOnSave": true,. - Aggiungi il blocco
"[python]": tra virgolette, con le quadre, e le graffe con dentro la riga del formattatore. - Dentro il blocco la riga
editor.defaultFormatterè l'ultima: nessuna virgola dopo. Anche il blocco è l'ultima cosa del file: nessuna virgola dopo la graffa che chiude. - Salva, poi prova con un file Python disordinato.
${workspaceFolder} è un segnaposto di VS Code: vuol dire «la cartella aperta». Lo scrive VS Code e lo legge VS Code.
Le trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
| Il file riscritto da zero, senza la riga dell'interprete | Il formato funziona, ma VS Code non sa più quale Python usare in questo progetto: un'impostazione di prima è sparita | test_le_impostazioni_di_prima_ci_sono_ancora |
Il blocco [python] senza editor.formatOnSave | Il formattatore c'è, ma nessuno gli dice di partire al salvataggio: si formatta solo a mano | test_il_formato_al_salvataggio_e_acceso |
Le virgole in più: dopo il blocco [python] e dopo la riga del formattatore | VS Code lo accetta (tollera le virgole finali), un lettore di JSON no: il file non si legge | test_le_impostazioni_di_prima_ci_sono_ancora, test_il_formato_al_salvataggio_e_acceso, test_i_file_python_si_formattano_con_ruff |
La prima è l'errore più frequente: aprire il file, selezionare tutto e incollare quello che hai trovato in rete. Le impostazioni si aggiungono; non si sostituiscono, a meno che tu non sappia cosa c'era.
La terza ti insegna una regola generale: se un programma legge il tuo settings.json e dice «JSON non valido», cerca prima una virgola in più, poi un commento.