Configurazione di Matplotlib per lo sviluppo #
Per configurare Matplotlib per lo sviluppo, attenersi alla seguente procedura:
Recupera l'ultima versione del codice #
Matplotlib è ospitato su https://github.com/matplotlib/matplotlib.git .
Puoi recuperare le fonti più recenti con il comando (vedi Configura il tuo fork per maggiori dettagli)
git clone https://github.com/matplotlib/matplotlib.git
git clone [email protected]:matplotlib/matplotlib.git
Ciò richiede l'impostazione anticipata di una chiave SSH , ma evita di dover digitare la password a ogni connessione.
Questo posizionerà le fonti in una directory matplotlibsotto la tua attuale directory di lavoro. Passare a questa directory:
cd matplotlib
Crea un ambiente dedicato #
Dovresti configurare un ambiente dedicato per disaccoppiare il tuo sviluppo Matplotlib da altre installazioni Python e Matplotlib sul tuo sistema.
Il modo più semplice per farlo è utilizzare l'ambiente virtuale di Python venv o conda .
Crea un nuovo ambiente venv con
python -m venv <file folder location>
e attivarlo con uno dei seguenti
source <file folder location>/bin/activate # Linux/macOS
<file folder location>\Scripts\activate.bat # Windows cmd.exe
<file folder location>\Scripts\Activate.ps1 # Windows PowerShell
Ricordati di attivare l'ambiente ogni volta che inizi a lavorare su Matplotlib.
Installa Matplotlib in modalità modificabile #
Installa Matplotlib in modalità modificabile dalla matplotlibdirectory utilizzando il comando
python -m pip install -ve .
La "modalità modificabile/sviluppo", crea tutto e inserisce collegamenti nel tuo ambiente Python in modo che Python possa importare Matplotlib dalla tua directory sorgente di sviluppo. Ciò ti consente di importare la tua versione modificata di Matplotlib senza reinstallare dopo ogni modifica. Si noti che questo è vero solo per *.pyi file. Se cambi la fonte dell'estensione C (cosa che potrebbe accadere anche se cambi ramo) dovrai eseguire nuovamente
python -m pip install -ve .
Installa dipendenze di sviluppo aggiuntive #
Installa hook pre-commit (facoltativo) #
gli hook pre-commit controllano automaticamente flake8 e altri problemi di stile quando esegui . Gli hook sono definiti nel file di livello superiore . Per installare i gancigit commit.pre-commit-config.yaml
python -m pip install pre-commit
pre-commit install
Gli agganci possono essere eseguiti anche manualmente. Tutti gli hook possono essere eseguiti, nell'ordine elencato in .pre-commit-config.yaml, rispetto all'intera base di codice con
pre-commit run --all-files
Per eseguire manualmente un particolare hook, eseguire con l'hook idpre-commit run
pre-commit run <hook id> --all-files