Struct RulesEngine 

pub struct RulesEngine { /* private fields */ }

Rules engine for transaction categorization.

Evaluates rules in priority order (highest first). First match wins. Supports loading rules from user config, merchant dictionary, or both.

Implementations

impl RulesEngine

pub const fn new() -> Self

Create an empty rules engine.

pub fn add_rule(&mut self, rule: Rule)

Add a single rule.

Rules are kept sorted by priority (descending) after each insertion.

pub fn load_from_mappings(&mut self, mappings: &[(String, String)])

Load rules from substring-based mappings (existing importers.toml format).

All patterns are lowercased. Priority is set to 0 (user rules).

pub fn load_from_regex_mappings(&mut self, mappings: &[(String, String)])

Load rules from regex-based mappings.

Patterns that fail to compile are silently skipped. Priority is set to 0 (user rules).

pub fn load_merchant_dict(&mut self)

Load the built-in merchant dictionary as low-priority rules.

pub fn categorize( &self, payee: Option<&str>, narration: &str, ) -> Option<RuleMatch>

Categorize a transaction by matching payee and narration against rules.

Returns the first matching rule’s account and metadata, or None if no rule matches.

pub const fn len(&self) -> usize

Number of loaded rules.

pub const fn is_empty(&self) -> bool

Whether the engine has no rules.

Trait Implementations

impl Debug for RulesEngine

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for RulesEngine

fn default() -> Self

Returns the “default value” for a type.