Virtualenv: una guida sciué sciué per gestire ambienti di sviluppo dedicati su Python

Ecco una guida sciué sciué per imparare a creare e utilizzare ambienti virtuali su Python! 🐍
Per farlo utilizzeremo il potentissimo virtualenv. 💪

Ti riepilogo subito i tre comandi essenziali per creare, attivare e disattivare l’environment:

Non ti occorrerà niente di più per iniziare. 😉
Continua a leggere qui sotto, però, per capire meglio il funzionamento di uno dei tool più utilizzati dai pythonisti di tutto il mondo.👇

Cosa è virtualenv

virtualenv è uno strumento che serve a isolare e gestire ambienti di sviluppo separati.

Con virtualenv puoi creare diversi ambienti virtuali distinti con relative dipendenze e pacchetti PyPI di terze parti.

Tutto questo, compresa l’esatta versione Python che utilizzi, finisce sotto una directory di ambiente (il cui percorso è personalizzabile).

I vantaggi sono facilmente comprensibili:

• qualsiasi applicazione A, che richiede un modulo Pippo versione 1.0, non andrà in conflitto con l’installazione a sistema della versione B, che richiede il modulo Pippo alla versione 0.8
• operazioni di aggiornamento dei moduli saranno limitate all’ambienta virtuale specifico e non andranno a impattare su tutti gli altri applicativi Python presenti a sistema.

Installare virtualenv

La procedura di installazione di virtualenv dipende dalla distribuzione Linux sulla quale lavori.

Su Ubuntu è immediata lanciando il solito
sudo apt install virtualenv

Ricordati di installare anche PyPI, ti servirà per i moduli e pacchetti aggiuntivi.

Per installare virtualenvs su Windows, invece, hai bisogno di installare in primis proprio PyPI.
Questi i passaggi con cui Google risponde alla domanda “come installo Python Virtualenv su Windows?”:

A seguire riporterò i comandi di attivazione e gestione del tool su OS Linux.
Se utilizzi un sistema operativo Windows ti consiglio di dare uno sguardo a questo tutorial specifico su Youtube.

Creare e attivare il virtual environment per Python

Procediamo quindi alla creazione della sandbox .

Crea un cartella nella quale inserirai tutto il tuo progetto, spostati su di essa, e lancia il comando:
virtualenv env

Pochi secondi e il sistema raccoglierà tutto ciò di cui a bisogno proprio sotto la directory env.

env sta ovviamente per “environment”, ambiente.

Note bene: non sei obbligato a utilizzare questo nome.
Convenzionalmente si tende a chiamare la cartella env o venv, ma non è assolutamente un obbligo.
Considera, insomma, che puoi sostituire env con qualsiasi altra parola a tuo piacimento.

Prova a curiosare sotto la directory appena creata dal comando.
Ti renderai subito conto che lì sotto ci sono finiti un bel po’ di file di sistema, compresa l’installazione di Python. 😉

Non resta ora che attivare l’ambiente per fare in modo che possa essere utilizzato.

Facilissimo, lancia il comando:

source env/bin/activate/

et voilà, sei pronto a sviluppare nel tuo confortevole ambiente isolato:

l’env tra parentesi a terminale, prima del nome utente e postazione, sta proprio a indicare che l’ambiente env è attivo e in esecuzione.

Ora puoi installare tutti i moduli di cui hai bisogno proprio tramite PyPI:

Finché l’ambiente è attivo i moduli PyPI non saranno installati nella cartelle di sistema, ma sotto env.

⚠️ Quando utilizzi pip ricorda comunque che non è mai una buona idea utilizzare i permessi di amministratore! ⚠️

Disattivare l’ambiente virtuale

Per uscire dall’ambiente virtuale e tornare a quello di sistema il comando è banale:

deactivate

La shell ti indicherà immediatamente della disattivazione dell’ambiente rimuovendo l’indicazione (env):

Salvataggio delle dipendenze per altre installazioni

Sai a cosa serve il comandopip freeze?
Genere un output con un riepilogo di tutte le dipendenze installate a sistema.
Nel caso dell’ambiente virtuale attivo andrà, ovviamente, a elencare le sole dipendenze installate sull’ambiente stesso:

La cosa può essere parecchio comoda quando ti trovi a dover spostare il progetto di una applicazione da una macchina all’altra.
O quando lo devi distribuire, per esempio su Github.

Se ci fai caso su Github tutte le app scritte in Python sono accompagnate da un file chiamato requirements.txt.
È il file che elenca tutte le dipendenze necessarie al funzionamento di quell’applicazione.

Se sei sul tuo virtual environment e vuoi esportare in un file di testo tutte le dipendenze pip installate dai il comando:

pip freeze > requirements.txt

In questo modo salverai, questa volta sul file requirements.txt, lo stesso contenuto del primo output che ti ho illustrato.

Ora ti basta spostare il file di testo appena creato su un nuovo ambiente virtuale.
Per installare i medesimi pacchetti dell’ambiente di provenienza il comando è semplicemente:
pip install -r requirements.txt

Come avrai notato il comando freeze si occuperà di esportare anche le versioni di ogni singola dipendenza.
Puoi dormire sogni tranquilli, quindi.
Ora sai come replicare in modo perfetto e veloce i tuoi ambienti virtuali, e non imbatterti mai in problemi di compatibilità.

---

L’immagine di apertura dell’articolo è di Mitch Fournier.