Accès anticipé
Python Package

Coherence du code

Faire respecter des standards de code et un style coherents dans un projet Python.

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

Retour Aperçu Prérequis

Dans mgpy, la coherence n est pas un detail cosmetique: un chemin d outillage et de style clair reduit la friction de revue, les faux positifs et les rapports instables.

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 ....
  • Ruff est le moteur unique privilegie pour linting, formatage et organisation des imports.
  • Un pyproject.toml partage est plus fiable que plusieurs configurations d outils concurrentes.
  • Corriger la cause racine des findings repetes au lieu de les masquer par des suppressions.

Workflow mgpy recommande

  1. Definir un seul jeu de regles partage dans le depot.
  2. Stabiliser Ruff et le formatage avant les checks etendus mgpy.
  3. Executer mgpy ensuite afin que les rapports reposent sur une base de style stable.

Demarrage rapide

py -3.12 -m ruff check . --fix
py -3.12 -m ruff format .
py -3.12 -m manifestguard check --extended

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.