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

Il venv e pip, esercizi spiegati

Cinque esempi, un comando alla volta

  • 20 minuti di lettura

Cinque esempi, uno per ogni pezzo del capitolo. Ognuno ha lo stesso ritmo:

  1. Prevedi: leggi i comandi e scrivi su un foglio cosa risponde il terminale. Prima di aprire la risposta.
  2. In italiano: cosa succede, a parole.
  3. Passo per passo: cosa cambia a ogni comando.
  4. Cosa portiamo a casa: la cosa da ricordare.

Puoi rifarli sul tuo computer in una cartella di prova: crea una cartella con mkdir -p ~/corso/prova-venv, entraci con cd, e lancia i comandi uno alla volta. Ricorda che il venv, qui, lo cancelli quando vuoi.

Negli esempi il prompt non c'è (così copi solo i comandi). Quando il venv è acceso, il tuo comincia con (.venv).


A · Quale Python ha fatto quel venv?

Nella cartella del tabellone facciamo due venv, con due Python diversi: quello che Apple mette sul Mac (/usr/bin/python3) e il 3.12 del corso. Poi ci chiediamo con quale è nato ciascuno.

Terminale
/usr/bin/python3 -m venv .venv-vecchio
python3.12 -m venv .venv-nuovo
grep version .venv-vecchio/pyvenv.cfg .venv-nuovo/pyvenv.cfg
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
.venv-vecchio/pyvenv.cfg:version = 3.9.6
.venv-nuovo/pyvenv.cfg:version = 3.12.13
  • I primi due comandi non stampano niente: se va tutto bene, i venv si creano in silenzio.
  • grep cerca la parola version dentro i due file pyvenv.cfg e stampa le righe che la contengono, ognuna con il nome del suo file.
  • Il venv vecchio ha il 3.9.6: l'ha fatto il Python di Apple. Il nuovo il 3.12.13.

In italiano. Il file pyvenv.cfg, dentro ogni venv, è la carta d'identità: dice con quale Python è nato. Quel Python se lo porta dietro: cambiare Python sul computer non cambia i venv già fatti.

Passo per passo.

ComandoCosa succedeCosa c'è di nuovo
/usr/bin/python3 -m venv .venv-vecchioIl Python 3.9 crea una cartella.venv-vecchio/, con Python 3.9 dentro
python3.12 -m venv .venv-nuovoIl Python 3.12 ne crea un'altra.venv-nuovo/, con Python 3.12 dentro
grep version … …Cerca version in due fileDue righe, una per file

Cosa portiamo a casa. Il venv è vecchio quanto il Python che lo ha creato. Un venv con Python troppo vecchio non si aggiorna: si butta e si rifà con python3.12 -m venv .venv.


B · Acceso, spento: chi risponde?

Su un Mac senza asdf, fuori dal venv il comando python non esiste. Lo scopriamo, accendiamo il venv, e lo ritroviamo. Il terminale è zsh.

Terminale
which python
python --version
source .venv/bin/activate
which python
python --version
deactivate
which python
python --version
Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
python not found
zsh: command not found: python
/Users/marta/corso/tabellone/.venv/bin/python
Python 3.12.13
python not found
zsh: command not found: python
  • Venv spento: which python non trova niente, e python --version dà command not found.
  • source e deactivate non stampano niente.
  • Venv acceso: which mostra il Python dentro .venv/bin, e la versione è quella del venv.
  • Dopo deactivate: tutto com'era all'inizio.

Su bash (Ubuntu) i messaggi hanno altre parole (bash: python: command not found), ma il senso è uguale. Se hai asdf, python esiste anche a venv spento, e which python dice un percorso con .asdf/shims.

In italiano. Accendere il venv non cambia Python: cambia dove il terminale cerca i programmi. Mette .venv/bin in testa all'elenco, e python diventa quello del progetto. deactivate toglie la cartella dall'elenco.

Passo per passo.

