Struct Filter 

pub struct Filter { /* private fields */ }

Parsed obs::Filter. Statics are checked first against the callsite; dynamics are bucketed by full_name and consulted at emit time against env.labels.

Implementations

impl Filter

pub fn new() -> Filter

Construct an empty filter that allows everything >= Info.

pub fn parse(s: &str) -> Result<Filter, FilterParseError>

Parse a filter spec string (OBS_FILTER / obs.yaml’s filter).

Errors

Returns FilterParseError::Malformed when a directive is syntactically invalid, e.g. =info (missing target/level).

pub fn add_directive(&mut self, raw: &str) -> Result<(), FilterParseError>

Add one directive. Public for programmatic construction.

Errors

Returns FilterParseError::Malformed when the directive is syntactically invalid.

pub fn callsite_interest(&self, callsite: &ObsCallsite) -> Interest

Decide Interest for a static callsite (no envelope visible yet). Used at first-sight by the runtime to populate the callsite cache.

Sometimes is returned whenever a dynamic directive references the callsite — the per-emit event_allowed is then consulted once the envelope is available.

Spec 94 § 2.2: a static directive that matches the callsite vetoes inclusion regardless of the global default floor — i.e. info,my_module=off rejects every my_module::* callsite even when its default severity is at or above info.

pub fn event_allowed(&self, env: &ObsEnvelope, callsite_sev: Severity) -> bool

Per-emit decision once the envelope is built. Honours dynamic directives ([field=value]) by reading env.labels.

pub fn default_level(&self) -> Severity

Default severity floor.

pub fn statics(&self) -> impl Iterator<Item = &Directive>

Iter over static directives.

pub fn dynamics(&self) -> impl Iterator<Item = &Directive>

Iter over dynamic directives.

Trait Implementations

impl Clone for Filter

fn clone(&self) -> Filter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Filter

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

Formats the value using the given formatter.

impl Default for Filter

fn default() -> Filter

Returns the “default value” for a type.

impl FromStr for Filter

type Err = FilterParseError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Filter, <Filter as FromStr>::Err>

Parses a string s to return a value of this type.