pylitmus 1.0.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

pylitmus/__init__.py

@@ -26,9 +26,9 @@ from .storage import (
     RuleRepository,
 )
 from .strategies import MaxStrategy, ScoringStrategy, SumStrategy, WeightedStrategy
-from .types import AssessmentResult, Operator, Rule, RuleResult, Severity
+from .types import AssessmentResult, DecisionTier, Operator, Rule, RuleResult, Severity
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"
 
 __all__ = [
     # Main
@@ -40,6 +40,7 @@ __all__ = [
     "Rule",
     "RuleResult",
     "AssessmentResult",
+    "DecisionTier",
     "Operator",
     "Severity",
     # Conditions

pylitmus/engine.py

@@ -7,7 +7,7 @@ import time
 from typing import TYPE_CHECKING, Any, Dict, List, Optional
 
 from .exceptions import EvaluationError
-from .types import AssessmentResult, Rule, RuleResult
+from .types import AssessmentResult, DecisionTier, Rule, RuleResult
 
 if TYPE_CHECKING:
     from .storage.base import RuleRepository
@@ -21,24 +21,34 @@ class RuleEngine:
     Main rules engine for evaluating data against configured rules.
 
     Usage:
+        # Without decision tiers (returns None for decision)
         engine = RuleEngine(
             repository=DatabaseRuleRepository(db_url),
             scoring_strategy=WeightedStrategy()
         )
 
+        # With user-defined decision tiers
+        engine = RuleEngine(
+            repository=DatabaseRuleRepository(db_url),
+            scoring_strategy=WeightedStrategy(),
+            decision_tiers=[
+                DecisionTier("AUTO_APPROVE", 0, 20, "Very low risk"),
+                DecisionTier("APPROVE", 20, 40, "Low risk"),
+                DecisionTier("SOFT_REVIEW", 40, 60, "Medium risk"),
+                DecisionTier("HARD_REVIEW", 60, 80, "Higher risk"),
+                DecisionTier("FLAG", 80, 95, "High risk"),
+                DecisionTier("AUTO_REJECT", 95, 101, "Very high risk"),
+            ]
+        )
+
         result = engine.evaluate(claim, context)
     """
 
-    DEFAULT_THRESHOLDS = {
-        "approve": 30,
-        "review": 70,
-    }
-
     def __init__(
         self,
         repository: "RuleRepository",
         scoring_strategy: Optional["ScoringStrategy"] = None,
-        decision_thresholds: Optional[Dict[str, int]] = None,
+        decision_tiers: Optional[List[DecisionTier]] = None,
         condition_builder: Optional[Any] = None,
     ):
         """
@@ -47,12 +57,13 @@ class RuleEngine:
         Args:
             repository: Rule storage backend
             scoring_strategy: Strategy for calculating scores
-            decision_thresholds: Custom thresholds for decisions
+            decision_tiers: User-defined decision tiers with score ranges.
+                           If not provided, decision will be None.
             condition_builder: Builder for creating conditions from dicts
         """
         self.repository = repository
         self._scoring_strategy = scoring_strategy
-        self._thresholds = decision_thresholds or self.DEFAULT_THRESHOLDS.copy()
+        self._decision_tiers = decision_tiers
         self._condition_builder = condition_builder
         self._rules_cache: Optional[List[Rule]] = None
 
@@ -189,25 +200,25 @@ class RuleEngine:
             explanation=rule.description if triggered else "Condition not met",
         )
 
-    def _make_decision(self, score: int) -> str:
+    def _make_decision(self, score: int) -> Optional[str]:
         """
-        Make a decision based on the total score.
+        Make a decision based on the total score and configured decision tiers.
 
         Args:
             score: Total calculated score
 
         Returns:
-            Decision string: 'APPROVE', 'REVIEW', or 'FLAG'
+            Decision string if a matching tier is found, None otherwise.
+            If no decision tiers are configured, returns None.
         """
-        approve_threshold = self._thresholds.get("approve", 30)
-        review_threshold = self._thresholds.get("review", 70)
-
-        if score < approve_threshold:
-            return "APPROVE"
-        elif score < review_threshold:
-            return "REVIEW"
-        else:
-            return "FLAG"
+        if not self._decision_tiers:
+            return None
+
+        for tier in self._decision_tiers:
+            if tier.matches(score):
+                return tier.name
+
+        return None
 
     def reload_rules(self) -> None:
         """Force reload rules from repository."""

pylitmus/factory.py

@@ -4,7 +4,7 @@ Factory functions for creating RuleEngine instances with sensible defaults.
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Dict, List, Optional, Union
+from typing import TYPE_CHECKING, List, Optional, Union
 
 from .engine import RuleEngine
 from .storage import (
@@ -15,6 +15,7 @@ from .storage import (
     RuleRepository,
 )
 from .strategies import MaxStrategy, ScoringStrategy, SumStrategy, WeightedStrategy
+from .types import DecisionTier
 
 if TYPE_CHECKING:
     from .types import Rule
@@ -34,7 +35,7 @@ def create_engine(
     # Scoring
     scoring_strategy: Union[str, ScoringStrategy] = "sum",
     # Decision
-    decision_thresholds: Optional[Dict[str, int]] = None,
+    decision_tiers: Optional[List[DecisionTier]] = None,
 ) -> RuleEngine:
     """
     Create a configured RuleEngine instance.
@@ -52,13 +53,14 @@ def create_engine(
         cache_url: Redis URL (for 'redis' cache)
         cache_ttl: Cache TTL in seconds
         scoring_strategy: 'sum', 'weighted', 'max', or ScoringStrategy instance
-        decision_thresholds: Custom thresholds {'approve': 30, 'review': 70}
+        decision_tiers: User-defined decision tiers with score ranges.
+                       If not provided, decision will be None in results.
 
     Returns:
         Configured RuleEngine instance
 
     Examples:
-        # Simple in-memory engine
+        # Simple in-memory engine (no decision tiers - decision will be None)
         engine = create_engine()
 
         # In-memory with predefined rules
@@ -78,10 +80,17 @@ def create_engine(
             rules_file='./rules/fraud_rules.yaml'
         )
 
-        # With weighted scoring
+        # With user-defined decision tiers
         engine = create_engine(
             scoring_strategy='weighted',
-            decision_thresholds={'approve': 25, 'review': 60}
+            decision_tiers=[
+                DecisionTier("AUTO_APPROVE", 0, 20, "Very low risk"),
+                DecisionTier("APPROVE", 20, 40, "Low risk"),
+                DecisionTier("SOFT_REVIEW", 40, 60, "Medium risk"),
+                DecisionTier("HARD_REVIEW", 60, 80, "Higher risk"),
+                DecisionTier("FLAG", 80, 95, "High risk"),
+                DecisionTier("AUTO_REJECT", 95, 101, "Very high risk"),
+            ]
         )
     """
 
@@ -112,7 +121,7 @@ def create_engine(
     return RuleEngine(
         repository=repo,
         scoring_strategy=strategy,
-        decision_thresholds=decision_thresholds,
+        decision_tiers=decision_tiers,
     )
 
 

pylitmus/types.py

@@ -3,13 +3,14 @@ Core type definitions for the CMAP Rules Engine.
 """
 
 from dataclasses import dataclass, field
-from typing import Any, Dict, List, Optional
-from enum import Enum
 from datetime import datetime
+from enum import Enum
+from typing import Any, Dict, List, Optional
 
 
 class Operator(str, Enum):
     """Supported condition operators."""
+
     EQUALS = "equals"
     NOT_EQUALS = "not_equals"
     GREATER_THAN = "greater_than"
@@ -32,6 +33,7 @@ class Operator(str, Enum):
 
 class Severity(str, Enum):
     """Rule severity levels."""
+
     LOW = "LOW"
     MEDIUM = "MEDIUM"
     HIGH = "HIGH"
@@ -41,6 +43,7 @@ class Severity(str, Enum):
 @dataclass
 class Rule:
     """A rule definition."""
+
     code: str
     name: str
     description: str
@@ -73,6 +76,7 @@ class Rule:
 @dataclass
 class RuleResult:
     """Result of evaluating a single rule."""
+
     rule_code: str
     rule_name: str
     triggered: bool
@@ -82,11 +86,33 @@ class RuleResult:
     explanation: str
 
 
+@dataclass
+class DecisionTier:
+    """
+    A decision tier definition with score range.
+
+    Example:
+        DecisionTier(name="APPROVE", min_score=0, max_score=30)
+        DecisionTier(name="REVIEW", min_score=30, max_score=70)
+        DecisionTier(name="FLAG", min_score=70, max_score=100)
+    """
+
+    name: str
+    min_score: int
+    max_score: int
+    description: Optional[str] = None
+
+    def matches(self, score: int) -> bool:
+        """Check if score falls within this tier's range (min inclusive, max exclusive)."""
+        return self.min_score <= score < self.max_score
+
+
 @dataclass
 class AssessmentResult:
     """Complete assessment result."""
+
     total_score: int
-    decision: str
+    decision: Optional[str]
     triggered_rules: List[RuleResult] = field(default_factory=list)
     all_rules_evaluated: int = 0
     processing_time_ms: float = 0.0

{pylitmus-1.0.0.dist-info → pylitmus-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pylitmus
-Version: 1.0.0
+Version: 1.1.0
 Summary: A high-performance rules engine for Python - evaluate data against configurable rules and get clear verdicts
 Project-URL: Homepage, https://github.com/yourorg/pylitmus
 Project-URL: Documentation, https://pylitmus.readthedocs.io/

{pylitmus-1.0.0.dist-info → pylitmus-1.1.0.dist-info}/RECORD

@@ -1,8 +1,8 @@
-pylitmus/__init__.py,sha256=MivCPQfBek8sZneeSOBIoYA575Se4pUlunP9uBvS_s0,1843
-pylitmus/engine.py,sha256=j-5w4AhH3FVaUnvTnJQLGREWfV8fFjaGifTOIkDI2YE,7371
+pylitmus/__init__.py,sha256=xFp0yLha5ZAdH0UePFfg6GM-vSixD_1XfVOK8xVCcQ0,1877
+pylitmus/engine.py,sha256=MAk3dHE0d7FRpzc2u4BttXSvgD9mEOsNR_ZRhBIUIVo,8045
 pylitmus/exceptions.py,sha256=c5AcD1LXAH52NDWTVp3xHp4vXaHwQW75n6JuaJ4D0Dk,653
-pylitmus/factory.py,sha256=BrhFtm0iuMg7uFlaNb5QnFTwPGkyozeVRNnEAhDWqjw,5143
-pylitmus/types.py,sha256=bqU4dsBfzlcBnbiLjD90zQ8LW9nJZqdj9VDcZYcYvI8,2274
+pylitmus/factory.py,sha256=ZurhJZw9QJTEU5UT3x731J2cynCSHVcBtNRXAfMMpCI,5660
+pylitmus/types.py,sha256=d0BgF5K7EpGSvpeH8B5sveqqDIPKhyZ1DYrt5gTGnf0,2875
 pylitmus/conditions/__init__.py,sha256=jGfOpD4cLBk2lpbnfPyNtPFbUAs0lkMO9AJ5FO4rHgc,303
 pylitmus/conditions/base.py,sha256=OaNyyf4eCy2kUYE2xEw4b2XdTzeHlF3r0XB18CSEshg,1261
 pylitmus/conditions/builder.py,sha256=kymvWoMNH_ss1B1u7hs49InNjW8WWS8kyp5-rCdVk_c,2924
@@ -33,7 +33,7 @@ pylitmus/strategies/base.py,sha256=Fq9JgUVdbuPlwEk8pdSyiLZ-RBRm_3DnJkWAWCtGmRk,5
 pylitmus/strategies/max.py,sha256=BUjZ9P3DUrDShcvy7_0pVo3Pa9lSLJI5cX9bRELUAlU,553
 pylitmus/strategies/sum.py,sha256=kA0MHiYSpLa-lYR0nMmTGGKMMKm58jrqkuC9a5sTy0U,831
 pylitmus/strategies/weighted.py,sha256=GqTt8yqS3m2GYgX9nElhjk7p8ah6lAFrtpZiCDHTSQg,1019
-pylitmus-1.0.0.dist-info/METADATA,sha256=el-ecW2t9Lqg9vMFppw7xD5m7guNpULSW6PAKj2axP0,11220
-pylitmus-1.0.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-pylitmus-1.0.0.dist-info/licenses/LICENSE,sha256=BtvJ2KboQyfSvjSh9-nxRiVFK4VjxFWXe5x4sFpe7Xw,1066
-pylitmus-1.0.0.dist-info/RECORD,,
+pylitmus-1.1.0.dist-info/METADATA,sha256=5aU1HJQeDpvkwjWXNq7baJAPsZq1twuSwBn4A2MyxKQ,11220
+pylitmus-1.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+pylitmus-1.1.0.dist-info/licenses/LICENSE,sha256=BtvJ2KboQyfSvjSh9-nxRiVFK4VjxFWXe5x4sFpe7Xw,1066
+pylitmus-1.1.0.dist-info/RECORD,,