5 releases

0.2.2 Oct 21, 2024
0.2.1 Aug 20, 2024
0.2.0 Aug 24, 2023
0.1.1 Jul 6, 2022
0.1.0 Jan 28, 2021

#171 in Rust patterns

Download history 25143/week @ 2024-08-21 24257/week @ 2024-08-28 23937/week @ 2024-09-04 22668/week @ 2024-09-11 24198/week @ 2024-09-18 27355/week @ 2024-09-25 28115/week @ 2024-10-02 29436/week @ 2024-10-09 25985/week @ 2024-10-16 26177/week @ 2024-10-23 30819/week @ 2024-10-30 33509/week @ 2024-11-06 39069/week @ 2024-11-13 41846/week @ 2024-11-20 33388/week @ 2024-11-27 33660/week @ 2024-12-04

155,731 downloads per month
Used in 21 crates (4 directly)

Apache-2.0/MIT

12KB
142 lines

display-error-chain

A lightweight library for displaying errors and their sources.

A sample output:

macro_rules! impl_error {
    // ...
}

// `TopLevel` is caused by a `MidLevel`.
#[derive(Debug)]
struct TopLevel;
impl_error!(TopLevel, "top level", Some(&MidLevel));

// `MidLevel` is caused by a `LowLevel`.
#[derive(Debug)]
struct MidLevel;
impl_error!(MidLevel, "mid level", Some(&LowLevel));

// `LowLevel` is the cause itself.
#[derive(Debug)]
struct LowLevel;
impl_error!(LowLevel, "low level", None);

// Now let's see how it works:
let formatted = display_error_chain::DisplayErrorChain::new(&TopLevel).to_string();
assert_eq!(
    formatted,
    "\
top level
Caused by:
  -> mid level
  -> low level"
);

// Or with `.chain()` helper:
use display_error_chain::ErrorChainExt as _;
let formatted = TopLevel.chain().to_string();
assert_eq!(
    formatted,
    "\
top level
Caused by:
  -> mid level
  -> low level"
);

// Or even with `.into_chain()` helper to consume the error.
use display_error_chain::ErrorChainExt as _;
let formatted = TopLevel.into_chain().to_string();
assert_eq!(
    formatted,
    "\
top level
Caused by:
  -> mid level
  -> low level"
);

License: Apache-2.0/MIT

No runtime deps