Ajouter graph_sankey pour tracer des flux Sankey et couvrir les validations d’entrée

[Copilot]

L’issue demandait l’ajout d’une fonction pour produire un graphique de Sankey (flux). Cette PR introduit une API dédiée dans le module FAQ Python avec des contrôles d’intégrité des flux et des tests ciblés.

• Nouvelle API Sankey

  • Ajout de graph_sankey dans teachpyx.faq.faq_python.
  • Génère un diagramme via matplotlib.sankey.Sankey.
  • Supporte flows, labels, orientations, ax, title, et passthrough **kwargs vers Sankey.add.

• Validations d’entrée

  • Vérifie qu’il y a au moins deux flux.
  • Vérifie l’équilibre global des flux (somme proche de zéro avec tolérance dédiée).
  • Vérifie la cohérence des longueurs flows / labels / orientations.
  • Messages d’erreur enrichis avec les valeurs observées pour faciliter le diagnostic.

• Couverture unitaire

  • Extension de _unittests/ut_faq/test_faq_python.py :
    • cas nominal (création du diagramme + titre),
    • cas invalides (taille insuffisante, flux non équilibrés, longueurs incohérentes).

from teachpyx.faq.faq_python import graph_sankey

ax, diagrams = graph_sankey(
    [1, -0.25, -0.75],
    labels=["input", "loss", "output"],
    orientations=[0, 1, -1],
    title="flux",
)

[xadupre]

@copilot ajoute un exemple à la documentation

[Copilot]

C’est fait dans le commit 146049e : j’ai ajouté un exemple d’utilisation concret dans la docstring de graph_sankey.