Struct RegexPatternMatcher 

pub struct RegexPatternMatcher { /* private fields */ }

Pattern matcher implementation using the regex crate.

Compile-cache contract

Each unique pattern: &str argument MUST be compiled at most once per RegexPatternMatcher instance. Pre-fix the trait methods (find_matches, is_match, captures_iter) called Regex::new on every invocation, which on the rule-engine hot path recompiles the same regex hundreds of times per scan and, with adversarial rule packs, scales to a viable denial-of-service. The internal cache is a Mutex<HashMap> so concurrent scanners observe a single compiled Arc<Regex> per pattern; contention is minimal because the cache is consulted on the (rare) cold path only.

Implementations

impl RegexPatternMatcher

pub fn new() -> Self

Create a new regex-based pattern matcher

Trait Implementations

impl Clone for RegexPatternMatcher

fn clone(&self) -> RegexPatternMatcher

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RegexPatternMatcher

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

Formats the value using the given formatter.

impl Default for RegexPatternMatcher

fn default() -> RegexPatternMatcher

Returns the “default value” for a type.

impl PatternMatcher for RegexPatternMatcher

fn find_matches(&self, pattern: &str, text: &str) -> Vec<PatternMatch>

Find all matches of a pattern in the given text

fn is_match(&self, pattern: &str, text: &str) -> bool

Check whether a pattern occurs in the given text.

fn captures_iter(&self, pattern: &str, text: &str) -> Vec<Captures>

Iterate captures (full match plus capture groups) over a pattern.

fn compile(&self, pattern: &str) -> Result<CompiledPattern, PatternError>

Compile a pattern for efficient reuse