Configurando Matplotlib para desarrollo #
Para configurar Matplotlib para el desarrollo, siga estos pasos:
Recuperar la última versión del código #
Matplotlib está alojado en https://github.com/matplotlib/matplotlib.git .
Puede recuperar las fuentes más recientes con el comando (consulte Configurar su bifurcación para obtener más detalles)
git clone https://github.com/matplotlib/matplotlib.git
git clone [email protected]:matplotlib/matplotlib.git
Esto requiere que configure una clave SSH por adelantado, pero le evita escribir su contraseña en cada conexión.
Esto colocará las fuentes en un directorio matplotlibdebajo de su directorio de trabajo actual. Cambie a este directorio:
cd matplotlib
Crear un entorno dedicado #
Debe configurar un entorno dedicado para desacoplar su desarrollo de Matplotlib de otras instalaciones de Python y Matplotlib en su sistema.
La forma más sencilla de hacer esto es usar el entorno virtual de Python venv o conda .
Cree un nuevo entorno venv con
python -m venv <file folder location>
y activarlo con uno de los siguientes
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
Recuerde activar el entorno cada vez que comience a trabajar en Matplotlib.
Instale Matplotlib en modo editable #
Instale Matplotlib en modo editable desde el matplotlibdirectorio usando el comando
python -m pip install -ve .
El 'modo editable/de desarrollo' construye todo y coloca enlaces en su entorno de Python para que Python pueda importar Matplotlib desde su directorio fuente de desarrollo. Esto le permite importar su versión modificada de Matplotlib sin volver a instalarla después de cada cambio. Tenga en cuenta que esto solo es cierto para los *.pyarchivos. Si cambia la fuente de la extensión C (lo que también puede suceder si cambia de sucursal), tendrá que volver a ejecutar
python -m pip install -ve .
Instale dependencias de desarrollo adicionales #
Instale ganchos de compromiso previo (opcional) #
los ganchos de confirmación previa verifican automáticamente flake8 y otros problemas de estilo cuando ejecutas . Los ganchos se definen en el archivo de nivel superior . Para instalar los ganchosgit commit.pre-commit-config.yaml
python -m pip install pre-commit
pre-commit install
Los ganchos también se pueden ejecutar manualmente. Todos los ganchos se pueden ejecutar, en el orden indicado en .pre-commit-config.yaml, en el código base completo con
pre-commit run --all-files
Para ejecutar un gancho en particular manualmente, ejecute con la identificación del ganchopre-commit run
pre-commit run <hook id> --all-files