Struct simple_logger::SimpleLogger

pub struct SimpleLogger { /* fields omitted */ }

Implementations

impl SimpleLogger

#[must_use = "You must call init() to begin logging"]pub fn new() -> SimpleLogger

Initializes the global logger with a SimpleLogger instance with default log level set to Level::Trace.

You may use the various builder-style methods on this type to configure the logger, and you must call init in order to start logging messages.

use simple_logger::SimpleLogger;
SimpleLogger::new().init().unwrap();
log::warn!("This is an example message.");

#[must_use = "You must call init() to begin logging"]pub fn from_env() -> SimpleLogger

A macro for simulating env_logger behavior, which enables the user to choose log level by setting a RUST_LOG environment variable. The RUST_LOG is not set or its value is not recognized as one of the log levels, this function with use the Error level by default.

You may use the various builder-style methods on this type to configure the logger, and you must call init in order to start logging messages.

use simple_logger::SimpleLogger;
SimpleLogger::from_env().init().unwrap();
log::warn!("This is an example message.");

#[must_use = "You must call init() to begin logging"]pub fn with_level(self, level: LevelFilter) -> SimpleLogger

Set the ‘default’ log level.

You can override the default level for specific modules and their sub-modules using with_module_level

#[must_use = "You must call init() to begin logging"]pub fn with_module_level(self, target: &str, level: LevelFilter) -> SimpleLogger

Override the log level for some specific modules.

This sets the log level of a specific module and all its sub-modules. When both the level for a parent module as well as a child module are set, the more specific value is taken. If the log level for the same module is specified twice, the resulting log level is implementation defined.

Examples

Silence an overly verbose crate:

use simple_logger::SimpleLogger;
use log::LevelFilter;

SimpleLogger::new().with_module_level("chatty_dependency", LevelFilter::Warn).init().unwrap();

Disable logging for all dependencies:

use simple_logger::SimpleLogger;
use log::LevelFilter;

SimpleLogger::new()
    .with_level(LevelFilter::Off)
    .with_module_level("my_crate", LevelFilter::Info)
    .init()
    .unwrap();

#[must_use = "You must call init() to begin logging"]pub fn with_target_levels(
    self,
    target_levels: HashMap<String, LevelFilter>
) -> SimpleLogger

👎 Deprecated since 1.11.0:

This is a leftover from before there was the builder pattern. Use with_module_level instead.

Override the log level for specific targets.

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

‘Init’ the actual logger, instantiate it and configure it, this method MUST be called in order for the logger to be effective.

Trait Implementations

impl Default for SimpleLogger

fn default() -> Self

See this

impl Log for SimpleLogger

fn enabled(&self, metadata: &Metadata<'_>) -> bool

Determines if a log message with the specified metadata would be logged.

fn log(&self, record: &Record<'_>)

Logs the Record.

fn flush(&self)

Flushes any buffered records.