MEP8: PEP8 #

Status #

Abgeschlossen

Wir erzwingen derzeit eine Teilmenge von pep8 für neue Codebeiträge.

Die Matplotlib-Codebasis ist älter als PEP8 und daher in manchen Bereichen weniger konsistent im Stil. Die Codebasis in Übereinstimmung mit PEP8 zu bringen, würde einen großen Beitrag zur Verbesserung ihrer Lesbarkeit leisten.

Detaillierte Beschreibung #

Einige Dateien verwenden vier Leerzeicheneinzüge, andere drei. Einige verwenden unterschiedliche Ebenen in derselben Datei.

Zum größten Teil folgt die Benennung von Klassen/Funktionen/Variablen PEP8, aber es würde nicht schaden, wenn nötig zu korrigieren.

Implementierung #

Die Implementierung sollte ziemlich mechanisch sein: das pep8-Tool über den Code laufen lassen und gegebenenfalls korrigieren.

Dies sollte nach der 2.0-Version zusammengeführt werden, da die Änderungen wahrscheinlich das Zusammenführen aller ausstehenden Pull-Anforderungen erschweren werden.

Zusätzlich und optional könnte die PEP8-Compliance durch ein automatisiertes Build-System nachverfolgt werden.

Abwärtskompatibilität #

Öffentliche Namen von Klassen und Funktionen, die geändert werden müssen (es sollte nicht viele davon geben), sollten zuerst als veraltet markiert und dann im nächsten Release-Zyklus entfernt werden.

Alternativen #

PEP8 ist ein beliebter Standard für den Python-Codestil, der von den Python-Kernentwicklern gesegnet wurde und Alternativen weniger wünschenswert macht.