pub struct Builder { /* private fields */ }
Expand description

A builder for constructing new EnvFilters.

Implementations§

source§

impl Builder

source

pub fn with_regex(self, regex: bool) -> Builder

Sets whether span field values can be matched with regular expressions.

If this is true, field filter directives will be interpreted as regular expressions if they are not able to be interpreted as a bool, i64, u64, or f64 literal. If this is false, those field values will be interpreted as literal std::fmt::Debug output instead.

By default, regular expressions are enabled.

Note: when EnvFilters are constructed from untrusted inputs, disabling regular expressions is strongly encouraged.

source

pub fn with_default_directive(self, default_directive: Directive) -> Builder

Sets a default [filtering directive] that will be added to the filter if the parsed string or environment variable contains no filter directives.

By default, there is no default directive.

Examples

If parse, parse_lossy, from_env, or from_env_lossy are called with an empty string or environment variable, the default directive is used instead:

use tracing_subscriber::filter::{EnvFilter, LevelFilter};

let filter = EnvFilter::builder()
    .with_default_directive(LevelFilter::INFO.into())
    .parse("")?;

assert_eq!(format!("{}", filter), "info");

Note that the lossy variants (parse_lossy and from_env_lossy) will ignore any invalid directives. If all directives in a filter string or environment variable are invalid, those methods will also use the default directive:

use tracing_subscriber::filter::{EnvFilter, LevelFilter};

let filter = EnvFilter::builder()
    .with_default_directive(LevelFilter::INFO.into())
    .parse_lossy("some_target=fake level,foo::bar=lolwut");

assert_eq!(format!("{}", filter), "info");

If the string or environment variable contains valid filtering directives, the default directive is not used:

use tracing_subscriber::filter::{EnvFilter, LevelFilter};

let filter = EnvFilter::builder()
    .with_default_directive(LevelFilter::INFO.into())
    .parse_lossy("foo=trace");

// The default directive is *not* used:
assert_eq!(format!("{}", filter), "foo=trace");

Parsing a more complex default directive from a string:

use tracing_subscriber::filter::{EnvFilter, LevelFilter};

let default = "myapp=debug".parse()
    .expect("hard-coded default directive should be valid");

let filter = EnvFilter::builder()
    .with_default_directive(default)
    .parse("")?;

assert_eq!(format!("{}", filter), "myapp=debug");
source

pub fn with_env_var(self, var: impl ToString) -> Builder

Sets the name of the environment variable used by the from_env, from_env_lossy, and try_from_env methods.

By default, this is the value of EnvFilter::DEFAULT_ENV (RUST_LOG).

source

pub fn parse_lossy<S>(&self, dirs: S) -> EnvFilter
where S: AsRef<str>,

Returns a new EnvFilter from the directives in the given string, ignoring any that are invalid.

source

pub fn parse<S>(&self, dirs: S) -> Result<EnvFilter, ParseError>
where S: AsRef<str>,

Returns a new EnvFilter from the directives in the given string, or an error if any are invalid.

source

pub fn from_env_lossy(&self) -> EnvFilter

Returns a new EnvFilter from the directives in the configured environment variable, ignoring any directives that are invalid.

source

pub fn from_env(&self) -> Result<EnvFilter, FromEnvError>

Returns a new EnvFilter from the directives in the configured environment variable. If the environment variable is unset, no directive is added.

An error is returned if the environment contains invalid directives.

source

pub fn try_from_env(&self) -> Result<EnvFilter, FromEnvError>

Returns a new EnvFilter from the directives in the configured environment variable, or an error if the environment variable is not set or contains invalid directives.

Trait Implementations§

source§

impl Clone for Builder

source§

fn clone(&self) -> Builder

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for Builder

source§

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

Formats the value using the given formatter. Read more
source§

impl Default for Builder

source§

fn default() -> Builder

Returns the “default value” for a type. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T, U> AsBindGroupShaderType<U> for T
where U: ShaderType, &'a T: for<'a> Into<U>,

source§

fn as_bind_group_shader_type(&self, _images: &RenderAssets<Image>) -> U

Return the T ShaderType for self. When used in AsBindGroup derives, it is safe to assume that all images in self exist.
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> Downcast<T> for T

source§

fn downcast(&self) -> &T

source§

impl<T> Downcast for T
where T: Any,

source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
source§

impl<T> DowncastSync for T
where T: Any + Send + Sync,

source§

fn into_any_arc(self: Arc<T>) -> Arc<dyn Any + Send + Sync>

Convert Arc<Trait> (where Trait: Downcast) to Arc<Any>. Arc<Any> can then be further downcast into Arc<ConcreteType> where ConcreteType implements Trait.
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<S> FromSample<S> for S

source§

fn from_sample_(s: S) -> S

source§

impl<T> FromWorld for T
where T: Default,

source§

fn from_world(_world: &mut World) -> T

Creates Self using data from the given World.
source§

impl<T> Instrument for T

source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> ToSample<U> for T
where U: FromSample<T>,

source§

fn to_sample_(self) -> U

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> TypeData for T
where T: 'static + Send + Sync + Clone,

source§

impl<T> Upcast<T> for T

source§

fn upcast(&self) -> Option<&T>

source§

impl<T> WithSubscriber for T

source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more
source§

impl<S, T> Duplex<S> for T
where T: FromSample<S> + ToSample<S>,

source§

impl<T> Settings for T
where T: 'static + Send + Sync,

source§

impl<T> WasmNotSend for T
where T: Send,

source§

impl<T> WasmNotSendSync for T

source§

impl<T> WasmNotSync for T
where T: Sync,