v0.3.0

[SpriteOvO]

Highlights

• Performance is improved by 45% (see Benchmarks).

• PatternFormatter with pattern! macro allows users to configure logging format using a literal string at compile-time.

• AsyncPoolSink can be combined with any sink to process log records asynchronously (non-blocking).

New Features

• JournaldSink writes log records to systemd-journal. (linux targets only)

• WriteSink writes log records to any object that implements Write trait.

• All sinks have now implemented Builder structs, which bring the ability for users to specify optional and required parameters in an unordered, flexible manner, and check for missing required parameters at compile-time.

• New function init_env_level_from allows parsing env-level from a user-given string instead of the environment variable SPDLOG_RS_LEVEL.

• New methods LoggerBuilder::{fork_with, fork_with_name} can configure a new separate logger from an existing logger.

• More new items:

  • fn Logger::set_name
  • struct RecordOwned, fn Record::to_owned
  • struct ThreadPool

Improvements / Bug Fixes

• FullFormatter now output terminal-friendly source file full path.

• Now leap seconds will be handled and displayed correctly.

• Re-exported some items from log crate to a new module log_crate for convenience.

• Public APIs have been marked with #[must_use] attribute if appropriate.

• Now if an invalid rotation_policy is used to construct RotatingFileSink, an error will be returned instead of panic.

Breaking Changes

• fn LoggerBuilder::build now returns Result<Logger> instead of panic.

• struct RecordBuilder and fn Record::new are removed.

• WinDebugSink is now only enabled when feature native is enabled

• trait Sink added a new method set_error_handler and removed method swap_formatter.

• trait Formatter added a new method clone_box.

• All error types are moved into a new module error.

• Deprecated methods {LoggerBuilder, StyleBuilder, StdStreamSink, FileSink, RotatingFileSink, WinDebugSink, Style}::new, use Builder methods instead.

Others

• Since this release, MSRV (the minimum supported Rust version) will be guaranteed and maintained. Currently it is 1.56.

---

This discussion was created from the release v0.3.0.