truthound-dashboard 1.4.3__py3-none-any.whl → 1.5.0__py3-none-any.whl

truthound_dashboard/core/notifications/routing/__init__.py

@@ -1,169 +1,129 @@
-"""Advanced routing engine for notification dispatch.
+"""Advanced routing engine using truthound.checkpoint.routing.
 
-This module provides a flexible, rule-based routing system for directing
-notifications to appropriate channels based on configurable conditions.
+This module provides a routing system for directing notifications to
+appropriate channels, using truthound's routing infrastructure.
 
-Features:
-    - 13 built-in rule types (severity, issue count, time window, expression, jinja2, etc.)
-    - Rule combinators (AllOf, AnyOf, NotRule)
-    - Plugin architecture for custom rules
-    - YAML/JSON configuration support
-    - Priority-based route ordering
-    - Safe Python expression evaluation for complex routing conditions
-    - Jinja2 template-based rules for flexible matching (optional)
+Key Components from truthound.checkpoint.routing:
+    - ActionRouter: Main routing engine with route modes
+    - Route: Defines a route with rule, actions, and priority
+    - RouteContext: Context data for rule evaluation
+    - RouteMode: FIRST_MATCH, ALL_MATCHES, PRIORITY_GROUP
 
-Example:
-    from truthound_dashboard.core.notifications.routing import (
-        ActionRouter,
-        Route,
-        RouteContext,
-        SeverityRule,
-        ExpressionRule,
-        AllOf,
-    )
+Built-in Rules from truthound (11 types):
+    - AlwaysRule / NeverRule: Always match / never match
+    - SeverityRule: Match based on issue severity
+    - IssueCountRule: Match based on issue count
+    - StatusRule: Match based on checkpoint status
+    - TagRule: Match based on tag presence/value
+    - DataAssetRule: Match based on data asset name pattern
+    - MetadataRule: Match based on metadata values
+    - TimeWindowRule: Match based on time period
+    - PassRateRule: Match based on pass rate
+    - ErrorRule: Match based on error occurrence
 
-    # Create rules
-    critical_rule = SeverityRule(min_severity="critical")
-    production_rule = TagRule(tags=["production"])
-    combined_rule = AllOf(rules=[critical_rule, production_rule])
+Combinators from truthound:
+    - AllOf: All rules must match (AND)
+    - AnyOf: At least one rule must match (OR)
+    - NotRule: Invert rule result (NOT)
 