Comandopython esiste?Dove?
which python (spento)NoDa nessuna parte
source .venv/bin/activate—Il terminale ora cerca prima in .venv/bin
which python (acceso)Sì…/tabellone/.venv/bin/python
deactivate—Il terminale torna a cercare come prima
which python (spento)NoDa nessuna parte

Cosa portiamo a casa. Quando un comando non si trova, o il Python non è quello che pensi, scrivi which python: la risposta dice chi sta rispondendo. Se non è un percorso con .venv, il venv è spento.


C · Una libreria, cinque righe

Nel venv acceso del tabellone installiamo requests, una libreria per parlare con i server. La scegliamo perché si porta dietro altre librerie: serve a vedere cosa scrive pip freeze.

Terminale
pip install requests==2.32.3
Collecting requests==2.32.3
  Downloading requests-2.32.3-py3-none-any.whl.metadata (4.6 kB)
Collecting charset-normalizer<4,>=2 (from requests==2.32.3)
  Downloading charset_normalizer-3.5.2-cp312-cp312-macosx_10_13_universal2.whl.metadata (46 kB)
Collecting idna<4,>=2.5 (from requests==2.32.3)
  Downloading idna-3.20-py3-none-any.whl.metadata (7.2 kB)
Collecting urllib3<3,>=1.21.1 (from requests==2.32.3)
  Downloading urllib3-2.8.0-py3-none-any.whl.metadata (7.4 kB)
Collecting certifi>=2017.4.17 (from requests==2.32.3)
  Downloading certifi-2026.10.23-py3-none-any.whl.metadata (2.5 kB)
Downloading requests-2.32.3-py3-none-any.whl (64 kB)
Downloading certifi-2026.10.23-py3-none-any.whl (135 kB)
Downloading charset_normalizer-3.5.2-cp312-cp312-macosx_10_13_universal2.whl (367 kB)
Downloading idna-3.20-py3-none-any.whl (69 kB)
Downloading urllib3-2.8.0-py3-none-any.whl (135 kB)
Installing collected packages: urllib3, idna, charset-normalizer, certifi, requests
Successfully installed certifi-2026.10.23 charset-normalizer-3.5.2 idna-3.20 requests-2.32.3 urllib3-2.8.0

[notice] A new release of pip is available: 25.0.1 -> 26.3
[notice] To update, run: pip install --upgrade pip

Hai chiesto una libreria, ne sono arrivate cinque. Ora due comandi:

Terminale
pip list
pip freeze > requirements.txt
cat requirements.txt

Quante righe ha pip list? E quante requirements.txt? Quale riga c'è in una lista e non nell'altra?

Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.
Package            Version
------------------ ----------
certifi            2026.10.23
charset-normalizer 3.5.2
idna               3.20
pip                25.0.1
requests           2.32.3
urllib3            2.8.0
certifi==2026.10.23
charset-normalizer==3.5.2
idna==3.20
requests==2.32.3
urllib3==2.8.0
  • pip list ha due righe di intestazione e sei librerie: le cinque più pip.
  • requirements.txt ha cinque righe: pip non c'è, perché pip freeze non elenca pip stesso.
  • Le versioni sono scritte con ==: è il formato che pip install -r sa rileggere.
  • Le librerie sono in ordine alfabetico, non in ordine di installazione.

In italiano. requests ha bisogno di quattro librerie per funzionare, e pip le installa da solo. pip freeze le scrive tutte, con la versione precisa: così chi rifà il venv trova lo stesso ambiente, e non uno «più o meno».

Passo per passo.

ComandoCosa succedeCosa c'è nel venv / nel file
pip install requests==2.32.3pip scarica requests e le sue quattro compagneCinque librerie in più nel venv
pip listStampa una tabellaSei righe: le cinque più pip
pip freeze > requirements.txtScrive l'elenco nel file, non sullo schermoIl file requirements.txt, cinque righe
cat requirements.txtLegge il fileLe cinque righe

Cosa portiamo a casa. Non scrivi requirements.txt a mano e non indovini le versioni: lo scrive pip freeze, a venv acceso e a venv riempito. Se lo lanci a venv spento, descrive un altro Python.


D · Buttalo e rifallo

