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. 68

VS Code per Python, la palestra

Una checklist guidata e cinque missioni

  • 60–90 minuti di lavoro

Qui non si scrive codice: si usa VS Code. La palestra è una checklist di nove passi. Per ognuno trovi cosa fai e cosa devi vedere, con i nomi esatti dei pulsanti (in inglese, come in VS Code). Cinque passi lasciano una traccia sul disco, e per quelli c'è una missione con un test che la guarda.

Gli esercizi da scaricare

Una cartella con i file da completare e i test già pronti. Come si usa: la guida in cinque passi.

banco-vscode.zip15 KB

Prima di iniziare

Scompatta lo zip e segui il README.md che c'è dentro: venv, pip install -r requirements.txt. Se è la prima volta, la pagina Come si usa un esercizio lo fa con te, un comando alla volta. Il venv è spiegato nel capitolo Il venv e pip.

Ogni missione ha la sua cartella in palestra/, con tre file: README.md (la missione), prepara.sh (prepara il campo) e il test. La si fa sempre così:

  1. bash prepara.sh, dalla cartella della missione: crea campo/, il progetto con cui lavori.
  2. Apri il campo con code campo (o code campo/tabellone, il README dice quale) e fai la missione in VS Code.
  3. Torna nel terminale, nella cartella della missione, e lancia pytest -v.
PassoCosaMissione
1Apri la cartella giusta01-cartella ★
2Trustsolo checklist
3Scegli l'interprete02-interprete ★
4Il terminale integratosolo checklist
5Il pannello Testing03-testing ★★
6Le estensioni, anche in WSLsolo checklist
7Format Document con Ruff04-ruff ★★
8Formatta quando salvi05-impostazioni ★★
9Live Sharesolo checklist

Passo 1 · Apri la cartella giusta ★

palestra/01-cartella

La storia. Il programma del tabellone di Piazza Query cerca orari.txt nella cartella da cui parte. Una mattina Lucia Ferri l'ha lanciato con VS Code aperto sulla cartella sbagliata e il tabellone è rimasto vuoto.

Cosa fai.

  1. bash prepara.sh, poi code campo.
  2. Nell'Explorer apri dove_sono.py.
  3. Premi il triangolo ▶ in alto a destra (Run Python File).

Cosa devi vedere.

  • In cima all'Explorer, il nome CAMPO in maiuscolo, e sotto dove_sono.py e orari.txt.
  • Nel terminale in basso, due righe: Sono partito da: con un percorso che finisce con campo, e Gli orari li trovo: orari.txt.
  • Nell'Explorer, un file nuovo: traccia.txt. È la traccia che guarda il test.

Come provi: pytest -v dalla cartella della missione.

Aiutino 1
Il nome in cima all'Explorer deve essere quello della cartella in cui sta orari.txt. Se non è così, hai aperto un'altra cartella.
Aiutino 2
Il comando è code campo, scritto dalla cartella della missione. Se la finestra è già aperta su un'altra cartella: File → Open Folder e scegli campo.

Passo 2 · Trust

Niente missione: è una domanda che VS Code ti fa una volta per cartella.

