ManifestGuard Python

ManifestGuard Python (MGPY)

ManifestGuard Python est une quality gate CLI pour depots Python. Il aide les equipes a maintenir une qualite mesurable et reproductible, en local et dans les pipelines CI.

Controles principaux

• Budgets de complexite (fonctions, classes, modules)
• Detection de duplications de code
• Visibilite des risques lies aux dependances
• Baselines de refactorisation avec indices AI toujours actifs
• Rapports lisibles par machine adaptes a la validation CI et aux gates de release
• Sorties structurees pour les gates pipeline

Surfaces dashboard

• manifestguard dashboard reste la surface TUI de base
• Le dashboard desktop local est inclus a partir de Pro
• Les concepts de dashboard web/equipe partages restent cote Team/Enterprise

Demarrage & activation

• Prerequis: Le chemin standard documente utilise Python 3.12 avec pip ; sous Windows generalement via py -3.12, sous Linux/macOS generalement via python3.12.
• Versions de projet: Independamment de l interpreteur utilise pour executer mgpy, l outil peut analyser des projets Python, des metadonnees de packaging et des cibles d outils pour des versions cibles de 3.8 a 3.12 ; le runtime mgpy lui-meme est actuellement valide sur Python 3.10 a 3.13.
• Bibliotheques runtime: Une installation standard via pip installe automatiquement les paquets runtime requis : tomlkit, click, pydantic, packaging, watchdog, PyNaCl et rfc8785 ; seul Python inferieur a 3.11 ajoute tomli.
• Commencez par Installation & Download pour le parcours concret de telechargement, d installation et de configuration.
• Installez en user-wide avec py -3.12 -m pip install --user manifestguard; epinglez une version precise avec py -3.12 -m pip install --user "manifestguard==<VERSION>".
• Apres achat, connectez-vous dans l espace client via /login, puis passez a /license/activate.
• Saisissez ensuite la cle de licence et le device hash local obtenu avec py -3.12 -m manifestguard license device-hash, puis recopiez le token d activation renvoye par le portail.
• Activez localement avec py -3.12 -m manifestguard license activate <TOKEN> et verifiez avec py -3.12 -m manifestguard license status; ce meme token pourra ensuite etre reutilise dans MGVS.

Integration workflow

Les controles s executent localement avant commit, puis avec les memes criteres en CI. MGPY privilegie un comportement deterministe et une execution sans intervention. Les commandes CLI et les sorties lisibles par machine conviennent aux gates de release et aux politiques d equipe. Un manifeste de regles de refactorisation garde le guidage de refactorisation assistee par AI explicite et repetable.

Objectif: clarte, pas punition. Une commande donne un statut qualite exploitable.