Configurando o Matplotlib para desenvolvimento #
Para configurar o Matplotlib para desenvolvimento, siga estas etapas:
Recupere a versão mais recente do código #
Matplotlib está hospedado em https://github.com/matplotlib/matplotlib.git .
Você pode recuperar as fontes mais recentes com o comando (consulte Configurar seu fork para obter mais detalhes)
git clone https://github.com/matplotlib/matplotlib.git
git clone [email protected]:matplotlib/matplotlib.git
Isso exige que você configure uma chave SSH com antecedência, mas evita que você digite sua senha em todas as conexões.
Isso colocará as fontes em um diretório matplotlibabaixo do seu diretório de trabalho atual. Mude para este diretório:
cd matplotlib
Crie um ambiente dedicado #
Você deve configurar um ambiente dedicado para separar seu desenvolvimento Matplotlib de outras instalações Python e Matplotlib em seu sistema.
A maneira mais simples de fazer isso é usar o ambiente virtual do Python venv ou conda .
Crie um novo ambiente venv com
python -m venv <file folder location>
e ative-o com um dos seguintes
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
Lembre-se de ativar o ambiente sempre que começar a trabalhar no Matplotlib.
Instale o Matplotlib no modo editável #
Instale o Matplotlib no modo editável do matplotlibdiretório usando o comando
python -m pip install -ve .
O 'modo editável/de desenvolvimento' constrói tudo e coloca links em seu ambiente Python para que Python possa importar Matplotlib de seu diretório de origem de desenvolvimento. Isso permite que você importe sua versão modificada do Matplotlib sem reinstalar após cada alteração. Observe que isso só é verdade para *.pyarquivos. Se você alterar a origem da extensão C (o que também pode acontecer se você alterar as ramificações), será necessário executar novamente
python -m pip install -ve .
Instalar dependências de desenvolvimento adicionais #
Consulte Dependências para construir o Matplotlib .
Instalar ganchos de pré-confirmação (opcional) #
ganchos de pré-commit verificam automaticamente flake8 e outros problemas de estilo quando você executa . Os ganchos são definidos no arquivo de nível superior . Para instalar os ganchosgit commit.pre-commit-config.yaml
python -m pip install pre-commit
pre-commit install
Os ganchos também podem ser executados manualmente. Todos os ganchos podem ser executados, na ordem listada em .pre-commit-config.yaml, na base de código completa com
pre-commit run --all-files
Para executar um gancho específico manualmente, execute com o id do ganchopre-commit run
pre-commit run <hook id> --all-files