Per poter contribuire, è necessario creare un ambiente di sviluppo, ovvero un luogo dove poter lavorare sul codice in un luogo dove non ci sono problemi. un ambiente di sviluppo, un luogo dove poter lavorare sul codice e dove dove possa comportarsi come l'ambiente di tutti gli altri.

Molte parti di BeeWare utilizzano gli stessi strumenti: una versione specifica di Python, e i controlli dell'ambiente virtuale.

Python

Python è un linguaggio di scripting, disponibile su diversi sistemi operativi. diversi sistemi operativi. Tuttavia, a seconda del sistema in uso, la versione di Python sistema in uso, la versione di Python sarà diversa. Per questo motivo per questo motivo, specifichiamo esattamente la versione di Python con la quale ci aspettiamo che il codice con cui ci aspettiamo che il codice funzioni.

Per le istruzioni che seguono, si presuppone che si sappia esattamente la versione di Python da installare. Normalmente, questa è elencata nel file README.md o nelle informazioni del tutorial. Il nostro CI devono sapere esattamente quale versione di Python è richiesta. Quindi, se si è davvero se siete davvero bloccati, provate a guardare il file .github/workflows/ci.yml per trovare la versione specifica di cui avete bisogno. versione specifica di cui si ha bisogno.

Per poter contribuire a BeeWare, è necessario avere un interprete Python installato sul proprio computer. Su macOS e Windows, si consiglia di consigliamo di utilizzare gli installatori ufficiali di Python.org ufficiale di Python.org; su Linux, si consiglia di di utilizzare la versione di Python fornita dal gestore di pacchetti della propria distribuzione. distribuzione.

Ambienti virtuali

Quando Python viene installato, fornisce un unico ambiente globale. Per predefinito, se si installa un pacchetto, questo viene installato in questo ambiente globale. ambiente globale.

Tuttavia, se si sta lavorando a più di un progetto Python, è molto probabile che questi progetti è molto probabile che questi progetti multipli abbiano requisiti diversi e in alcuni casi, in conflitto tra loro. È necessario un modo per isolare ciascun progetto, in modo che l'installazione di un pacchetto per un progetto non non costringa lo stesso pacchetto a essere installato anche per il secondo progetto.

A questo scopo si utilizzano gli Ambienti virtuali. Un ambiente virtuale, o venv, è un ambiente isolato che può essere facilmente creato, distrutto o ricreato. o ricreato. Qualsiasi pacchetto installato nell'ambiente virtuale è accessibile solo all'interno di quell'ambiente virtuale. Gli ambienti virtuali sono a volte vengono definiti "sandbox", un luogo sicuro in cui giocare, dove se si commette un errore si può se si commette un errore, si può buttare giù tutto quello che si è costruito e ricominciare da capo. e ricominciare da capo.

Python fornisce il modulo venv per creare nuovi ambienti virtuali. Ogni ambiente virtuale ha un nome che può essere usato per identificare l'ambiente. ambiente. Per creare un nuovo ambiente virtuale chiamato "my-venv", eseguire:

$ python -m venv my-venv

La versione di Python utilizzata per creare l'ambiente virtuale sarà la versione utilizzata di default all'interno dell'ambiente virtuale. ambiente virtuale. Se sono state installate più versioni di Python o si utilizza uno strumento come pyenv per gestire le versioni di Python, assicurarsi che la versione di Python uno strumento come pyenv per gestire le versioni di Python, assicuratevi che la versione di versione di Python attualmente attiva (o la versione a cui si fa riferimento quando si invoca il comando -m venv) sia la versione desiderata. Una volta creato un una volta creato un ambiente virtuale, non è possibile cambiare la versione di Python che sta utilizzando. Per cambiare la versione di Python, è necessario creare un nuovo ambiente virtuale.

Invocando -m venv si crea l'ambiente virtuale, ma l'ambiente non è ancora attivo. non è ancora attivo. L'ambiente virtuale è un insieme di file di file su disco, memorizzati in una directory che corrisponde al nome dell'ambiente virtuale. ambiente. Per attivare l'ambiente virtuale, si esegue uno dei file generato come parte dell'ambiente:

$ source my-venv/bin/activate

In questo modo, al prompt della riga di comando verrà aggiunto un prefisso che indica che ci si trova in un ambiente virtuale:

(my-venv) $

Mentre l'ambiente virtuale è attivo, qualsiasi comando pip install avrà influisce solo sull'ambiente virtuale. Non importa se si cambia directory: se il prompt ha un prefisso, quell'ambiente virtuale è attivo. attivo.

Se si apre una seconda finestra del terminale, l'ambiente non sarà attivo. attivo: è necessario riattivare l'ambiente in ogni sessione di sessione di terminale in cui si desidera utilizzare l'ambiente. Se si ricevono errori relativi a non sono disponibili librerie che si è certi di aver installato controllate se l'ambiente virtuale è attivo.

Per disattivare l'ambiente virtuale, eseguire:

(my-venv) $ disattivare

Una volta disattivato, il prefisso verrà eliminato dal prompt.