<p align="center">
<a href="https://github.com/slog-rs/slog">
<img src="https://cdn.rawgit.com/slog-rs/misc/master/media/slog.svg" alt="slog-rs logo">
</a>
<br>
<a href="https://travis-ci.org/slog-rs/envlogger">
<img src="https://img.shields.io/travis/slog-rs/envlogger/master.svg?style=flat-square" alt="Travis CI Build Status">
</a>
<a href="https://crates.io/crates/slog-envlogger">
<img src="http://meritbadge.herokuapp.com/slog-envlogger?style=flat-square" alt="crates.io">
</a>
<a href="https://gitter.im/slog-rs/slog">
<img src="https://img.shields.io/gitter/room/slog-rs/slog.svg" alt="slog-rs Gitter Chat">
</a>
<br>
<strong><a href="https://docs.rs/slog-envlogger/">Documentation</a></strong>
</p>
# `slog-envlogger` - Port of `env_logger` as a [`slog-rs`][slog-rs] drain
`env_logger` is a de facto standard Rust logger implementation, which allows
controlling logging to `stderr` via the `RUST_LOG` environment variable.
This is a fork of `env_logger` that makes it work as a `slog-rs` drain.
Notable changes:
* Support for `slog-stdlog` to provide support for legacy `info!(...)` like
statements.
* `envlogger` does not do any formatting anymore: `slog-envlogger` can be composed
with any other `slog-rs` drains, so there's no point for it to provide it's
own formatting. You can now output to a file, use JSON, have color output
or any other future that `slog` ecosystem provides, controlling it via
`RUST_LOG` environment var.
### Status & news
**Warning**: Documentation has been been left mostly untouched, which means some
places of it might be confusing.
### How to use
See `examples` directory.
The simplest way to convert existing project to use `slog-rs`+`slog-envlogger`
is shown in
[`simple` example](examples/simple.rs)
For more proper (and powerful) version see
[`proper` example](examples/proper.rs)
Using `slog-stdlog` scopes you can make parts of the code log additional information (see [`scopes` example][scopes]):
[scopes]: examples/scopes.rs
[slog-rs]: //github.com/slog-rs/slog