Struct simplelog::CombinedLogger

pub struct CombinedLogger { /* private fields */ }

The CombinedLogger struct. Provides a Logger implementation that proxies multiple Loggers as one.

The purpose is to allow multiple Loggers to be set globally

Implementations

impl CombinedLogger

pub fn init(logger: Vec<Box<dyn SharedLogger>>) -> Result<(), SetLoggerError>

init function. Globally initializes the CombinedLogger as the one and only used log facility.

Takes all used Loggers as a Vector argument. None of those Loggers should already be set globally.

All loggers need to implement log::Log and logger::SharedLogger and need to provide a way to be initialized without calling set_logger. All loggers of this library provide a `new(..)`` method for that purpose. Fails if another logger is already set globally.

Examples

let _ = CombinedLogger::init(
            vec![
                TermLogger::new(LevelFilter::Info, Config::default(), TerminalMode::Mixed, ColorChoice::Auto),
                WriteLogger::new(LevelFilter::Info, Config::default(), File::create("my_rust_bin.log").unwrap())
            ]
        );

Examples found in repository

examples/usage.rs (lines 8-23)

fn main() {
    CombinedLogger::init(vec![
        #[cfg(feature = "termcolor")]
        TermLogger::new(
            LevelFilter::Warn,
            Config::default(),
            TerminalMode::Mixed,
            ColorChoice::Auto,
        ),
        #[cfg(not(feature = "termcolor"))]
        SimpleLogger::new(LevelFilter::Warn, Config::default()),
        WriteLogger::new(
            LevelFilter::Info,
            Config::default(),
            File::create("my_rust_binary.log").unwrap(),
        ),
    ])
    .unwrap();

    error!("Bright red error");
    info!("This only appears in the log file");
    debug!("This level is currently not enabled for any logger");
}

pub fn new(logger: Vec<Box<dyn SharedLogger>>) -> Box<CombinedLogger>

allows to create a new logger, that can be independently used, no matter whats globally set.

no macros are provided for this case and you probably dont want to use this function, but init(), if you dont want to build a CombinedLogger.

Takes all used loggers as a Vector argument. The log level is automatically determined by the lowest log level used by the given loggers.

All loggers need to implement log::Log.

Examples

let combined_logger = CombinedLogger::new(
            vec![
                TermLogger::new(LevelFilter::Debug, Config::default(), TerminalMode::Mixed, ColorChoice::Auto),
                WriteLogger::new(LevelFilter::Info, Config::default(), File::create("my_rust_bin.log").unwrap())
            ]
        );

Trait Implementations

impl Log for CombinedLogger

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.

impl SharedLogger for CombinedLogger

fn level(&self) -> LevelFilter

Returns the set Level for this Logger

fn config(&self) -> Option<&Config>

Inspect the config of a running Logger

fn as_log(self: Box<Self>) -> Box<dyn Log>

Returns the logger as a Log trait object