Ajoute le diagramme de longévité des personnages

lib/rebrickable/minifig_characters.py

@@ -2,7 +2,7 @@
 
 from collections import defaultdict
 from pathlib import Path
-from typing import Dict, Iterable, List, Sequence
+from typing import Dict, Iterable, List, Sequence, Set
 
 from lib.rebrickable.stats import read_rows
 from lib.filesystem import ensure_parent_dir
@@ -99,3 +99,55 @@ def write_presence_by_year(path: Path, rows: Sequence[dict]) -> None:
         writer.writeheader()
         for row in rows:
             writer.writerow(row)
+
+
+def aggregate_character_spans(
+    minifigs_rows: Iterable[dict],
+    sets_years: Dict[str, str],
+    excluded_characters: Sequence[str] | None = None,
+) -> List[dict]:
+    """Calcule la période d'apparition de chaque personnage (bornes min/max des années observées)."""
+    excluded = set(excluded_characters or [])
+    spans: Dict[str, Dict[str, int]] = {}
+    total_counts: Dict[str, int] = defaultdict(int)
+    for row in minifigs_rows:
+        character = row["known_character"].strip()
+        fig_num = row["fig_num"].strip()
+        if character == "" or fig_num == "":
+            continue
+        if character in excluded:
+            continue
+        year = sets_years.get(row["set_num"])
+        if year is None:
+            continue
+        year_int = int(year)
+        total_counts[character] += 1
+        current = spans.get(character)
+        if current is None:
+            spans[character] = {"start": year_int, "end": year_int}
+        else:
+            spans[character]["start"] = min(current["start"], year_int)
+            spans[character]["end"] = max(current["end"], year_int)
+    results: List[dict] = []
+    for character, bounds in spans.items():
+        results.append(
+            {
+                "known_character": character,
+                "start_year": str(bounds["start"]),
+                "end_year": str(bounds["end"]),
+                "total_minifigs": str(total_counts[character]),
+            }
+        )
+    results.sort(key=lambda r: (int(r["start_year"]), int(r["end_year"]), r["known_character"]))
+    return results
+
+
+def write_character_spans(path: Path, rows: Sequence[dict]) -> None:
+    """Écrit le CSV des bornes min/max par personnage."""
+    ensure_parent_dir(path)
+    fieldnames = ["known_character", "start_year", "end_year", "total_minifigs"]
+    with path.open("w", newline="") as csv_file:
+        writer = csv.DictWriter(csv_file, fieldnames=fieldnames)
+        writer.writeheader()
+        for row in rows:
+            writer.writerow(row)