Struct LumberJack 

pub struct LumberJack { /* private fields */ }

Logging and tracing initialization.

Implementations

impl LumberJack

pub fn new() -> Self

Create a LumberJack::default() object.

pub fn noinit() -> Self

Do not initialize logging/tracing.

This is useful when running tests.

pub const fn set_init(self, flag: bool) -> Self

pub const fn log_level(self, level: LogLevel) -> Self

Set the log logging level.

pub fn trace_filter(self, filter: impl ToString) -> Self

Set the tracing log level.

pub fn trace_file<P>(self, fname: P) -> Self

where P: AsRef<Path>,

Set a file to which tracing log entries are written (rather than to write to console).

pub fn init(self) -> Result<(), Error>

Commit requested settings to log and tracing.

Errors

Any initialization error is translated into Error::LumberJack.

Trait Implementations

impl Default for LumberJack

fn default() -> Self

Create a default log/trace initialization.

This will set the log log level to the value of the LOG_LEVEL environment variable, or default to warm (if either not set or invalid).

The tracing trace level will use the environment variable TRACE_FILTER in a similar manner, but defaults to none.

If the environment variable TRACE_FILE is set the value will be the used as the file name to write the trace logs to.