Struct LogLazy

Source

pub struct LogLazy { /* private fields */ }

Expand description

Logger instance with a mutable bitmask and lazy message evaluation.

Implementations§

Source §

impl LogLazy

Source

pub fn new() -> Self

Creates a logger with the default info level.

Source

pub fn with_options(options: LogLazyOptions) -> Self

Creates a logger from the extensible options API.

Source

pub fn with_level<'a, L>(level: L) -> Self
where L: Into<LevelSpec<'a>>,

Creates a logger with a custom level.

Examples found in repository ?

examples/basic_usage.rs (line 4)

3fn main() {
4    let log = LogLazy::with_level(levels::PRODUCTION);
5
6    log.error(|| "database connection failed");
7
8    debug_lazy!(log, "expensive debug payload: {}", build_debug_payload());
9    error_lazy!(log, "request failed for user {}", 42);
10}

Source

pub fn with_level_and_presets<'a, L, I, S>(level: L, presets: I) -> Self
where L: Into<LevelSpec<'a>>, I: IntoIterator<Item = (S, LevelMask)>, S: Into<String>,

Creates a logger with a custom level and custom presets.

Source

pub fn with_sink<'a, L, F>(level: L, sink: F) -> Self
where L: Into<LevelSpec<'a>>, F: Fn(Level, String) + Send + Sync + 'static,

Creates a logger with a custom sink.

Source

pub fn add_preset(&mut self, name: impl Into<String>, mask: LevelMask)

Adds or replaces a named preset.

Source

pub const fn level(&self) -> LevelMask

Returns the active level bitmask.

Source

pub fn set_level<'a, L>(&mut self, level: L)
where L: Into<LevelSpec<'a>>,

Sets the active level bitmask.

Source

pub fn level_or_default<'a, L>(&self, level: L, default: LevelMask) -> LevelMask
where L: Into<LevelSpec<'a>>,

Resolves a string or numeric level to a mask, falling back to default.

Source

pub fn should_log<'a, L>(&self, level: L) -> bool
where L: Into<LevelSpec<'a>>,

Checks whether a level is currently enabled.

Source

pub fn enable_level<'a, L>(&mut self, level: L)
where L: Into<LevelSpec<'a>>,

Enables one level bit or mask.

Source

pub fn disable_level<'a, L>(&mut self, level: L)
where L: Into<LevelSpec<'a>>,

Disables one level bit or mask.

Source

pub fn get_enabled_levels(&self) -> Vec<&'static str>

Returns enabled standard level names in stable order.

Source

pub fn log<F, M>(&self, message: F)
where F: FnOnce() -> M, M: Display,

Logs at the default info level.

Source

pub fn emit<'a, L, F, M>(&self, level: L, message: F)
where L: Into<LevelSpec<'a>>, F: FnOnce() -> M, M: Display,

Logs at an explicit level.

Source

pub fn emit_args<'a, L, I>(&self, level: L, args: I)
where L: Into<LevelSpec<'a>>, I: IntoIterator<Item = LogArg>,

Logs explicit lazy arguments at an explicit level.

Source

pub fn fatal<F, M>(&self, message: F)
where F: FnOnce() -> M, M: Display,

Source

pub fn error<F, M>(&self, message: F)
where F: FnOnce() -> M, M: Display,

Examples found in repository ?

examples/basic_usage.rs (line 6)

3fn main() {
4    let log = LogLazy::with_level(levels::PRODUCTION);
5
6    log.error(|| "database connection failed");
7
8    debug_lazy!(log, "expensive debug payload: {}", build_debug_payload());
9    error_lazy!(log, "request failed for user {}", 42);
10}