Struct KnowledgeBase 

pub struct KnowledgeBase { /* private fields */ }

A set of rules, kept in salience order and compiled for execution.

A RuleEngine holds one; rules are usually added through the engine’s add_rules_from_* methods.

Implementations

impl KnowledgeBase

pub fn new() -> Self

An empty knowledge base.

pub fn add_rule(&mut self, rule: Rule) -> Result<(), String>

Adds a rule. Fails if a rule with the same name exists.

pub fn add_rules_from_str(&mut self, grl: &str) -> Result<usize, String>

Parses GRL text and adds all of its rules. Returns how many were added. Nothing is added if any rule fails to parse or clashes with an existing name.

pub fn add_rules_from_file( &mut self, path: impl AsRef<Path>, ) -> Result<usize, String>

Loads all rules from a .grl file. Returns how many were added.

pub fn add_rules_from_dir( &mut self, dir: impl AsRef<Path>, ) -> Result<usize, String>

Loads all .grl files under dir, recursively, in path order. Returns how many rules were added.

pub fn get_rule(&self, name: &str) -> Option<&Rule>

The rule with the given name.

pub fn get_rules(&self) -> &[Rule]

All rules, in the order they were added.

pub fn get_rules_sorted_by_salience(&self) -> Vec<&Rule>

All rules, highest salience first; rules with equal salience in the order they were added.

pub fn rules_by_salience(&self) -> impl Iterator<Item = &Rule> + '_

Iterates rules highest salience first; rules with equal salience come in the order they were added.

pub fn remove_rule(&mut self, name: &str) -> Option<Rule>

Removes and returns the rule with the given name.

pub fn clear(&mut self)

Removes all rules.

pub fn len(&self) -> usize

The number of rules.

pub fn is_empty(&self) -> bool

Whether there are no rules.

Trait Implementations

impl Debug for KnowledgeBase

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

Formats the value using the given formatter.

impl Default for KnowledgeBase

fn default() -> Self

Returns the “default value” for a type.