Python Package

Komplexitaet reduzieren

Techniken zur Messung und Reduktion zyklomatischer und kognitiver Komplexitaet in Python.

Früher Zugriff: Bis 2026-12-31

mgpy behandelt Komplexitaet als messbares Refactoring-Ziel: Hotspots sollen sichtbar, vergleichbar und ueber Baselines hinweg nachvollziehbar sein.

Kernpunkte

  • CLI: Unter Windows zeigen die Beispiele den empfohlenen Aufruf via py -3.12 -m <modul> ... (z.B. py -3.12 -m manifestguard ...). Auf Linux/macOS entspricht das in der Regel python3.12 -m ....
  • Der eingebaute AST-Analyzer ist der Default und liefert stabile Verlaufsdaten.
  • Fruehe Returns, kleinere Helferfunktionen und klarere Verantwortungen senken Verstosszahlen schneller als reine Umformatierung.
  • Vor groesseren Umbauten immer einen Baseline-Punkt speichern.

Empfohlener MG-Python-Workflow

  1. Zuerst Komplexitaets-Hotspots mit festem Threshold erfassen.
  2. Die schlimmsten Funktionen in kleine, testbare Schritte zerlegen statt den ganzen Modulbaum gleichzeitig zu bewegen.
  3. Nach jedem Refactoring den Vergleich gegen die gespeicherte Baseline laufen lassen.

Schnellstart

py -3.12 -m manifestguard complexity --threshold 12
py -3.12 -m manifestguard baseline --save-label pre-refactor
py -3.12 -m manifestguard baseline --compare pre-refactor