Cosa fai. Apri una cartella che VS Code non conosce (per esempio un'altra missione, con code campo). Se VS Code ti ha già fatto la domanda per una cartella che contiene quella, può non rifartela.

Cosa devi vedere. Una finestra con la domanda Do you trust the authors of the files in this folder? e due pulsanti: Yes, I trust the authors e No, I don't trust the authors. Scegli il primo: sono i tuoi file.

Il caso opposto. Se hai chiuso la finestra o scelto «No», in basso a sinistra compare Restricted Mode. Cliccaci sopra, poi Trust. Controlla: la scritta sparisce, e l'estensione Python torna accesa.


Passo 3 · Scegli l'interprete ★

palestra/02-interprete

La storia. Sul computer di Piazza Query ci sono due progetti: il tabellone e l'archivio delle vecchie corse. Ognuno ha il suo .venv, e i due si chiamano uguale.

Cosa fai.

  1. bash prepara.sh, poi code campo/tabellone.
  2. Apri chi_sono.py. Guarda in basso a destra: quale Python è scelto?
  3. Se non è il .venv del tabellone: palette dei comandi (Cmd+Shift+P su Mac, Ctrl+Shift+P su Windows/WSL) → Python: Select Interpreter.
  4. Premi ▶.

Cosa devi vedere.

  • Nella barra di stato, in basso a destra, una versione di Python e .venv. Nell'elenco di Select Interpreter, sotto la voce giusta, un percorso che contiene tabellone.
  • Nel terminale, Mi ha eseguito il Python di: seguito da un percorso che finisce con tabellone/.venv.

Come provi: pytest -v.

Aiutino 1
Sotto il nome di ogni interprete nell'elenco c'è il percorso. Cerca quello che passa per tabellone, non per archivio.
Aiutino 2
Non lo trovi nell'elenco? Enter interpreter path…, poi Find…, e vai a prendere bin/python dentro campo/tabellone/.venv.
Aiutino 3
Dopo aver cambiato interprete premi di nuovo ▶: il programma già lanciato non cambia da solo.

Passo 4 · Il terminale integrato

Niente missione: lo controlli con gli occhi.

Cosa fai. Con una delle cartelle aperte e l'interprete .venv scelto, apri un terminale nuovo: View → Terminal. Se ce n'era già uno aperto, chiudilo prima con l'icona del cestino. Poi scrivi:

Terminale
pwd
which python
echo $VIRTUAL_ENV

Cosa devi vedere.

  • Il prompt comincia con (.venv).
  • pwd dice la cartella che hai aperto in VS Code.
  • which python finisce con .venv/bin/python e passa per il tuo progetto; $VIRTUAL_ENV è la cartella .venv del progetto.

Se non è così. Niente (.venv): terminale vecchio, cestino e riapri. Il venv è di un altro progetto: deactivate, cd nella cartella giusta, source .venv/bin/activate.


Passo 5 · Il pannello Testing ★★

palestra/03-testing

La storia. Nel progetto dei biglietti ci sono tre test, ma il pannello Testing è vuoto: nessuno gli ha detto come lanciare i test di questo progetto.

Cosa fai.

  1. bash prepara.sh, poi code campo.
  2. Nella barra a sinistra clicca la provetta (Testing).
  3. Premi Configure Python Tests. VS Code chiede il framework: pytest. Poi la cartella: . Root directory.
  4. Premi ▶ in cima al pannello.

Cosa devi vedere.

  • Dopo la configurazione, nell'albero compare test_biglietti.py con tre test.
  • Dopo ▶: due con la spunta verde, uno con la croce rossa. È rosso apposta: non va riparato.
  • Nell'Explorer, una cartella nuova .vscode con dentro settings.json: la traccia.

Come provi: pytest -v.

Aiutino 1
Il pannello lo trovi nella barra verticale a sinistra: l'icona è una provetta. Se non c'è, l'estensione Python non è accesa: controlla Trust e l'interprete.
Aiutino 2
Le scelte sono due, in quest'ordine: il framework (pytest, non unittest) e la cartella dei test (la prima, il punto).
Aiutino 3
Il pannello è ancora vuoto dopo la configurazione? Refresh Tests, le due frecce in cerchio in cima al pannello.

Passo 6 · Le estensioni, anche in WSL

Niente missione: una passeggiata nel pannello Extensions.

Cosa fai.

  1. Clicca Extensions (i quadratini) e cerca ms-python.python, poi charliermarsh.ruff.
  2. Controlla che siano installate: se no, Install.
  3. Solo su Windows con WSL. Guarda l'angolino in basso a sinistra.

Cosa devi vedere.

  • Python e Ruff nell'elenco Installed.
  • Su Windows con WSL: nell'angolino verde, WSL: Ubuntu. Accanto a Python e Ruff, se non sono ancora dentro Ubuntu, il pulsante Install in WSL: Ubuntu: cliccalo, e aspetta che scompaia.
  • Se la scritta WSL: Ubuntu non c'è: chiudi VS Code, apri il terminale di Ubuntu, cd nel progetto e code ..

Passo 7 · Format Document con Ruff ★★

palestra/04-ruff

La storia. Sergio Colombo ha scritto turni_di_servizio.py di corsa. Funziona, ma nessuno lo vuole rileggere.

Cosa fai.

  1. bash prepara.sh, poi code campo.
  2. Apri turni_di_servizio.py: virgolette miste, spazi a caso, una riga lunghissima.
  3. Tasto destro nel file → Format Document (oppure Shift+Option+F su Mac, Shift+Alt+F su Windows/WSL). Se VS Code chiede quale formattatore usare, scegli Ruff.
  4. Salva.

Cosa devi vedere.

  • Le virgolette diventano tutte doppie, la riga lunga si spezza su più righe, tra le funzioni ci sono due righe vuote.
  • Il programma fa le stesse cose di prima.

Come provi: pytest -v.

Aiutino 1
Il file è lo stesso di cui parla l'esempio E degli esercizi spiegati: lì c'è il «prima» e il «dopo».
Aiutino 2
Non cambia niente? Controlla che l'estensione Ruff sia installata, e che VS Code non abbia scelto un altro formattatore: dal menu Format Document With... scegli Ruff.
Aiutino 3
Il test guarda il file salvato: dopo Format Document, Cmd+S o Ctrl+S. Un pallino accanto al nome del file nella scheda vuol dire «non salvato».

Passo 8 · Formatta quando salvi ★★

palestra/05-impostazioni

La storia. Marta Villa è stufa di dare Format Document a ogni file. Vuole che si sistemi da solo quando salva.

Cosa fai.

  1. bash prepara.sh, poi code campo.
  2. Apri .vscode/settings.json: c'è già una riga, che non va persa.
  3. Aggiungi le due impostazioni: «formatta quando salvi» e «per i file Python il formattatore è Ruff».
  4. Salva il settings.json. Poi apri cartellino.py, scrivi uno spazio in più dove vuoi, salva: si deve sistemare da solo.

Cosa devi vedere.

  • Il settings.json è un JSON: parentesi graffe, righe con chiave e valore, una virgola tra una riga e l'altra, nessuna dopo l'ultima.
  • Salvando cartellino.py lo spazio sparisce.

Come provi: pytest -v. Il test legge il file con un lettore di JSON rigoroso: niente commenti, niente virgole in più, anche se VS Code li tollererebbe.

Aiutino 1
Apri la finestra delle impostazioni (Cmd+, o Ctrl+,), scheda Workspace, e cerca «format on save»: vedrai la casella. Poi guarda cosa è cambiato nel settings.json.
Aiutino 2
Le chiavi sono tre: editor.formatOnSave (vale true), un blocco di nome [python] (tra virgolette, con le parentesi quadre) e, dentro il blocco, editor.defaultFormatter (vale l'id dell'estensione: charliermarsh.ruff).
Aiutino 3
La forma del file: la riga di prima, una virgola, editor.formatOnSave, una virgola, poi [python] con le sue graffe, e dentro una sola riga senza virgola finale. L'ultima riga di un blocco non ha mai la virgola.

Passo 9 · Live Share

Niente missione: serve un compagno. Anche solo una seconda finestra di un browser, per vedere come appare.

Cosa fai.

  1. Nel pannello Extensions installa Live Share (ms-vsliveshare.vsliveshare).
  2. Clicca Live Share nella barra in basso e fai l'accesso con il tuo account, se te lo chiede.
  3. Premi Share.
  4. Manda il link al compagno. Lui lo apre e, quando entra, tu confermi.
  5. Scrivete in due nello stesso file. Poi, da te: Stop Collaboration Session.

Cosa devi vedere.

  • Dopo Share, il link è già negli appunti: incollalo dove vuoi.
  • Quando il compagno entra, il suo nome compare nella barra di stato e il suo cursore (di un altro colore) si muove nel tuo file.
  • Dopo Stop Collaboration Session, il compagno non vede più niente.

Attenzione. Il codice gira sul tuo computer, con il tuo Python: chi guarda non ha bisogno di niente installato, ma vede quello che c'è nella cartella condivisa. Prima di premere Share, controlla che nella cartella non ci siano file che non vuoi mostrare.


Alla fine

Le cinque missioni sono indipendenti: ognuna prepara il suo campo da sola, e puoi farle in qualunque ordine. Dalla cartella dello zip, pytest le prova tutte insieme: quelle non ancora fatte sono rosse, ed è giusto.

Le soluzioni, con le trappole più probabili, sono nella pagina Le soluzioni. Se un passo non fa quello che dice, la pagina Se qualcosa va storto ha la tabella dei sintomi.