#log #logging #tracing

tracing-unwrap

Extension traits for logging failed unwraps to a tracing subscriber

5 unstable releases

0.10.0 Nov 4, 2022
0.9.2 Aug 27, 2020
0.9.1 Aug 10, 2020
0.9.0 Aug 10, 2020
0.0.1 Aug 9, 2020

#227 in Debugging

Download history 1412/week @ 2023-08-07 1926/week @ 2023-08-14 2289/week @ 2023-08-21 1093/week @ 2023-08-28 1466/week @ 2023-09-04 1622/week @ 2023-09-11 1395/week @ 2023-09-18 1184/week @ 2023-09-25 1178/week @ 2023-10-02 1440/week @ 2023-10-09 1069/week @ 2023-10-16 1102/week @ 2023-10-23 1638/week @ 2023-10-30 1410/week @ 2023-11-06 1241/week @ 2023-11-13 1257/week @ 2023-11-20

5,670 downloads per month
Used in 5 crates (4 directly)

Apache-2.0/MIT

19KB
157 lines

tracing-unwrap

This crate provides .unwrap_or_log() and .expect_or_log() methods on Result and Option types that log failed unwraps to a tracing::Subscriber. This is useful when, for example, you are logging to syslog or a database, and you want your unwrap failures to show up there instead of being printed to stderr.

Its API aims to mirror Rust's std — see all the supported methods below. Failed unwraps are logged at a level of ERROR.

crates.io Documentation License

Usage

Add the following to your Cargo.toml:

tracing-unwrap = "0.10"

Next, bring the ResultExt and/or OptionExt traits into scope, and make use of the new logging methods.

use tracing_unwrap::ResultExt;

tracing_subscriber::fmt().init();
let not_great: Result<(), _> = Result::Err("not terrible");

// Logs the failed unwrap and panics
not_great.unwrap_or_log();

Methods

std method tracing-unwrap form trait
Result::unwrap() Result::unwrap_or_log() ResultExt
Result::expect(msg) Result::expect_or_log(msg) ResultExt
Result::unwrap_err() Result::unwrap_err_or_log() ResultExt
Result::expect_err(msg) Result::expect_err_or_log(msg) ResultExt
Option::unwrap() Option::unwrap_or_log() OptionExt
Option::expect(msg) Option::expect_or_log(msg) OptionExt
Option::unwrap_none() Option::unwrap_none_or_log() OptionExt
Option::expect_none(msg) Option::expect_none_or_log(msg) OptionExt

*†: no longer in std, see rust-lang/rust#62633*

Features

  • panic-quiet: causes failed unwraps to panic with an empty message.
    This feature is enabled by default — if you'd like the unwrap error message to also show in the panic message, disable default features in your Cargo.toml as follows:
    tracing-unwrap = { version = "0.10", default-features = false }

  • log-location: calls std::panic::Location::caller() to determine the location of a failed unwrap.

Dependencies

~425KB