Python Package

Analyse des tendances

Visualiser et interpreter les tendances de long terme des metriques qualite dans l historique ManifestGuard.

Accès anticipé: Jusquu2019au 2026-12-31

Pour mgpy, les tendances prouvent si les ameliorations tiennent dans le temps ou si l erosion commence tot. Un bon run isole ne remplace pas une vision historique.

Points cles

  • CLI: Sous Windows, les exemples utilisent la forme recommandee py -3.12 -m <module> ... (par ex. py -3.12 -m manifestguard ...). Sous Linux/macOS, cela correspond generalement a python3.12 -m ....
  • Les agregats hebdomadaires, baselines et entrees d historique rendent les variations qualite tangibles.
  • Une couverture absente doit etre lue comme une lacune de mesure et non comme un zero artificiel.
  • La vue tendance devient tres utile apres plusieurs releases ou series de refactorings.

Workflow mgpy recommande

  1. Ecrire rapports et historiques regulierement pour disposer d assez de points de comparaison.
  2. Rattacher les degradations visibles a des commits, releases ou changements de regles precis.
  3. Lire les graphiques avec contexte: une lacune de mesure n est pas une vraie amelioration de qualite.

Demarrage rapide

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

Prérequis

Colonnes
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.