Struct LevelMatcher 

pub struct LevelMatcher { /* private fields */ }

A compiled LevelRule list, ready to classify lines.

Build one with Self::compile. Rules are tried in the order they were declared and the first match wins, so an operator orders them rather than discovering which of two overlapping patterns a map happened to hold first.

Implementations

impl LevelMatcher

pub fn compile(rules: &[LevelRule]) -> Result<Self, LevelRuleError>

Compiles rules in order.

An empty slice compiles to an empty matcher, which classifies nothing. What a caller does with that is its own decision: a client reading an app that declared no rules falls back to its own reading of the line.

Errors

• LevelRuleError::TooManyRules if rules is longer than this crate’s ceiling on how many one app may declare, which the error carries as limit.
• LevelRuleError::EmptyPattern if a rule’s pattern is empty.
• LevelRuleError::BadPattern if a pattern does not compile, or compiles to a program over this crate’s 1 MiB bound.

pub fn level_of(&self, line: &str) -> Option<LineLevel>

The level the first matching rule gives line, or None when none matches.

None is an ordinary answer and never means “below the minimum”: an app’s output is arbitrary text and most of it announces no level at all.

Trait Implementations

impl Debug for LevelMatcher

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

Formats the value using the given formatter.