Il venv e pip, le soluzioni
I comandi, il ragionamento, le trappole
Per ogni missione, sempre lo stesso ordine: in italiano → i comandi → le trappole. Per le più difficili, anche il passo per passo.
Nello zip delle soluzioni, accanto a ogni prepara.sh c'è un soluzione.sh con i comandi della missione fatta. Per provarlo: bash prepara.sh, poi bash soluzione.sh, poi pytest -v: verde.
I comandi qui sotto sono quelli che scrivi tu nel terminale, dentro campo/tabellone/. Nel soluzione.sh c'è in più una riga all'inizio che porta lo script nella cartella giusta.
Le soluzioni complete
La stessa cartella, con il codice al posto di pass. Aprila dopo averci provato: i test sono gli stessi.
La palestra
1 · Un venv per il tabellone
In italiano. Entro nella cartella del progetto (quella con requirements.txt), controllo che Python sia il 3.12, e creo il venv con il nome .venv.
cd campo/tabellone
python3 --version
python3 -m venv .venv
ls -aLe trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
cd campo e poi python3 -m venv .venv | Il venv nasce in campo/, accanto alla cartella del progetto invece che dentro. Il progetto resta senza venv | test_il_venv_e_nella_cartella_del_progetto |
python3 -m venv venv (senza punto) | Il venv c'è, ma si chiama venv: VS Code, il .gitignore e i comandi del corso cercano .venv | test_il_venv_e_nella_cartella_del_progetto |
Il venv va accanto al requirements.txt: è lì che ogni strumento lo cerca. E si chiama .venv per convenzione: il punto lo nasconde a ls e lo mette nel .gitignore standard.
2 · Accendi il venv
In italiano. Accendo il venv. Con il venv acceso scrivo in dove.txt il Python che risponde. Poi lancio chi_sono.py e spengo.
cd campo/tabellone
source .venv/bin/activate
which python > dove.txt
python chi_sono.py
deactivateLe trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
Niente source: which python > dove.txt e python3 chi_sono.py | Risponde il Python del computer, non quello del progetto: la traccia dice un altro sys.prefix | test_chi_sono_lo_ha_eseguito_il_venv |
source, which python > dove.txt, deactivate, poi python chi_sono.py | Il venv era acceso quando hai guardato, ma l'hai spento prima di lanciare il programma | test_chi_sono_lo_ha_eseguito_il_venv |
Il secondo è il più sottile: dove.txt è giusto, e il test sul file passa. Ma chi_sono.py va lanciato con il venv acceso: deactivate va per ultimo.
3 · Riempi il venv
In italiano. Accendo il venv e dico a pip di leggere l'elenco, con -r. pip installa tutto, alle versioni scritte. pip list serve a controllare. Spengo.
cd campo/tabellone
source .venv/bin/activate
pip install -r requirements.txt
pip list
deactivatePasso per passo.
| Comando | Cosa succede | Dentro il venv |
|---|---|---|
source .venv/bin/activate | Il terminale usa il Python del progetto | Solo pip |
pip install -r requirements.txt | pip legge due righe e installa le due librerie | python-dotenv 1.2.4, tabulate 0.9.0 |
pip list | Controllo | Le due librerie e pip |
deactivate | Spengo | Il venv non cambia |
Le trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
pip install requirements.txt (senza -r) | pip cerca una libreria che si chiama requirements.txt e non la trova: non installa niente | test_python_dotenv_e_nel_venv_alla_versione_giusta |
pip install python-dotenv==1.2.4 (una sola) | tabulate manca: tabellone.py non parte | test_tabulate_e_nel_venv_alla_versione_giusta |
pip install python-dotenv==1.0.1 tabulate==0.9.0 | Le librerie ci sono, ma una è alla versione sbagliata: l'elenco dice 1.2.4 | test_python_dotenv_e_nel_venv_alla_versione_giusta |
La terza è il motivo per cui l'elenco ha le versioni: «una libreria installata» non basta, serve quella. Con -r non sbagli.
4 · Scrivi il requirements.txt
In italiano. Leggo l'inizio di tabellone.py per sapere cosa importa. Con il venv acceso installo le due librerie (il nome per pip di dotenv è python-dotenv). Poi pip freeze dice l'elenco con le versioni, e > lo scrive nel file.
cd campo/tabellone
source .venv/bin/activate
head tabellone.py
pip install python-dotenv tabulate
pip freeze > requirements.txt
cat requirements.txt
deactivatePasso per passo.
| Comando | Cosa succede | Cosa c'è di nuovo |
|---|---|---|
head tabellone.py | Mostra le prime righe: from dotenv …, from tabulate … | Sai cosa installare |
pip install python-dotenv tabulate | Installa due librerie in un comando solo | Le librerie nel venv |
pip freeze > requirements.txt | L'elenco finisce nel file | requirements.txt, due righe con == |
cat requirements.txt | Controllo | Le due righe |
Le trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
pip freeze senza > requirements.txt | L'elenco passa sullo schermo e sparisce: nessun file | test_il_requirements_nomina_le_due_librerie_con_la_versione |
pip freeze > requirements.txt prima di installare | Il venv era vuoto: il file nasce vuoto, e sembra tutto a posto | test_il_requirements_nomina_le_due_librerie_con_la_versione |
cd .. e poi pip freeze > requirements.txt | Il file nasce in campo/, non accanto a tabellone.py | test_il_requirements_nomina_le_due_librerie_con_la_versione |
Una trappola in più, che il test non può simulare: deactivate prima di pip freeze. Il file si scrive, ma con l'elenco del Python del computer, non del progetto. Se il tuo requirements.txt è lunghissimo e pieno di cose che non conosci, è andata così.
5 · Buttalo e rifallo
In italiano. Guardo il venv rotto, lo butto del tutto, ne creo uno nuovo con il Python di adesso, lo accendo e lo riempio dall'elenco.
cd campo/tabellone
ls -a
rm -rf .venv
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
deactivatePasso per passo.
| Comando | Cosa succede | Il venv |
|---|---|---|
ls -a | Si vede .venv, accanto a requirements.txt | Rotto: il suo Python è di un 3.9 che non c'è più |
rm -rf .venv | Cancella la cartella con tutto dentro | Non c'è più |
python3 -m venv .venv | Crea un venv nuovo con il Python di adesso | Nuovo, vuoto, 3.12 |
source .venv/bin/activate | Lo accende | Acceso |
pip install -r requirements.txt | Rimette le due librerie | Pieno, alle versioni giuste |
deactivate | Spegne | — |
Le trappole.
| Il codice sbagliato | Cosa succede | Il test rosso |
|---|---|---|
rm -rf .venv e python3 -m venv .venv, e basta | Il venv è nuovo e sano, ma vuoto: le librerie non tornano da sole | test_le_librerie_sono_tornate_nel_venv |
cd .. e poi python3 -m venv .venv, pip install -r tabellone/requirements.txt | Il venv nuovo nasce nella cartella sopra: quello rotto resta dov'era | test_il_venv_non_e_piu_quello_vecchio |
Hai provato solo python3 -m venv .venv sopra quello rotto, senza rm? Su questo computer di prova ha riparato il venv. Ma non è una cura da copiare: non sai quali pezzi vecchi restano. rm -rf .venv prima ti dà la certezza.
La storia · Il computer del collega
Per ogni schermata: la diagnosi, la cura (con la lettera da scrivere in risposte.txt), e come riconoscerla.
| # | Cosa leggi | Diagnosi | La cura | Lettera |
|---|---|---|---|---|
| 1 | ERROR: Could not open requirements file … 'requirements.txt' | Tommaso è in corso/, non in corso/tabellone/: pip cerca il file nella cartella dove sei, e lì non c'è | cd tabellone, poi rifare pip install -r requirements.txt | d |
| 2 | source: no such file or directory: .venv/bin/activate | Nella cartella giusta (c'è tabellone.py) manca .venv: ls -a non lo mostra. Il venv non è mai stato creato | python3 -m venv .venv, poi source .venv/bin/activate | e |
| 3 | ModuleNotFoundError: No module named 'dotenv' | Il venv è acceso ((.venv)), ma vuoto: nessuno ha installato le librerie | pip install -r requirements.txt | p |
| 4 | zsh: command not found: pytest | Il venv c'è (.venv nell'elenco) ma il prompt non ha (.venv): è spento, e pytest sta lì dentro | source .venv/bin/activate | o |
| 5 | SyntaxError: f-string: unmatched '[', con Python 3.9.6 sopra | Il codice è giusto per il 3.12, che accetta le virgolette uguali dentro una f-string. Il venv è nato con il 3.9 di Apple e non le capisce | rm -rf .venv, python3.12 -m venv .venv, riaccendere e reinstallare | s |
| 6 | which python dice …/biglietteria/.venv/bin/python | Il prompt ha (.venv), ma è il venv di un altro progetto, rimasto acceso da quando Tommaso lavorava alla biglietteria | deactivate, cd nel tabellone (già lì), source .venv/bin/activate | i |
| 7 | cat requirements.txt non stampa niente; pip install -r non stampa niente (a parte l'avviso su pip); poi No module named 'dotenv' | Due guai: il file requirements.txt è vuoto (qualcuno ha fatto pip freeze > su un venv vuoto) e quindi pip install -r non ha niente da installare, e non protesta | Installare a mano (pip install python-dotenv tabulate: il nome di dotenv per pip è python-dotenv) e riscrivere l'elenco con pip freeze > requirements.txt | t |
| 8 | command not found: pytest, poi pip3 install pytest dà externally-managed-environment | Due guai con la stessa radice: venv spento, quindi pytest non c'è; e pip3 è quello di Homebrew, che non lascia installare. Il venv c'è (.venv) | source .venv/bin/activate: poi pytest c'è già, o si installa nel venv | o |
La parola è la sequenza delle lettere: d, e, p, o, s, i, t, o. La o torna due volte (schermate 4 e 8): è il guaio più frequente di tutto il capitolo, ed è giusto che torni. python verifica.py con la parola chiude la storia.
Le trappole. Le cure sbagliate più probabili:
| La risposta sbagliata | Perché sembra giusta, e perché no | Il test rosso |
|---|---|---|
2 = d (cd nella cartella giusta) | In effetti ls -a mostra che Tommaso è già nella cartella del progetto: il guaio è che manca il venv | test_livello_2_source_non_trova_il_venv |
4 = a (installare pytest con pip) | Senza venv acceso pip installerebbe nel Python del computer, e comunque non è il Python del progetto: pytest c'è già, nel venv | test_livello_4_pytest_non_si_trova |
5 = l (reinstallare Python) | Il Python 3.12 c'è già: è il venv a essere vecchio, non il computer | test_livello_5_errore_di_sintassi_con_il_python_vecchio |
7 = p (pip install -r) | È la cura giusta per la schermata 3, ma qui l'elenco è vuoto: l'ha già provata, e non ha cambiato niente | test_livello_7_il_requirements_e_vuoto |
8 = a (installare pytest con pip) | È proprio quello che ha provato, ed è l'errore che vedi | test_livello_8_pip_fuori_dal_venv |