Skip to content

Combined Rule Violation Errors

combined_rule_violation_errors

Aggregate error for multiple simultaneous rule violations.

Defines CombinedRuleViolationErrors, raised when two or more
RuleViolationError instances must be reported together — for example,
when a single operation violates several business rules at once.

Extends RuntimeErrorMixin (catchable as RuntimeError) and
CombinedErrors[RuleViolationError], so it behaves like a standard
collection of rule violations while remaining compatible with generic
RuntimeError exception handlers.

CombinedRuleViolationErrors

Bases: RuntimeErrorMixin, CombinedErrors[RuleViolationError]

Aggregates multiple rule violation errors for easier handling and reporting.

Example 
from forging_blocks.foundation.errors import ErrorMessage, RuleViolatedError

err1 = RuleViolatedError(ErrorMessage("Account overdrawn"))
err2 = RuleViolatedError(ErrorMessage("Card expired"))
combined = CombinedRuleViolationErrors([err1, err2])
assert isinstance(combined, RuntimeError)
print(len(combined))  # 2
Source code in src/forging_blocks/foundation/errors/combined/combined_rule_violation_errors.py 
18
19
20
21
22
23
24
25
26
27
28
29
30
31
class CombinedRuleViolationErrors(RuntimeErrorMixin, CombinedErrors[RuleViolationError]):
    """Aggregates multiple rule violation errors for easier handling and reporting.

    Example:
        ```python
        from forging_blocks.foundation.errors import ErrorMessage, RuleViolatedError

        err1 = RuleViolatedError(ErrorMessage("Account overdrawn"))
        err2 = RuleViolatedError(ErrorMessage("Card expired"))
        combined = CombinedRuleViolationErrors([err1, err2])
        assert isinstance(combined, RuntimeError)
        print(len(combined))  # 2
        ```
    """