Struct LogFilter 

pub struct LogFilter { /* private fields */ }

A composable log filter supporting allow/deny rules on message content and module targets.

Deny rules always take precedence over allow rules.

Filtering logic

1. If any deny target matches → reject
2. If any deny message matches → reject
3. If allow targets is non-empty and none match → reject
4. If allow messages is non-empty and none match → reject
5. Otherwise → accept

An empty filter accepts everything.

Example

use mtlog_core::LogFilter;

let filter = LogFilter::new()
    .deny_target("^hyper").unwrap()
    .allow_message("important").unwrap();

assert!(!filter.is_match("hyper::client", "important request"));
assert!(filter.is_match("myapp::db", "important query"));
assert!(!filter.is_match("myapp::db", "routine check"));

Implementations

impl LogFilter

pub fn new() -> LogFilter

Creates an empty filter that accepts all log records.

pub fn allow_target(self, pattern: &str) -> Result<LogFilter, Error>

Allow log records whose target (module path) matches this regex. When at least one allow_target is set, only matching targets pass.

pub fn deny_target(self, pattern: &str) -> Result<LogFilter, Error>

Deny log records whose target matches this regex. Takes precedence over allow.

pub fn allow_message(self, pattern: &str) -> Result<LogFilter, Error>

Allow log records whose message content matches this regex. When at least one allow_message is set, only matching messages pass.

pub fn deny_message(self, pattern: &str) -> Result<LogFilter, Error>

Deny log records whose message content matches this regex. Takes precedence over allow.

pub fn is_match(&self, target: &str, message: &str) -> bool

Returns true if the record passes the filter.

Trait Implementations

impl Clone for LogFilter

fn clone(&self) -> LogFilter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LogFilter

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

Formats the value using the given formatter.

impl Default for LogFilter

fn default() -> LogFilter

Returns the “default value” for a type.