rusty-rules 0.2.1

A blazingly fast, flexible, and extensible rules engine written in Rust.
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

/// Represents possible errors that can occur during rules parsing.
#[derive(thiserror::Error, Debug)]
pub enum Error {
    /// Covers general JSON parsing issues, such as missing fields or incorrect types.
    #[error("{0}")]
    Json(String),

    /// Triggered when a fetcher specified in the JSON rule is invalid.
    #[error("error in '{name}' fetcher: {error}")]
    Fetcher { name: String, error: String },

    /// Triggered when an error in the matcher occurs when parsing it.
    #[error("error in '{fetcher}' matcher: {error}")]
    Matcher { fetcher: String, error: String },

    /// Triggered when an operator specified in the JSON rule isn’t registered in the engine.
    #[error("unknown operator '{0}'")]
    UnknownOperator(String),

    /// Triggered when an error in the operator occurs when parsing it.
    #[error("error in '{name}' operator: {error}")]
    Operator { name: String, error: String },

    #[error(transparent)]
    Regex(#[from] regex::Error),

    #[error(transparent)]
    IpAddress(#[from] std::net::AddrParseError),

    #[error(transparent)]
    IpSubnet(#[from] ipnet::AddrParseError),
}

impl Error {
    pub(crate) fn json(error: impl ToString) -> Self {
        Error::Json(error.to_string())
    }

    pub(crate) fn fetcher(name: &str, error: impl ToString) -> Self {
        Error::Fetcher {
            name: name.to_string(),
            error: error.to_string(),
        }
    }

    pub(crate) fn matcher(fetcher: &str, error: impl ToString) -> Self {
        Error::Matcher {
            fetcher: fetcher.to_string(),
            error: error.to_string(),
        }
    }

    pub(crate) fn operator(name: &str, error: impl ToString) -> Self {
        Error::Operator {
            name: name.to_string(),
            error: error.to_string(),
        }
    }
}