Configurazione di un ambiente di sviluppo¶
Contribuire a {{ nome_formale }} richiede la creazione di un ambiente di sviluppo.
Prerequisiti¶
È necessario installare i seguenti prerequisiti.
{{ nome_formale }} richiede Python 3.10+. È necessario anche
un metodo per gestire gli ambienti virtuali (come venv).
È possibile verificare la versione di Python installata eseguendo:
$ python3 --version
Se è installata più di una versione di Python, potrebbe essere necessario
sostituire python3 con un numero di versione specifico (ad esempio, python3.13).
Si consiglia di evitare le versioni di Python rilasciate di recente (cioè quelle che hanno un micro numero di versione ".0" o ".1", come ad esempio 3.14.0). Questo perché gli strumenti necessari per supportare Python su macOS spesso non sono disponibili per le versioni stabili di Python rilasciate di recente.
{{ nome_formale }} richiede Python 3.10+. È necessario anche
un metodo per gestire gli ambienti virtuali (come venv).
È possibile verificare la versione di Python installata eseguendo:
$ python3 --version
Se è installata più di una versione di Python, potrebbe essere necessario
sostituire python3 con un numero di versione specifico (ad esempio, python3.13).
Si consiglia di evitare le versioni di Python rilasciate di recente (cioè quelle che hanno un micro numero di versione ".0" o ".1", come ad esempio 3.14.0). Questo perché gli strumenti necessari per supportare Python su Linux spesso non sono disponibili per le versioni stabili di Python rilasciate di recente.
{{ nome_formale }} richiede Python 3.10+. È necessario anche
un metodo per gestire gli ambienti virtuali (come venv).
È possibile verificare la versione di Python installata eseguendo:
C:\...>py -3 --version
Se è installata più di una versione di Python, potrebbe essere necessario
sostituire la -3 con un numero di versione specifico (ad esempio,
-python{{ versione_python_recente }}).
Si consiglia di evitare le versioni di Python rilasciate di recente (cioè quelle che hanno un micro numero di versione ".0" o ".1", come ad esempio 3.14.0). Questo perché gli strumenti necessari per supportare Python su Windows spesso non sono disponibili per le versioni stabili di Python rilasciate di recente.
Impostare il proprio ambiente di sviluppo¶
Il modo consigliato di impostare l'ambiente di sviluppo per {{ nome_formale }} è quello di usare un ambiente virtuale, e quindi installare la versione di sviluppo di {{ nome_formale }} e le sue dipendenze.
Clonare il repository {{ nome_formale }}¶
Quindi, andare alla pagina {{ nome_formale }} su GitHub e, se non lo si è già fatto, fare un fork del repository nel proprio account. Quindi, fare clic sul pulsante "<> Codice" sul proprio fork. Se sul computer è installata l'applicazione desktop di GitHub, si può selezionare "Apri con GitHub Desktop"; altrimenti, copiare l'URL HTTPS fornito e usarlo per clonare il repository sul computer usando la riga di comando:
Eseguire il fork del repository {{ nome_formale }} e poi:
$ git clone https://github.com/<your username>/beeware.git
(sostituendo il proprio nome utente GitHub)
Eseguire il fork del repository {{ nome_formale }} e poi:
$ git clone https://github.com/<your username>/beeware.git
(sostituendo il proprio nome utente GitHub)
Eseguire il fork del repository {{ nome_formale }} e poi:
C:\...>git clone https://github.com/<your username>/beeware.git
(sostituendo il proprio nome utente GitHub)
Creare un ambiente virtuale¶
Per impostare un ambiente virtuale e aggiornare pip, eseguire:
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
$ cd beeware
$ python3 -m venv .venv
$ source .venv/bin/activate
(.venv) $ python -m pip install -U pip
C:\...>cd beeware
C:\...>py -3 -m venv .venv
C:\...>.venv\Scripts\activate
(.venv) $ python -m pip install -U pip
Il prompt dovrebbe ora avere un prefisso (.venv) davanti.
Installare {{ nome_formale }}¶
Ora che si dispone del codice sorgente, si può eseguire una installazione modificabile di {{ nome_formale }} nel proprio ambiente di sviluppo. Eseguite il seguente comando:
(.venv) $ python -m pip install -U -e . --group dev
(.venv) $ python -m pip install -U -e . --group dev
(.venv) C:\...>python -m pip install -U -e . --group dev
Abilita il pre-commit¶
{{ nome_formale }} usa uno strumento chiamato pre-commit per identificare semplici problemi e standardizzare la formattazione del codice. Lo fa installando un hook git che esegue automaticamente una serie di code linters prima di finalizzare qualsiasi commit git. Per abilitare il pre-commit, eseguire:
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) $ pre-commit install
pre-commit installed at .git/hooks/pre-commit
(.venv) C:\...>pre-commit install
pre-commit installed at .git/hooks/pre-commit
Ora siete pronti per iniziare l'hacking su {{ nome_formale }}!