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.
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ì:
bash prepara.sh, dalla cartella della missione: creacampo/, il progetto con cui lavori.- Apri il campo con
code campo(ocode campo/tabellone, il README dice quale) e fai la missione in VS Code. - Torna nel terminale, nella cartella della missione, e lancia
pytest -v.
| Passo | Cosa | Missione |
|---|---|---|
| 1 | Apri la cartella giusta | 01-cartella ★ |
| 2 | Trust | solo checklist |
| 3 | Scegli l'interprete | 02-interprete ★ |
| 4 | Il terminale integrato | solo checklist |
| 5 | Il pannello Testing | 03-testing ★★ |
| 6 | Le estensioni, anche in WSL | solo checklist |
| 7 | Format Document con Ruff | 04-ruff ★★ |
| 8 | Formatta quando salvi | 05-impostazioni ★★ |
| 9 | Live Share | solo 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.
bash prepara.sh, poicode campo.- Nell'Explorer apri
dove_sono.py. - 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.pyeorari.txt. - Nel terminale in basso, due righe:
Sono partito da:con un percorso che finisce concampo, eGli 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
orari.txt. Se non è così, hai aperto un'altra cartella.Aiutino 2
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.
bash prepara.sh, poicode campo/tabellone.- Apri
chi_sono.py. Guarda in basso a destra: quale Python è scelto? - Se non è il
.venvdel tabellone: palette dei comandi (Cmd+Shift+Psu Mac,Ctrl+Shift+Psu Windows/WSL) → Python: Select Interpreter. - 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 contienetabellone. - Nel terminale,
Mi ha eseguito il Python di:seguito da un percorso che finisce contabellone/.venv.
Come provi: pytest -v.
Aiutino 1
tabellone, non per archivio.Aiutino 2
bin/python dentro campo/tabellone/.venv.Aiutino 3
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:
pwd
which python
echo $VIRTUAL_ENVCosa devi vedere.
- Il prompt comincia con
(.venv). pwddice la cartella che hai aperto in VS Code.which pythonfinisce con.venv/bin/pythone passa per il tuo progetto;$VIRTUAL_ENVè la cartella.venvdel 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.
bash prepara.sh, poicode campo.- Nella barra a sinistra clicca la provetta (Testing).
- Premi Configure Python Tests. VS Code chiede il framework: pytest. Poi la cartella: . Root directory.
- Premi ▶ in cima al pannello.
Cosa devi vedere.
- Dopo la configurazione, nell'albero compare
test_biglietti.pycon tre test. - Dopo ▶: due con la spunta verde, uno con la croce rossa. È rosso apposta: non va riparato.
- Nell'Explorer, una cartella nuova
.vscodecon dentrosettings.json: la traccia.
Come provi: pytest -v.
Aiutino 1
Aiutino 2
Aiutino 3
Passo 6 · Le estensioni, anche in WSL
Niente missione: una passeggiata nel pannello Extensions.
Cosa fai.
- Clicca Extensions (i quadratini) e cerca
ms-python.python, poicharliermarsh.ruff. - Controlla che siano installate: se no, Install.
- 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,
cdnel progetto ecode ..
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.
bash prepara.sh, poicode campo.- Apri
turni_di_servizio.py: virgolette miste, spazi a caso, una riga lunghissima. - Tasto destro nel file → Format Document (oppure
Shift+Option+Fsu Mac,Shift+Alt+Fsu Windows/WSL). Se VS Code chiede quale formattatore usare, scegli Ruff. - 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
Aiutino 2
Aiutino 3
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.
bash prepara.sh, poicode campo.- Apri
.vscode/settings.json: c'è già una riga, che non va persa. - Aggiungi le due impostazioni: «formatta quando salvi» e «per i file Python il formattatore è Ruff».
- Salva il
settings.json. Poi apricartellino.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.pylo 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
Cmd+, o Ctrl+,), scheda Workspace, e cerca «format on save»: vedrai la casella. Poi guarda cosa è cambiato nel settings.json.Aiutino 2
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
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.
- Nel pannello Extensions installa Live Share (
ms-vsliveshare.vsliveshare). - Clicca Live Share nella barra in basso e fai l'accesso con il tuo account, se te lo chiede.
- Premi Share.
- Manda il link al compagno. Lui lo apre e, quando entra, tu confermi.
- 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.