Vai al contenuto
code-to-code

Apro l'indice…

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

Il banco di lavoro3. VS Code per Pythonp. 74

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.

banco-vscode-soluzioni.zip17 KB

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.

  1. Dalla cartella della missione: code campo.
  2. Apri dove_sono.py e premi ▶.

Il codice (soluzione.sh, quello che fa il ▶):

Terminale
cd campo
python3 dove_sono.py

Le trappole.

Il codice sbagliatoCosa succedeIl 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 sbagliatatest_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.

  1. code campo/tabellone.
  2. Apri chi_sono.py. In basso a destra, controlla l'interprete: deve passare per tabellone. Se no: palette dei comandi → Python: Select Interpreter, e il .venv con il percorso giusto (o Enter interpreter path…).
  3. ▶.

Il codice:

Terminale
cd campo/tabellone
.venv/bin/python chi_sono.py

Le trappole.

Il codice sbagliatoCosa succedeIl 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 percorsotest_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):

JSON
{
    "python.testing.pytestArgs": [
        "."
    ],
    "python.testing.unittestEnabled": false,
    "python.testing.pytestEnabled": true
}

Passo per passo.

  1. Testing (la provetta) → Configure Python Tests.
  2. Primo menu, il framework: pytest. VS Code scrive pytestEnabled: true e unittestEnabled: false.
  3. Secondo menu, dove cercare: . Root directory. VS Code scrive pytestArgs: ["."]: il punto è la cartella aperta.
  4. VS Code crea .vscode/settings.json (se non c'era) e ci mette le tre righe.
  5. I test compaiono nel pannello: ▶, e due verdi e uno rosso.

Le trappole.

Il codice sbagliatoCosa succedeIl test rosso
Scegliere unittest al posto di pytest: pytestEnabled false, unittestEnabled trueunittest non sa cos'è test_biglietti.py (non ha classi): il pannello resta vuototest_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 erroretest_pytest_cerca_nella_cartella_del_progetto
Un commento // ... dentro il settings.jsonVS Code lo accetta senza fiatare. Il test no: il file non è JSONtest_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.

  1. code campo, poi apri turni_di_servizio.py.
  2. Tasto destro → Format Document (e Ruff, se te lo chiede).
  3. Salva.

Il codice (lo stesso formattatore, dal terminale):

Terminale
cd campo
ruff format turni_di_servizio.py
1 file reformatted

Il 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 sbagliatoCosa succedeIl test rosso
tr "'" '"' sul file: cambiare a mano solo le virgoletteLe virgolette sono doppie, ma restano gli spazi sbagliati, le righe vuote mancanti e la riga lungatest_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:

JSON
{
    "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
    "editor.formatOnSave": true,
    "[python]": {
        "editor.defaultFormatter": "charliermarsh.ruff"
    }
}

Passo per passo.

  1. Apri .vscode/settings.json. C'è una riga sola, python.defaultInterpreterPath.
  2. Dopo quella riga, aggiungi una virgola: ora non è più l'ultima.
  3. Aggiungi "editor.formatOnSave": true,.
  4. Aggiungi il blocco "[python]": tra virgolette, con le quadre, e le graffe con dentro la riga del formattatore.
  5. 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.
  6. 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 sbagliatoCosa succedeIl test rosso
Il file riscritto da zero, senza la riga dell'interpreteIl formato funziona, ma VS Code non sa più quale Python usare in questo progetto: un'impostazione di prima è sparitatest_le_impostazioni_di_prima_ci_sono_ancora
Il blocco [python] senza editor.formatOnSaveIl formattatore c'è, ma nessuno gli dice di partire al salvataggio: si formatta solo a manotest_il_formato_al_salvataggio_e_acceso
Le virgole in più: dopo il blocco [python] e dopo la riga del formattatoreVS Code lo accetta (tollera le virgole finali), un lettore di JSON no: il file non si leggetest_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.