From 76499d46e3bd0272f5ac09399b0b6fb91ca0eff0 Mon Sep 17 00:00:00 2001 From: codex Date: Wed, 20 May 2026 06:16:23 -0300 Subject: [PATCH] style(ariadne): document testing triage scope helpers --- ariadne/services/testing_triage_scope.py | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/ariadne/services/testing_triage_scope.py b/ariadne/services/testing_triage_scope.py index ce9d1b9..426d6bf 100644 --- a/ariadne/services/testing_triage_scope.py +++ b/ariadne/services/testing_triage_scope.py @@ -24,6 +24,8 @@ _TEST_SUITE_ALIASES = { def metric_suite_names(quality: dict[str, Any]) -> set[str]: + """Return canonical in-scope suite names found in quality metrics.""" + suites: set[str] = set() for bucket in quality.values(): if not isinstance(bucket, dict): @@ -39,6 +41,8 @@ def metric_suite_names(quality: dict[str, Any]) -> set[str]: def jenkins_suites(jenkins: dict[str, Any]) -> set[str]: + """Return canonical in-scope suite names found in Jenkins failures.""" + suites: set[str] = set() for item in jenkins.get("failed_builds") or []: if not isinstance(item, dict): @@ -50,14 +54,20 @@ def jenkins_suites(jenkins: dict[str, Any]) -> set[str]: def quality_items_in_scope(items: list[dict[str, Any]]) -> list[dict[str, Any]]: + """Filter quality metric items to suites that should affect triage.""" + return [item for item in items if _quality_item_in_scope(item)] def suite_in_scope(value: Any) -> bool: + """Return whether a raw suite-like value belongs in quality triage.""" + return canonical_suite_name(value) in IN_SCOPE_TEST_SUITES def canonical_suite_name(value: Any) -> str: + """Normalize suite/job labels so dashboards and triage agree.""" + name = str(value or "").strip().lower() if "/" in name: name = name.rsplit("/", 1)[-1]