fix(report): corrections d'audit du sprint de découpage de generator.py

Suite à un auto-audit du commit d641f6e, deux problèmes corrigés :

1. **5 ré-exports rétrocompat inutilisés (ruff F401)**.
J'avais ajouté 9 alias ``_*`` au top de generator.py par excès
de rétrocompat. Audit cross-référencé des tests : seuls 2 sont
réellement consommés depuis ``picarones.report.generator`` :
- ``_build_report_data`` (importé par 14 tests)
- ``_cer_color`` (importé par tests/report/test_report.py)
Plus 3 utilisés en interne (``_load_vendor_js``,
``_externalize_images_to_dir``, ``_encode_images_b64_from_result``).
Les 4 autres (``_pct``, ``_safe``, ``_cer_bg``, ``_encode_image_b64``)
ne sont importés par personne — supprimés. Les 2 ré-exports
conservés sont marqués ``# noqa: F401`` avec commentaire
explicatif documentant l'intention de ré-export.

2. **test_generator_imports_three_views trop laxiste**.
Mon assouplissement précédent acceptait la chaîne
``"economics_view_html"`` n'importe où dans generator.py
(y compris dans une docstring). Faux positif possible : si
on supprime le splat ``**section_html`` mais qu'une chaîne
subsiste dans un commentaire, le test passe à tort.
Remplacé par un vrai test runtime qui :
- instancie ``ReportGenerator``
- appelle ``_build_section_html`` avec un report_data minimal
- vérifie que le dict retourné contient les 3 clés attendues
- vérifie que chaque valeur est bien une chaîne (adaptive : "")
Garantit le contrat fonctionnel, pas la forme du code.

Vérifications post-fix :
- ruff check picarones/ tests/architecture/ → All checks passed!
- pytest tests/ → 3830 passed, 2 skipped (parité stricte)
- mypy : 30 erreurs (vs 48 avant le découpage — réduction nette,
toutes restantes sont des [type-arg] sur ``dict`` désactivés
par la config projet [tool.mypy] disallow_any_generics=false).

picarones/report/generator.py

@@ -23,11 +23,20 @@ découpées en sous-modules :
   passé au template (engines, documents, statistiques, Pareto, etc.).
 - :mod:`picarones.report.render_helpers` — couleurs / SVG mutualisés.
 
