Crate lovely_env_logger

Expand description

A logger configured via environment variables which writes to standard error with nice colored output for log levels.

Example

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

fn main() {
    lovely_env_logger::init_default();

    trace!("a trace example");
    debug!("deboogging");
    info!("such information");
    warn!("o_O");
    error!("boom");
}

Run the program with the environment variable RUST_LOG=trace.

Defaults

The defaults can be setup by calling init_default() or try_init_default() at the start of the program.

Enable logging

This crate uses env_logger internally, so the same ways of enabling logs through an environment variable are supported.

Configuration through environment variables

Some options can be set through environment variables that have priority over configuration set through the Config structure.

The following options are set through environment variables named by adding a suffix added to RUST_LOG or the environment variable used to filter the traces.

`RUST_LOG_SHORT_LEVELS`

Display levels on 3 characters to 1. Display them as 5 characters otherwise.

`RUST_LOG_WITH_FILE_NAME`

Display the file calling the log macro when set to 1. Disable it otherwise.

`RUST_LOG_WITH_LINE_NUMBER`

Display the line number calling the log macro when set to 1. Disable it otherwise.

`RUST_LOG_WITH_PADDING`

Display the log lines with padding after module name, when set to 1. Disable it otherwise.

`RUST_LOG_WITH_SYSTEM_TIMESTAMPS`

Enable timestamps when set to 1. Disable it otherwise. Requires to be compiled with the humantime feature.

`RUST_LOG_WITH_RELATIVE_TIMESTAMPS`

When set to 1, display timestamps using the difference compared to the previous log, or the date of log if the difference is too large. Requires to be compiled with the reltime feature.

Structs

Config

Configuration for the lovely env logger

Functions

formatted_builder

Returns a env_logger::Builder for further customization.

init

Initializes the global logger with a lovely env logger.

init_custom_env

Initialized the global logger with a lovely env logger, with a custom variable name.

init_default

Initializes the global logger with a lovely env logger, with default settings.

try_init

Initializes the global logger with a lovely env logger.

try_init_custom_env

Initialized the global logger with a lovely env logger, with a custom variable name.

try_init_default

Initializes the global logger with a lovely env logger, with default settings.