Struct env_logger::LogBuilder

pub struct LogBuilder { /* fields omitted */ }

LogBuilder acts as builder for initializing the Logger. It can be used to customize the log format, change the enviromental variable used to provide the logging directives and also set the default log level filter.

Example

#[macro_use]
extern crate log;
extern crate env_logger;

use std::env;
use log::{LogRecord, LogLevelFilter};
use env_logger::LogBuilder;

fn main() {
    let format = |record: &LogRecord| {
        format!("{} - {}", record.level(), record.args())
    };

    let mut builder = LogBuilder::new();
    builder.format(format).filter(None, LogLevelFilter::Info);

    if env::var("RUST_LOG").is_ok() {
       builder.parse(&env::var("RUST_LOG").unwrap());
    }

    builder.init().unwrap();

    error!("error message");
    info!("info message");
}

Methods

impl LogBuilder

fn new() -> LogBuilder

Initializes the log builder with defaults

fn filter(&mut self, module: Option<&str>, level: LogLevelFilter) -> &mut Self

Adds filters to the logger

The given module (if any) will log at most the specified level provided. If no module is provided then the filter will apply to all log messages.

fn format<F: 'static>(&mut self, format: F) -> &mut Self where F: Fn(&LogRecord) -> String + Sync + Send

Sets the format function for formatting the log output.

This function is called on each record logged to produce a string which is actually printed out.

fn target(&mut self, target: LogTarget) -> &mut Self

Sets the target for the log output.

Env logger can log to either stdout or stderr. The default is stderr.

fn parse(&mut self, filters: &str) -> &mut Self

Parses the directives string in the same form as the RUST_LOG environment variable.

See the module documentation for more details.

fn init(&mut self) -> Result<(), SetLoggerError>

Initializes the global logger with an env logger.

This should be called early in the execution of a Rust program, and the global logger may only be initialized once. Future initialization attempts will return an error.

fn build(&mut self) -> Logger

Build an env logger.