Struct RustLogFilterBuilder

Source

pub struct RustLogFilterBuilder { /* private fields */ }

Expand description

A builder for RustLogFilter.

It can be used to parse a set of directives from a string before building an RustLogFilter instance.

§Example

use logforth_filter_rustlog::RustLogFilterBuilder;

// Parse the filter from the default environment variable `RUST_LOG`.
let builder = RustLogFilterBuilder::from_default_env();
let filter = builder.build();

Implementations§

Source §

impl RustLogFilterBuilder

Source

pub fn from_default_env() -> Self

Initialize the filter builder from the environment using default variable name RUST_LOG.

§Examples

Initialize a filter using the default environment variables:

use logforth_filter_rustlog::RustLogFilterBuilder;

let filter = RustLogFilterBuilder::from_default_env().build();

Source

pub fn from_default_env_or<'a, V>(default: V) -> Self
where V: Into<Cow<'a, str>>,

Initialize the filter builder from the environment using default variable name RUST_LOG. If the variable is not set, the default value will be used.

§Examples

Initialize a filter using the default environment variables, or fallback to the default value:

use logforth_filter_rustlog::RustLogFilterBuilder;

let filter = RustLogFilterBuilder::from_default_env_or("info").build();

Source

pub fn from_env<'a, V>(name: V) -> RustLogFilterBuilder
where V: Into<Cow<'a, str>>,

Initialize the filter builder from the environment using specific variable name.

§Examples

Initialize a filter using the using specific variable name:

use logforth_filter_rustlog::RustLogFilterBuilder;

let filter = RustLogFilterBuilder::from_env("MY_LOG").build();

Source

pub fn from_env_or<'a, 'b, E, V>(name: E, default: V) -> Self
where E: Into<Cow<'a, str>>, V: Into<Cow<'b, str>>,

Initialize the filter builder from the environment using specific variable name. If the variable is not set, the default value will be used.

§Examples

Initialize a filter using the using specific variable name, or fallback to the default value:

use logforth_filter_rustlog::RustLogFilterBuilder;

let filter = RustLogFilterBuilder::from_env_or("MY_LOG", "info").build();

Source

pub fn from_spec<'a, V>(spec: V) -> Self
where V: Into<Cow<'a, str>>,

Initialize the filter builder from the passed RUST_LOG specification. Malformed directives will be ignored with a warning printed to stderr.

§Examples

Initialize a filter using the passed RUST_LOG specification:

use logforth_filter_rustlog::RustLogFilterBuilder;

let filter = RustLogFilterBuilder::from_spec("info,my_crate=debug").build();

Source

pub fn try_from_spec<'a, V>(spec: V) -> Result<Self, Error>
where V: Into<Cow<'a, str>>,

Initialize the filter builder from the passed RUST_LOG specification.

§Examples

Initialize a filter using the passed RUST_LOG specification:

use logforth_filter_rustlog::RustLogFilterBuilder;

let filter = RustLogFilterBuilder::try_from_spec("info,my_crate=debug")
    .unwrap()
    .build();

Source