Crate sloggers

This crate provides frequently used slog loggers and convenient functions.

Important note: this crate is optimized for performance rather than for not losing any messages! This may be surprising in some common scenarios, like logging an error message and calling std::process::exit(1). It’s recommended to drop the logger(s) before exiting. panic = "abort" may have the same surprising effect, so unwinding is preferrable if you want to avoid losing the messages. See #29 for more information.

Examples

Creates a logger via TerminalLoggerBuilder:

use slog::info;
use sloggers::Build;
use sloggers::terminal::{TerminalLoggerBuilder, Destination};
use sloggers::types::Severity;

let mut builder = TerminalLoggerBuilder::new();
builder.level(Severity::Debug);
builder.destination(Destination::Stderr);

let logger = builder.build().unwrap();
info!(logger, "Hello World!");

Creates a logger from configuration text (TOML):

use slog::info;
use sloggers::{Config, LoggerConfig};

let config: LoggerConfig = serdeconv::from_toml_str(r#"
type = "terminal"
level = "debug"
destination = "stderr"
"#).unwrap();

let logger = config.build_logger().unwrap();
info!(logger, "Hello World!");

Modules

• file
  File logger.
• null
  Null logger.
• syslog
  Logger that sends logs to local syslog daemon. Unix-like platforms only. Uses the POSIX syslog API.
• terminal
  Terminal logger.
• types
  Commonly used types.

Structs

• Error
  The error type for this crate.

Enums

• ErrorKind
  A list of error kinds.
• LoggerBuilder
  Logger builder.
• LoggerConfig
  The configuration of LoggerBuilder.

Traits

• Build
  This trait allows to build a logger instance.
• BuildWithCustomFormat
  This trait allows to build a logger instance with a custom format (i.e., Drain}.
• Config
  Configuration of a logger builder.

Functions

• set_stdlog_logger
  Sets the logger for the log records emitted via log crate.

Type Aliases

• Result
  A specialized Result type for this crate.