Python Package

Trendanalyse

Langfristige Qualitaetsmetrik-Trends aus der ManifestGuard-History visualisieren und interpretieren.

Früher Zugriff: Bis 2026-12-31

Trends sind fuer mgpy der Nachweis, dass Verbesserungen halten oder Erosion frueh beginnt. Einzelne gute Laeufe ersetzen keine Verlaufssicht.

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 ....
  • Wochenwerte, Baselines und Historieneintraege machen Qualitaetsveraenderungen greifbar.
  • Fehlende Coverage-Daten muessen als Luecke und nicht als kuenstliche Null interpretiert werden.
  • Trendansicht ist besonders wertvoll nach mehreren Releases oder Refactoring-Serien.

Empfohlener MG-Python-Workflow

  1. Regelmaessig Reports und History-Dateien schreiben, damit genug Vergleichspunkte entstehen.
  2. Auffaellige Verschlechterungen auf konkrete Commits, Releases oder Regelwechsel zurueckfuehren.
  3. Charts nur mit dem Kontexthintergrund lesen: ein Messlueckenproblem ist keine echte Qualitaetsverbesserung.

Schnellstart

py -3.12 -m manifestguard baseline --list
py -3.12 -m manifestguard export-metrics --output metrics.json
py -3.12 -m manifestguard check --extended --report .manifestguard/manifestguard-report.json

Voraussetzungen

Spalten
Installation interpreter
Python 3.12 + pip
Recommended default path for installation and CLI calls.
Project target versions
Python 3.8 to 3.12
These are the project/runtime targets mgpy can analyze.
mgpy runtime
Validated on Python 3.10 to 3.13
The tool runtime itself is covered for this range.
CLI invocation
Windows: py -3.12 -m manifestguard
Linux/macOS usually maps to python3.12 -m manifestguard.
Runtime packages
tomlkit, click, pydantic, packaging, watchdog, PyNaCl, rfc8785
tomli is only added for Python below 3.11.
Offline / wheel install
Optional via pip --no-index or wheel
Useful for air-gapped or approved bundle distribution paths.