-    # Python expression-based rule for complex conditions
-    expr_rule = ExpressionRule(
-        expression="severity == 'critical' and pass_rate < 0.8",
+Example:
+    from truthound.checkpoint.routing import (
+        ActionRouter, Route, AllOf
     )
+    from truthound.checkpoint.routing.rules import (
+        SeverityRule, TagRule
+    )
+    from truthound.checkpoint.routing.base import RouteMode
+
+    # Create rules using truthound
+    critical_prod_rule = AllOf([
+        SeverityRule(min_severity="critical"),
+        TagRule(tags={"env": "prod"}),
+    ])
 
     # Create route
     route = Route(
-        name="critical_production",
-        rule=combined_rule,
-        actions=["channel-1", "channel-2"],
+        name="critical_prod",
+        rule=critical_prod_rule,
+        actions=[PagerDutyAction(...)],
         priority=100,
     )
 
-    # Create router and match
-    router = ActionRouter(routes=[route])
-    context = RouteContext(event=event, metadata={"tags": ["production"]})
-    matched_routes = await router.match(context)
+    # Create router
+    router = ActionRouter(mode=RouteMode.ALL_MATCHES)
+    router.add_route(route)
 """
 
-from .combinators import AllOf, AnyOf, NotRule
-from .config import RouteConfigParser
-from .config_parser import (
-    ConfigBuilder,
-    ConfigParser,
-    RouteConfig,
-    RoutingConfig,
-    parse_routing_config,
+# Re-export from truthound.checkpoint.routing
+from truthound.checkpoint.routing import (
+    ActionRouter,
+    Route,
+    AllOf,
+    AnyOf,
+    NotRule,
 )
-from .engine import ActionRouter, Route, RouteContext, RoutingResult
-from .expression_engine import (
-    ExpressionContext,
-    ExpressionError,
-    ExpressionRule,
-    ExpressionSecurityError,
-    ExpressionTimeout,
-    SafeExpressionEvaluator,
+from truthound.checkpoint.routing.base import (
+    RouteContext,
+    RouteMode,
+    RoutePriority,
 )
-from .rules import (
+from truthound.checkpoint.routing.rules import (
     AlwaysRule,
-    BaseRule,
-    DataAssetRule,
-    ErrorRule,
-    IssueCountRule,
-    MetadataRule,
     NeverRule,
-    PassRateRule,
-    RuleRegistry,
     SeverityRule,
+    IssueCountRule,
     StatusRule,
     TagRule,
+    DataAssetRule,
+    MetadataRule,
     TimeWindowRule,
-)
-from .validator import (
-    RuleValidationConfig,
-    RuleValidationError,
-    RuleValidationResult,
-    RuleValidator,
-    ValidationError,
-    ValidationErrorType,
-    ValidationWarning,
-    validate_rule_config,
+    PassRateRule,
+    ErrorRule,
 )
 
-# Jinja2 support (optional dependency)
-try:
-    from .jinja2_engine import (
-        JINJA2_AVAILABLE,
-        Jinja2Evaluator,
-        Jinja2Rule,
-        Jinja2SecurityError,
-        Jinja2TemplateError,
-        Jinja2TimeoutError,
-        TemplateNotificationFormatter,
-    )
-except ImportError:
-    JINJA2_AVAILABLE = False
-    Jinja2Evaluator = None  # type: ignore
-    Jinja2Rule = None  # type: ignore
-    Jinja2TemplateError = None  # type: ignore
-    Jinja2TimeoutError = None  # type: ignore
-    Jinja2SecurityError = None  # type: ignore
-    TemplateNotificationFormatter = None  # type: ignore
+# Dashboard-specific adapters for backward compatibility
+from .engine import (
+    DashboardRouteContext,
+    DashboardRoutingResult,
+    create_route_context_from_event,
+)
+from .config_parser import (
+    ConfigParser,
+    RouteConfig,
+    RoutingConfig,
+    parse_routing_config,
+)
 
 __all__ = [
-    # Base
-    "BaseRule",
-    "RuleRegistry",
-    # Rules
+    # truthound core
+    "ActionRouter",
+    "Route",
+    "RouteContext",
+    "RouteMode",
+    "RoutePriority",
+    # truthound rules
+    "AlwaysRule",
+    "NeverRule",
     "SeverityRule",
     "IssueCountRule",
-    "PassRateRule",
-    "TimeWindowRule",
+    "StatusRule",
     "TagRule",
     "DataAssetRule",
     "MetadataRule",
-    "StatusRule",
+    "TimeWindowRule",
+    "PassRateRule",
     "ErrorRule",
-    "AlwaysRule",
-    "NeverRule",
-    "ExpressionRule",
-    # Expression Engine
-    "ExpressionContext",
-    "ExpressionError",
-    "ExpressionTimeout",
-    "ExpressionSecurityError",
-    "SafeExpressionEvaluator",
-    # Combinators
+    # truthound combinators
     "AllOf",
     "AnyOf",
     "NotRule",
-    # Engine
-    "ActionRouter",
-    "Route",
-    "RouteContext",
-    "RoutingResult",
+    # Dashboard adapters
+    "DashboardRouteContext",
+    "DashboardRoutingResult",
+    "create_route_context_from_event",
     # Config
-    "RouteConfigParser",
     "ConfigParser",
-    "ConfigBuilder",
     "RouteConfig",
     "RoutingConfig",
     "parse_routing_config",
-    # Validator
-    "RuleValidator",
-    "RuleValidationConfig",
-    "RuleValidationResult",
-    "RuleValidationError",
-    "ValidationError",
-    "ValidationErrorType",
-    "ValidationWarning",
-    "validate_rule_config",
-    # Jinja2 (optional)
-    "JINJA2_AVAILABLE",
-    "Jinja2Evaluator",
-    "Jinja2Rule",
-    "Jinja2TemplateError",
-    "Jinja2TimeoutError",
-    "Jinja2SecurityError",
-    "TemplateNotificationFormatter",
 ]