display-error-chain

A lightweight library for displaying errors and their sources.

A sample output:

```rust macrorules! implerror { // ... }

// 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 = displayerrorchain::DisplayErrorChain::new(&TopLevel).tostring(); asserteq!( formatted, "\ top level Caused by: -> mid level -> low level" );

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

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

License: Apache-2.0/MIT