Il venv del tabellone ha fatto il suo tempo. Lo buttiamo e lo rifacciamo uguale, con l'elenco che abbiamo scritto prima.

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

Cosa mostra l'ultimo pip list? E quello prima, subito dopo aver rifatto il venv?

Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

Dopo rm -rf .venv e ls -a:

.                       ..                      requirements.txt

Dopo il venv nuovo, il primo pip list:

Package Version
------- -------
pip     25.0.1

Dopo pip install -r requirements.txt, il secondo pip list:

Package            Version
------------------ ----------
certifi            2026.10.23
charset-normalizer 3.5.2
idna               3.20
pip                25.0.1
requests           2.32.3
urllib3            2.8.0
  • Il venv è sparito, ma requirements.txt è rimasto: non era dentro .venv.
  • Un venv appena fatto è vuoto: c'è solo pip.
  • pip install -r rimette le cinque librerie, alle stesse versioni di prima.

In italiano. Cancello la cartella del venv. Ne creo una nuova, la accendo, e le faccio leggere l'elenco. Il risultato è lo stesso di prima, ma partendo da zero: per questo un venv si può buttare senza paura.

Passo per passo.

ComandoCosa succede
deactivateSpegne il venv (da cancellare, meglio spento)
rm -rf .venvCancella la cartella .venv e tutto quello che contiene
ls -aMostra che .venv non c'è più, e che requirements.txt sì
python3 -m venv .venvCrea un venv nuovo e vuoto
source .venv/bin/activateLo accende
pip listSolo pip
pip install -r requirements.txtInstalla le cinque librerie dell'elenco
pip listCinque librerie e pip: come prima

Cosa portiamo a casa. Il venv è usa e getta, l'elenco requirements.txt no: quello è il tuo progetto. Per questo l'elenco va su GitHub e il venv no.


E · Il pip che non vuole

Tommaso ha aperto un terminale nuovo e scrive subito pip3 install tabulate, a venv spento, sul Python di Homebrew.

Terminale
pip3 install tabulate

Cosa risponde? Quale riga del messaggio conta davvero?

Prevedi Scrivi su un foglio cosa ti aspetti, poi apri.

La prima riga del messaggio:

error: externally-managed-environment

Il resto sono una trentina di righe di consigli: brew install, python3 -m venv, pipx, e in fondo --break-system-packages (da non usare). La risposta completa, per intero, è nella teoria.

  • «Externally managed» vuol dire: questo Python lo gestisce Homebrew (o apt), non tu.
  • pip si ferma prima di installare: non è stato installato niente, e non c'è niente da disinstallare.
  • Il consiglio buono è nel mezzo: python3 -m venv path/to/venv e source path/to/venv/bin/activate. È quello che facciamo da sempre.

In italiano. Il pip che ha risposto non è quello di un venv: è quello del Python del computer. I sistemi recenti non lasciano che ci installi le tue librerie, perché potresti rompere programmi che usa il sistema.

La cura è accendere il venv del progetto (ci sei nella cartella giusta?) e poi rifare il comando:

Terminale
source .venv/bin/activate
pip install tabulate

Il disegno.

inizio pip3 install tabulate se il prompt ha (.venv) sì: fine pip installa nel venv no: mostra externally-managed-environment passo source .venv/bin/activate passo pip install tabulate fine tabulate installatopip3 install tabulateil prompt ha (.venv)mostraexternally-managed-environmentsource .venv/bin/activatepip install tabulatepip installa nel venvtabulate installatonosì
Il pip che non vuole

Passo per passo.

Cosa vediCosa vuol direCosa fai
Il prompt non ha (.venv)Il venv è spentosource .venv/bin/activate
error: externally-managed-environmentpip è quello del sistemaNon insistere: accendi il venv
Il prompt ha (.venv), pip install funzionaOra scrive nel venvRicontrolla con pip list

Cosa portiamo a casa. externally-managed-environment non è un errore del tuo progetto: è pip che ti dice «non sei nel venv». Il prompt e which pip ti avrebbero avvisato prima.