Crate sensible_env_logger

  

A pretty, sensible logger for Rust.

Usage

Even though it has env in the name, the sensible-env-logger requires zero configuration and setup to use:

use log::*;

fn main() {
    sensible_env_logger::init();

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

Defaults

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

Examples

You can check out sample usage of this crate in the examples/ folder in the project repo on GitHub.

Readme Docs

You can find the crate’s readme documentation on the [crates.io] page, or alternatively in the [README.md] file on the GitHub project repo.

[crates.io]: https://crates.io/crates/sensible-env-logger) [README.md]: https://github.com/rnag/sensible-env-logger)

Enable logging

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

The sensible_env_logger crate re-exports these crates, through the pretty and env namespaces respectively.

Re-exports

pub use pretty_env_logger as pretty;

pub use pretty_env_logger::env_logger as env;

Functions

formatted_short_timed_builder

Returns a formatted builder which adds local time to log messages.

init

Initializes the global logger with a pretty, sensible env logger.

init_timed

Initializes the global logger with a timed pretty, sensible env logger.

init_timed_short

Initializes the global logger with an “abbreviated” timed pretty, sensible env logger.

try_init

Initializes the global logger with a pretty, sensible env logger.

try_init_custom_env_and_builder

Initialized the global logger with a pretty, sensible env logger, with custom variable names and a custom builder function.

try_init_timed

Initializes the global logger with a timed pretty, sensible env logger.

try_init_timed_short

Initializes the global logger with an “abbreviated” timed pretty, sensible env logger.