Matplotlib für die Entwicklung einrichten #

Gehen Sie folgendermaßen vor, um Matplotlib für die Entwicklung einzurichten:

Rufen Sie die neueste Version des Codes # ab

Matplotlib wird unter https://github.com/matplotlib/matplotlib.git gehostet .

Sie können die neuesten Quellen mit dem Befehl abrufen ( weitere Informationen finden Sie unter Fork einrichten) .

git clone https://github.com/matplotlib/matplotlib.git

git clone [email protected]:matplotlib/matplotlib.git

Dies erfordert, dass Sie im Voraus einen SSH-Schlüssel einrichten, erspart Ihnen jedoch die Eingabe Ihres Passworts bei jeder Verbindung.

Dadurch werden die Quellen in einem Verzeichnis matplotlibunterhalb Ihres aktuellen Arbeitsverzeichnisses abgelegt. Wechseln Sie in dieses Verzeichnis:

cd matplotlib

Erstellen Sie eine dedizierte Umgebung #

Sie sollten eine dedizierte Umgebung einrichten, um Ihre Matplotlib-Entwicklung von anderen Python- und Matplotlib-Installationen auf Ihrem System zu entkoppeln.

Der einfachste Weg, dies zu tun, besteht darin, entweder Pythons virtuelle Umgebung venv oder conda zu verwenden .

Erstellen Sie eine neue venv- Umgebung mit

python -m venv <file folder location>

und aktivieren Sie es mit einer der folgenden Optionen

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

Erstellen Sie eine neue Conda- Umgebung mit

conda env create -f environment.yml

Sie können mambaanstelle von condaim obigen Befehl verwenden, wenn Sie Mamba installiert haben.

Aktivieren Sie die Umgebung mit

conda activate mpl-dev

Denken Sie daran, die Umgebung zu aktivieren, wenn Sie mit der Arbeit an Matplotlib beginnen.

Installieren Sie Matplotlib im bearbeitbaren Modus #

Installieren Sie Matplotlib im bearbeitbaren Modus aus dem matplotlibVerzeichnis mit dem Befehl

python -m pip install -ve .

Der 'bearbeitbare/Entwicklungsmodus' erstellt alles und platziert Links in Ihrer Python-Umgebung, sodass Python Matplotlib aus Ihrem Entwicklungsquellverzeichnis importieren kann. Auf diese Weise können Sie Ihre modifizierte Version von Matplotlib importieren, ohne nach jeder Änderung neu installieren zu müssen. Beachten Sie, dass dies nur für *.pyDateien gilt. Wenn Sie die Quelle der C-Erweiterung ändern (was auch passieren kann, wenn Sie Zweige ändern), müssen Sie sie erneut ausführen python -m pip install -ve .

Zusätzliche Entwicklungsabhängigkeiten installieren #

Siehe Abhängigkeiten zum Erstellen von Matplotlib .

Pre-Commit-Hooks installieren (optional) #

Pre-Commit- Hooks überprüfen automatisch flake8 und andere Stilprobleme, wenn Sie . Die Hooks sind in der Datei der obersten Ebene definiert . Um die Haken zu installierengit commit.pre-commit-config.yaml

python -m pip install pre-commit
pre-commit install

Die Haken können auch manuell ausgeführt werden. Alle Hooks können in der in aufgeführten Reihenfolge .pre-commit-config.yamlgegen die vollständige Codebasis mit ausgeführt werden

pre-commit run --all-files

Um einen bestimmten Hook manuell auszuführen, führen Sie ihn mit der Hook-ID auspre-commit run

pre-commit run <hook id> --all-files