rust-rule-engine 1.0.0-alpha

A high-performance rule engine for Rust with RETE-UL algorithm (2-24x faster), CLIPS-inspired features (Template System, Defglobal, Deffacts, Test CE, Conflict Resolution), Parallel Execution
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

use thiserror::Error;

/// Error types that can occur in the rule engine
#[derive(Error, Debug)]
pub enum RuleEngineError {
    /// Parse error during rule parsing
    #[error("Parse error: {message}")]
    ParseError {
        /// Error message
        message: String,
    },

    /// Error during rule evaluation
    #[error("Evaluation error: {message}")]
    EvaluationError {
        /// Error message
        message: String,
    },

    /// Field not found in data context
    #[error("Field not found: {field}")]
    FieldNotFound {
        /// Field name that was not found
        field: String,
    },

    /// IO error for file operations
    #[error("IO error: {0}")]
    IoError(#[from] std::io::Error),

    /// Type mismatch error
    #[error("Type mismatch: expected {expected}, got {actual}")]
    TypeMismatch {
        /// Expected type
        expected: String,
        /// Actual type
        actual: String,
    },

    /// Invalid operator error
    #[error("Invalid operator: {operator}")]
    InvalidOperator {
        /// Invalid operator
        operator: String,
    },

    /// Invalid logical operator error
    #[error("Invalid logical operator: {operator}")]
    InvalidLogicalOperator {
        /// Invalid logical operator
        operator: String,
    },

    /// Regex compilation or execution error
    #[error("Regex error: {message}")]
    RegexError {
        /// Error message
        message: String,
    },

    /// Action execution error
    #[error("Action execution error: {message}")]
    ActionError {
        /// Error message
        message: String,
    },

    /// General execution error
    #[error("Execution error: {0}")]
    ExecutionError(String),

    /// Serialization/deserialization error
    #[error("Serialization error: {message}")]
    SerializationError {
        /// Error message
        message: String,
    },

    /// Plugin system error
    #[error("Plugin error: {message}")]
    PluginError {
        /// Error message
        message: String,
    },
}

/// Convenient Result type alias for rule engine operations
pub type Result<T> = std::result::Result<T, RuleEngineError>;