Introduzione
Quando si lavora con moduli e pacchetti in Python, è fondamentale gestire correttamente le dipendenze del progetto. Le dipendenze sono librerie esterne necessarie per il funzionamento del tuo codice. Utilizzare un virtual environment (ambiente virtuale) è una delle migliori pratiche per isolare le dipendenze di un progetto, evitando conflitti tra librerie e versioni. In questo tutorial, esploreremo come creare e utilizzare un ambiente virtuale in Python.
Codice completo
Di seguito è riportato un esempio pratico di come creare e gestire un ambiente virtuale. Iniziamo creando un progetto semplice che utilizza la libreria requests per effettuare richieste HTTP.
# Creiamo una cartella per il nostro progetto
mkdir mio_progetto
cd mio_progetto
# Creiamo un ambiente virtuale
python -m venv venv
# Attiviamo l´ambiente virtuale
# Su Windows
venvScriptsactivate
# Su macOS/Linux
source venv/bin/activate
# Installiamo la libreria requests
pip install requests
# Creiamo un file chiamato main.py
echo "import requests
response = requests.get(´https://api.github.com´)
print(response.json())" > main.py
# Eseguiamo il nostro script
python main.py
# Disattiviamo l´ambiente virtuale
deactivate
Spiegazione
Analizziamo il codice passo passo:
- Creazione della cartella: Iniziamo creando una cartella per il nostro progetto. Questo aiuta a mantenere il codice organizzato.
- Creazione dell´ambiente virtuale: Utilizziamo il comando
python -m venv venvper creare un ambiente virtuale chiamatovenv. Questo creerà una nuova cartella contenente una copia isolata dell´interprete Python e delle librerie. - Attivazione dell´ambiente virtuale: Dobbiamo attivare l´ambiente virtuale per lavorare all´interno di esso. I comandi variano a seconda del sistema operativo. Una volta attivato, il prompt del terminale cambierà per indicare che siamo all´interno dell´ambiente virtuale.
- Installazione delle dipendenze: Utilizziamo
pip install requestsper installare la libreria requests all´interno dell´ambiente virtuale. Le librerie installate in questo modo non influenzeranno altri progetti. - Creazione e esecuzione dello script: Creiamo un file chiamato
main.pye scriviamo un semplice script che effettua una richiesta a un´API di GitHub. Infine, eseguiamo lo script conpython main.py. - Disattivazione dell´ambiente virtuale: Una volta terminato il lavoro, possiamo disattivare l´ambiente virtuale con il comando
deactivate.
Best practice
Quando lavori con moduli e pacchetti in Python, considera le seguenti best practice:
- Utilizza sempre un ambiente virtuale: Questo ti permette di mantenere le dipendenze isolate e di evitare conflitti tra progetti diversi.
- Documenta le dipendenze: Crea un file
requirements.txtper elencare tutte le librerie necessarie. Puoi generarlo automaticamente conpip freeze > requirements.txt. - Versiona le dipendenze: Specifica le versioni delle librerie nel file
requirements.txtper garantire che il tuo progetto funzioni sempre come previsto. - Testa il tuo codice: Esegui test regolari per assicurarti che le dipendenze non causino problemi al tuo progetto.
Riepilogo
In questo tutorial, abbiamo esplorato come gestire le dipendenze in Python utilizzando gli ambienti virtuali. Abbiamo creato un semplice progetto che utilizza la libreria requests e abbiamo visto come isolare le dipendenze per evitare conflitti. Ricorda che l´uso di ambienti virtuali è una best practice fondamentale nello sviluppo di applicazioni Python.
