Pour mgpy, PEP 8 constitue la ligne de base lisible. De bonnes regles de style accelerent le debogage, reduisent la charge cognitive et ecourtent les revues.
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 apython3.12 -m .... - Utiliser le formatage automatique de maniere coherente au lieu des retouches manuelles.
- Conserver la meme organisation des imports, les memes longueurs de ligne et une nomenclature stable dans tout le depot.
- Considerer les regles de style comme un prerequis aux checks etendus, pas comme une tache de fin.
Workflow mgpy recommande
- Figer les regles Ruff dans le projet et corriger automatiquement ce qui peut l etre.
- Avant un gros refactoring, supprimer la derive de style afin que les changements logiques restent lisibles en revue.
- Relancer mgpy apres le formatage pour ne traiter que les vrais signaux qualite.
Demarrage rapide
py -3.12 -m ruff check . --fix
py -3.12 -m ruff format .
py -3.12 -m manifestguard check