Configurare un ambiente virtuale per Python in eLegere

Abstract

• Configurare l'ambiente virtuale Python
• Lanciare uno script Python nell'ambiente virtuale tramite Custom Action

Warning

Configurare un ambiente virtuale per Python richiede accesso alla macchina di eLegere. Se non possiedi i privilegi per accedere alla macchina eLegere, chiede al tuo amministratore di eseguire i passi di questo documento per te.

Un ambiente virtuale per Python è un compartimento isolato dove puoi avere la tua configurazione Python separata da quella del sistema.

Impara come creare un ambiente virtuale per Python per la tua installazione eLegere. Creare un ambiente dedicato aiuta a configurare insiemi di pacchetti differenti per ciascun Dominio o utenti specifici.

Questo tutorial spiega:

1. Il processo di configurazione dell'ambiente virtuale Python in Windows.
2. Come lanciare gli script Python dell'ambiente virtuale tramite Custom Action.

Note

Il tutorial impiega il pacchetto Python virtualenv al posto del modulo standard venv.

Installare tramite pip il pacchetto virtualenv prima di iniziare.

Dopo aver installato virtualenv, troverai l'eseguibile virtualenv.exe sotto la cartella Scripts nella cartella d'installazione Python della macchina.

Configurare l'ambiente virtuale Python

Segui i passi sotto per configurare l'ambiente di Python sulla macchina eLegere tramite virtualenv.

L'installazione assume l'uso della linea di comando (CLI) in Windows.

1. Identifica la cartella della macchina dove vuoi configurare l'ambiente virtuale Python. Spostati su tale cartella nella CLI. (folder-environment è il percorso della cartella dove vuoi creare l'ambiente virtuale.)

   cd folder-environment
   

2. Lanciare il seguente comando nella cartella scelta al precedente passo. (Sostituisci il percorso nell'esempio con la cartella sulla macchina dove vuoi creare l'ambiente virtuale Python.)

   python -m virtualenv  C:\[Insert the path where you want to install the virtual environment]
   

   Il comando sopra crea un ambiente virtuale usando la versione predefinita di Python sulla macchina.

   Tip

   Se ha versioni multiple di Python e vuoi installare una in particolare, usa invece il seguente comando.

   virtualenv --python "C:\[Insert here the path to the Python's version]\python.exe" venv
   

   Attendi che virtualenv completi l'operazione.

3. Lancia il seguente comando nella cartella dell'ambiente virtuale per attivarlo.

   .\venv\Scripts\activate
   

   Tip

   Controlla se hai attivato l'ambiente correttamente digitando which python3 nella CLI. Se la configurazione è riuscita, il comando mostra il percorso dell'ambiente virtuale.

4. Installa tutti i pacchetti di cui hai bisogno tramite il comando python -m pip install [package name]. (Consulta la documentazione di pip per maggiori informazioni.)

5. Chiudi il CLI, non ci sono ulteriori passaggi.

Tip

In qualunque momento, digita deactivate nella CLI per disattivare l'ambiente.

Success

La configurazione dell'ambiente virtuale di Python è completata. Consulta la sezione successiva per imparare come lanciare uno script Python nell'ambiente virtuale da una Custom Action.

Lanciare uno script Python nell'ambiente virtuale tramite Custom Action

Impara come lanciare uno script Python dentro un ambiente da una Custom Action Python Script.

Segui le istruzioni in Eseguire script Python dentro la tua applicazione per configurare la Custom Action Python Script come al solito.

Quando inserisci lo Script Path nei Parameters: fornisci lo script Python sotto invece di puntare allo script desiderato.

Perché uno script Python intermedio?

Lo script sotto apre un processo dall'interno dell'ambiente virtuale, eseguendo lo script Python desiderato e riportando il risultato.

In maniera predefinita, le Custom Action eseguono gli script usando la configurazione Python dell'installazione eLegere. Devi usare uno script Python intermedio per eseguire lo script all'interno dell'ambiente virtuale.

# L'operazione richiede il modulo subprocess.

import subprocess

# Il metodo Popen lancia un nuovo processo CLI per eseguire i comandi. Lo script Python desiderato e l'ambiente girano in questo processo.
# Sostituisci `environment-folder` nella stringa con il percorso all'ambiente configurato.

p = subprocess.Popen(r"C:\environment-folder\Scripts\python.exe C:\folder\test.py", shell=True, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, encoding="utf-8")

# Un loop FOR IN raccoglie tutti i messaggi di input dal processo tramite il metodo readlines. Il loop poi le stampa nell'output di questo script. 

for line in p.stdout.readlines():
    print(line)

Ripeti l'operazione per ciascun Python Script che vuoi eseguire da ambiente virtuale da una Custom Action.

Success

Hai configurato la Custom Action Python Script per eseguire uno script dall'ambiente virtuale precedentemente impostato.