Vai al contenuto
code-to-code

Apro l'indice…

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

Il banco di lavoro2. Il venv e pipp. 49

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.

banco-venv-e-pip-soluzioni.zip28 KB

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.

Terminale
cd campo/tabellone
python3 --version
python3 -m venv .venv
ls -a

Le trappole.

Il codice sbagliatoCosa succedeIl test rosso
cd campo e poi python3 -m venv .venvIl venv nasce in campo/, accanto alla cartella del progetto invece che dentro. Il progetto resta senza venvtest_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 .venvtest_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.

Terminale
cd campo/tabellone
source .venv/bin/activate
which python > dove.txt
python chi_sono.py
deactivate

Le trappole.

Il codice sbagliatoCosa succedeIl test rosso
Niente source: which python > dove.txt e python3 chi_sono.pyRisponde il Python del computer, non quello del progetto: la traccia dice un altro sys.prefixtest_chi_sono_lo_ha_eseguito_il_venv
source, which python > dove.txt, deactivate, poi python chi_sono.pyIl venv era acceso quando hai guardato, ma l'hai spento prima di lanciare il programmatest_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.

Terminale
cd campo/tabellone
source .venv/bin/activate
pip install -r requirements.txt
pip list
deactivate

Passo per passo.

ComandoCosa succedeDentro il venv
source .venv/bin/activateIl terminale usa il Python del progettoSolo pip
pip install -r requirements.txtpip legge due righe e installa le due libreriepython-dotenv 1.2.4, tabulate 0.9.0
pip listControlloLe due librerie e pip
deactivateSpengoIl venv non cambia

Le trappole.

Il codice sbagliatoCosa succedeIl test rosso
pip install requirements.txt (senza -r)pip cerca una libreria che si chiama requirements.txt e non la trova: non installa nientetest_python_dotenv_e_nel_venv_alla_versione_giusta
pip install python-dotenv==1.2.4 (una sola)tabulate manca: tabellone.py non partetest_tabulate_e_nel_venv_alla_versione_giusta
pip install python-dotenv==1.0.1 tabulate==0.9.0Le librerie ci sono, ma una è alla versione sbagliata: l'elenco dice 1.2.4test_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.

Terminale
cd campo/tabellone
source .venv/bin/activate
head tabellone.py
pip install python-dotenv tabulate
pip freeze > requirements.txt
cat requirements.txt
deactivate

Passo per passo.

ComandoCosa succedeCosa c'è di nuovo
head tabellone.pyMostra le prime righe: from dotenv …, from tabulate …Sai cosa installare
pip install python-dotenv tabulateInstalla due librerie in un comando soloLe librerie nel venv
pip freeze > requirements.txtL'elenco finisce nel filerequirements.txt, due righe con ==
cat requirements.txtControlloLe due righe

Le trappole.

Il codice sbagliatoCosa succedeIl test rosso
pip freeze senza > requirements.txtL'elenco passa sullo schermo e sparisce: nessun filetest_il_requirements_nomina_le_due_librerie_con_la_versione
pip freeze > requirements.txt prima di installareIl venv era vuoto: il file nasce vuoto, e sembra tutto a postotest_il_requirements_nomina_le_due_librerie_con_la_versione
cd .. e poi pip freeze > requirements.txtIl file nasce in campo/, non accanto a tabellone.pytest_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.

Terminale
cd campo/tabellone
ls -a
rm -rf .venv
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
deactivate

Passo per passo.

ComandoCosa succedeIl venv
ls -aSi vede .venv, accanto a requirements.txtRotto: il suo Python è di un 3.9 che non c'è più
rm -rf .venvCancella la cartella con tutto dentroNon c'è più
python3 -m venv .venvCrea un venv nuovo con il Python di adessoNuovo, vuoto, 3.12
source .venv/bin/activateLo accendeAcceso
pip install -r requirements.txtRimette le due libreriePieno, alle versioni giuste
deactivateSpegne—

Le trappole.

Il codice sbagliatoCosa succedeIl test rosso
rm -rf .venv e python3 -m venv .venv, e bastaIl venv è nuovo e sano, ma vuoto: le librerie non tornano da soletest_le_librerie_sono_tornate_nel_venv
cd .. e poi python3 -m venv .venv, pip install -r tabellone/requirements.txtIl venv nuovo nasce nella cartella sopra: quello rotto resta dov'eratest_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 leggiDiagnosiLa curaLettera
1ERROR: 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.txtd
2source: no such file or directory: .venv/bin/activateNella cartella giusta (c'è tabellone.py) manca .venv: ls -a non lo mostra. Il venv non è mai stato creatopython3 -m venv .venv, poi source .venv/bin/activatee
3ModuleNotFoundError: No module named 'dotenv'Il venv è acceso ((.venv)), ma vuoto: nessuno ha installato le libreriepip install -r requirements.txtp
4zsh: command not found: pytestIl venv c'è (.venv nell'elenco) ma il prompt non ha (.venv): è spento, e pytest sta lì dentrosource .venv/bin/activateo
5SyntaxError: f-string: unmatched '[', con Python 3.9.6 sopraIl 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 capiscerm -rf .venv, python3.12 -m venv .venv, riaccendere e reinstallares
6which python dice …/biglietteria/.venv/bin/pythonIl prompt ha (.venv), ma è il venv di un altro progetto, rimasto acceso da quando Tommaso lavorava alla biglietteriadeactivate, cd nel tabellone (già lì), source .venv/bin/activatei
7cat 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 protestaInstallare a mano (pip install python-dotenv tabulate: il nome di dotenv per pip è python-dotenv) e riscrivere l'elenco con pip freeze > requirements.txtt
8command not found: pytest, poi pip3 install pytest dà externally-managed-environmentDue 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 venvo

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 sbagliataPerché sembra giusta, e perché noIl 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 venvtest_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 venvtest_livello_4_pytest_non_si_trova
5 = l (reinstallare Python)Il Python 3.12 c'è già: è il venv a essere vecchio, non il computertest_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 nientetest_livello_7_il_requirements_e_vuoto
8 = a (installare pytest con pip)È proprio quello che ha provato, ed è l'errore che veditest_livello_8_pip_fuori_dal_venv