BranchPy
Se connecter

Les 10 premières minutes avec BranchPy

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. Si vous êtes dans VS Code avec l'extension BranchPy, le panneau Control Center s'ouvre à la place.

Recherchez :

  • les zones déconnectées,
  • les impasses,
  • les embranchements anormalement denses.
Vue d'ensemble du Flowchart

Figure : Vue Flowchart montrant la structure globale de la narration.

3) Lancer Doctor

branchpy --project <path> doctor --json

Utilisez 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 --open

Utilisez 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> --json

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

Prochaines étapes