====== Come creare un Virtual Environment per installate i pacchetti ======

===== Cosa sono e a cosa servono gli ambienti virtuali in Python =====
Cosa succede quando un progetto necessita di un pacchetto con una versione diversa da un altro progetto? \\
Aggiornare un pacchetto per un progetto comporta il rischio di rovinare il codice in un altro progetto che dipende da quel pacchetto. \\ 
Senza contare che sotto Linux, Python é usato per molte cose e aggiornare una libreria potrebbe rendere il sistema instabile.


===== Requisiti =====

per prima cosa é necessario aggiornare e/o installare gli strumenti necessari

<cli>
python -m pip install --upgrade pip setuptools virtualenv
</cli>

===== Procedimento =====
Per prima cosa creare la cartella che conterrá il progetto ed entrarvi

<cli>
mkdir <project>
cd <project>
</cli>

Ora possiamo creare il nostro //Virtual Environment//

<WRAP group>
<WRAP half column>
**Tutte le versioni di Python**
<cli>
python -m virtualenv venv
</cli>
</WRAP>

<WRAP half column>
**Da Python 3 si puó anche usare**
<cli>
python -m venv venv
</cli>
</WRAP>
</WRAP>


**venv** alla fine del comando é il nome della cartella che conterrá l'ambiente virtuale, puó essere chiamata anche in modo diverso ma per convenzione si usa sempre //venv//.\\
Come si puó vedere la stessa operazione puó essere fatta sia con **//virtualenv//** che con **//venv//**, quest'ultimo possiede solo un sub-set delle feature di **//virtualenv//**.\\
Per una panoramica completa di tutti gli strumenti per creare ambienti virtuali in python si rimanda a [[python:differenze_fra_tools_per_creare_ambienti_virtuali_english_only|questo articolo (in inglese)]].

===== Attivazione dell'ambiente virtuale =====
Ora che l'ambiente é stato creato, prima di poter utilizzare, deve essere attivato.

==== Linux ====
Da terminale, nella cartella del progetto digitare

<cli>
source venv/bin/activate
</cli>

la variazione del prompt denoterá l'avvenuta attivazione dell'ambiente virtuale

<cli>
(venv)$
</cli>

==== Windows ====
Da terminale, nella cartella del progetto digitare

<cli>
.\venv\Scripts\activate
</cli>

la variazione del prompt denoterá l'avvenuta attivazione dell'ambiente virtuale

<cli>
(venv) C:\path\to\project>
</cli>

===== Utilizzo dell'ambiente virtuale =====
Ora che l'ambiente é attivo sará possibile installare i pacchetti in esso tramite l'uso di //**pip**// ed eseguire il main script del progetto usando il python contenuto nella cartella venv.


===== Disattivazione dell'ambiente virtuale =====
Per disattivare l'ambiente é sufficiente chiudere la finestra del terminale o, in alternativa, digitare 

<cli>
deactivate
</cli>

che vale sia per //Windows// che per //Linux//.