Utilisez cette page quand vous souhaitez vérifier que BranchPy est utile avant une configuration approfondie.
Objectif
En 10 minutes, vous allez :
- lancer une analyse complète,
- ouvrir le flowchart,
- exécuter les diagnostics,
- scanner les médias,
- comparer deux exécutions.
1) Analyze
branchpy --project <path> analyze --open--open génère un rapport HTML autonome et l'ouvre dans votre navigateur par défaut. VS Code n'est pas requis.
Résultat attendu :
- Résumé des labels/erreurs/avertissements
- Rapport et liens vers les vues supplémentaires
2) Ouvrir le Flowchart
branchpy --project <path> flowchart --open--open génère un flowchart HTML interactif et l'ouvre dans votre navigateur. Dans VS Code, utilisez le bouton Flowchart du Control Center pour accéder au panneau interactif.
Recherchez :
- les zones déconnectées,
- les impasses,
- les embranchements anormalement denses.
Figure : Vue Flowchart montrant la structure globale de la narration.
3) Lancer Doctor
branchpy --project <path> doctor --jsonUtilisez cette commande quand :
- la configuration semble défaillante,
- les commandes échouent de façon inattendue,
- la cohérence de l'environnement est incertaine.
4) Lancer Media Validation
branchpy --project <path> media --openUtilisez cette commande quand :
- vous préparez une release,
- vous nettoyez d'anciens assets,
- vous investiguez des références manquantes.
5) Comparer deux exécutions
branchpy compare --old <runA> --new <runB> --jsonUtilisez cette commande quand :
- vous révisez des modifications de branches,
- vous vérifiez si des corrections ont introduit des régressions.
Durées d'exécution typiques
- Petit VN (<200 labels) : 2–5 secondes
- VN moyen (200–1 000 labels) : 10–30 secondes
- Grand VN (>1 000 labels) : 30–120 secondes
Liste de contrôle de confiance
- S'exécute en local.
- L'analyse ne modifie pas vos fichiers source.
- Le mode déterministe permet des vérifications CI reproductibles.
- Les fonctionnalités IA sont optionnelles.