Struct EffectLogger 

pub struct EffectLogger;

Log sink for use as effectful::Service<EffectLogKey, Self>; forwards to tracing.

Extracted from the environment with bind* EffectLogger inside effectful::effect!. After extraction its methods return Effect<(), EffectLoggerError, R> and are themselves awaited with bind*.

Implementations

impl EffectLogger

pub fn with_minimum_log_level<B, E, R>( fiber_ref: FiberRef<LogLevel>, level: LogLevel, inner: Effect<B, E, R>, ) -> Effect<B, E, R>

where B: 'static, E: 'static, R: 'static,

Run inner with this fiber’s minimum log level overridden to level (effectful::FiberRef::locally).

pub fn log<R: 'static>( &self, level: LogLevel, msg: impl Into<Cow<'static, str>>, ) -> Effect<(), EffectLoggerError, R>

Emit a log line at level. Returns an effect that, when run, forwards to tracing. The environment R is ignored — the logger is self-contained after extraction.

When layer_minimum_log_level has been built on this thread, messages below the current fiber’s minimum LogLevel (from that FiberRef) are dropped without calling tracing.

msg may be a &'static str, String, or other Into<Cow<'static, str>>.

pub fn log_string<R: 'static>( &self, level: LogLevel, msg: String, ) -> Effect<(), EffectLoggerError, R>

Same as Self::log; kept for call sites that already hold a String.

pub fn trace<R: 'static>( &self, msg: impl Into<Cow<'static, str>>, ) -> Effect<(), EffectLoggerError, R>

Shorthand for Self::log at LogLevel::Trace.

pub fn debug<R: 'static>( &self, msg: impl Into<Cow<'static, str>>, ) -> Effect<(), EffectLoggerError, R>

Shorthand for Self::log at LogLevel::Debug.

pub fn info<R: 'static>( &self, msg: impl Into<Cow<'static, str>>, ) -> Effect<(), EffectLoggerError, R>

Shorthand for Self::log at LogLevel::Info.

pub fn warn<R: 'static>( &self, msg: impl Into<Cow<'static, str>>, ) -> Effect<(), EffectLoggerError, R>

Shorthand for Self::log at LogLevel::Warn.

pub fn error<R: 'static>( &self, msg: impl Into<Cow<'static, str>>, ) -> Effect<(), EffectLoggerError, R>

Shorthand for Self::log at LogLevel::Error.

pub fn fatal<R: 'static>( &self, msg: impl Into<Cow<'static, str>>, ) -> Effect<(), EffectLoggerError, R>

Shorthand for Self::log at LogLevel::Fatal.

Trait Implementations

impl Clone for EffectLogger

fn clone(&self) -> EffectLogger

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EffectLogger

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

Formats the value using the given formatter.

impl Default for EffectLogger

fn default() -> EffectLogger

Returns the “default value” for a type.

impl<'a, R> IntoBind<'a, R, EffectLogger, EffectLoggerError> for EffectLogger

where R: Get<EffectLogKey, Here, Target = EffectLogger> + 'a,

Implementing IntoBind for EffectLogger makes bind* EffectLogger valid inside any effect! whose environment R holds an EffectLogger under EffectLogKey. The zero-sized struct acts as its own “request token”: passing it to bind* copies the concrete value out of R and binds it as a local variable.

fn into_bind( self, r: &'a mut R, ) -> BoxFuture<'a, Result<EffectLogger, EffectLoggerError>>

Turns self into a boxed future given the environment r.

impl Copy for EffectLogger