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 Regelpython3.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
- Zuerst Komplexitaets-Hotspots mit festem Threshold erfassen.
- Die schlimmsten Funktionen in kleine, testbare Schritte zerlegen statt den ganzen Modulbaum gleichzeitig zu bewegen.
- 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