-Les noms ``_build_report_data``, ``_cer_color``, ``_cer_bg``,
-``_externalize_images_to_dir``, ``_encode_image_b64``,
-``_encode_images_b64_from_result``, ``_load_vendor_js``, ``_pct``,
-``_safe`` sont conservés en alias rétrocompat — plusieurs tests les
-importent directement.
+Rétrocompat
+-----------
+Deux noms historiques sont **encore importés par des tests** sous
+leur préfixe ``_`` et doivent être préservés :
+
+- ``_build_report_data`` (importé par 14 fichiers de tests).
+- ``_cer_color`` (importé par ``tests/report/test_report.py``).
+
+Les autres noms ``_pct``, ``_safe``, ``_cer_bg``, ``_encode_image_b64``,
+``_encode_images_b64_from_result``, ``_externalize_images_to_dir``,
+``_load_vendor_js`` sont soit utilisés en interne (les 3 derniers,
+voir :meth:`ReportGenerator.generate`), soit accessibles via leur
+nom canonique dans :mod:`picarones.report.assets` ou
+:mod:`picarones.report.render_helpers`.
 """
 
 from __future__ import annotations
@@ -40,20 +49,16 @@ from typing import Any, Optional
 from picarones.core.results import BenchmarkResult
 from picarones.measurements.statistics import build_critical_difference_svg
 from picarones.report.assets import (
-    encode_image_b64 as _encode_image_b64,
     encode_images_b64_from_result as _encode_images_b64_from_result,
     externalize_images_to_dir as _externalize_images_to_dir,
     load_vendor_js as _load_vendor_js,
 )
-from picarones.report.render_helpers import (
-    cer_step_bg as _cer_bg,
-    cer_step_color as _cer_color,
-)
-from picarones.report.report_data import build_report_data as _build_report_data
-from picarones.report.report_data._helpers import (
-    percent_string as _pct,
-    safe_round as _safe,
-)
+
+# Ré-exports rétrocompat consommés par les tests externes (cf. docstring
+# de module). La directive de fin de ligne documente l'intention de
+# ré-export et empêche ruff de marquer l'import comme inutilisé.
+from picarones.report.render_helpers import cer_step_color as _cer_color  # noqa: F401
+from picarones.report.report_data import build_report_data as _build_report_data  # noqa: F401
 
 logger = logging.getLogger(__name__)
 

tests/report/test_views.py

@@ -332,36 +332,48 @@ class TestDetailsShell:
 
 class TestGeneratorWiring:
     def test_generator_imports_three_views(self):
-        """generator.py doit importer les 3 vues automatiques (economics,
-        advanced_taxonomy, diagnostics) pour les passer au template.
+        """Test runtime du câblage des 3 vues automatiques (economics,
+        advanced_taxonomy, diagnostics).
 
-        Tolère les deux conventions de câblage : argument nommé
-        ``economics_view_html=...`` ou clé de dict ``"economics_view_html"``
-        splatée via ``**section_html`` (cf. ``_build_section_html``).
+        Vérifie que la méthode ``ReportGenerator._build_section_html``
+        retourne un dict contenant les 3 clés attendues, ce qui
+        garantit qu'elles seront splatées vers le template Jinja.
+
+        Cette version remplace l'ancien test qui scannait textuellement
+        ``generator.py`` à la recherche de ``var=`` ou ``"var"`` —
+        approche fragile (passait sur n'importe quelle occurrence dans
+        une docstring) et trop liée à la forme du code.
         """
-        from pathlib import Path
+        from picarones.fixtures import generate_sample_benchmark
+        from picarones.report.generator import ReportGenerator
 
-        gen_src = (
-            Path(__file__).parent.parent.parent / "picarones" / "report" / "generator.py"
-        ).read_text(encoding="utf-8")
-        # Les 3 imports doivent être présents
-        assert "build_economics_view_html" in gen_src
-        assert "build_advanced_taxonomy_view_html" in gen_src
-        assert "build_diagnostics_view_html" in gen_src
-        # Et les 3 variables doivent être câblées vers le template, soit
-        # par argument explicite (``var=...``), soit par clé de dict
-        # splatée (``"var": ...``).
+        bench = generate_sample_benchmark()
+        gen = ReportGenerator(bench, lang="fr")
+        from picarones.i18n import get_labels
+
+        report_data = {
+            "engines": [],
+            "inter_engine_analysis": None,
+            "stratified_ranking": None,
+            "available_strata": [],
+            "corpus_homogeneity": None,
+        }
+        section_html = gen._build_section_html(report_data, get_labels("fr"))
         for name in (
             "economics_view_html",
             "advanced_taxonomy_view_html",
             "diagnostics_view_html",
         ):
-            assert (
-                f"{name}=" in gen_src
-                or f'"{name}"' in gen_src
-            ), (
-                f"variable {name!r} ni argument nommé ni clé de dict "
-                "dans generator.py"
+            assert name in section_html, (
+                f"clé {name!r} absente du dict retourné par "
+                "ReportGenerator._build_section_html — la vue ne sera "
+                "pas câblée vers le template."
+            )
+            # Adaptive : avec un report_data vide, chaque vue retourne ""
+            # (rapport adaptatif). On vérifie le type, pas le contenu.
+            assert isinstance(section_html[name], str), (
+                f"section {name!r} doit être une chaîne, "
+                f"pas {type(section_html[name]).__name__}"
             )
 
     def test_template_uses_three_views(self):