pub trait SubscriberInitExt{
// Provided methods
fn set_default(self) -> DefaultGuard { ... }
fn try_init(self) -> Result<(), TryInitError> { ... }
fn init(self) { ... }
}
Expand description
Extension trait adding utility methods for subscriber initialization.
This trait provides extension methods to make configuring and setting a
default subscriber more ergonomic. It is automatically implemented for all
types that can be converted into a trace dispatcher. Since Dispatch
implements From<T>
for all T: Collector
, all Collector
implementations will implement this extension trait as well. Types which
can be converted into Collector
s, such as builders that construct a
Collector
, may implement Into<Dispatch>
, and will also receive an
implementation of this trait.
Provided Methods§
Sourcefn set_default(self) -> DefaultGuard
Available on crate feature std
only.
fn set_default(self) -> DefaultGuard
std
only.Sets self
as the default subscriber in the current scope, returning a
guard that will unset it when dropped.
If the “tracing-log” feature flag is enabled, this will also initialize
a log
compatibility subscriber. This allows the subscriber to consume
log::Record
s as though they were tracing
Event
s.
Sourcefn try_init(self) -> Result<(), TryInitError>
fn try_init(self) -> Result<(), TryInitError>
Attempts to set self
as the global default subscriber in the current
scope, returning an error if one is already set.
If the “tracing-log” feature flag is enabled, this will also attempt to
initialize a log
compatibility subscriber. This allows the subscriber to
consume log::Record
s as though they were tracing
Event
s.
This method returns an error if a global default subscriber has already
been set, or if a log
logger has already been set (when the
“tracing-log” feature is enabled).
Sourcefn init(self)
fn init(self)
Attempts to set self
as the global default subscriber in the current
scope, panicking if this fails.
If the “tracing-log” feature flag is enabled, this will also attempt to
initialize a log
compatibility subscriber. This allows the subscriber to
consume log::Record
s as though they were tracing
Event
s.
This method panics if a global default subscriber has already been set,
or if a log
logger has already been set (when the “tracing-log”
feature is enabled).
Dyn Compatibility§
This trait is not dyn compatible.
In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.