Crate thiserror_ext

Useful extension utilities for thiserror.

Painless construction

With derive macros of Construct, ContextInto and Macro, one can construct an error in a much more convenient way, no matter it’s from scratch or converted from other errors.

Better formatting

With extension AsReport, one can format an error in a pretty and concise way, without losing any information from the error sources.

Easier to interact with

With derive macros of Box and Arc, one can easily wrap an enum error type into a new type, reducing the size to improve performance, and automatically capturing backtraces if needed.

Structs

Report

A wrapper around an error that provides a cleaned up error trace for display and debug formatting.

Traits

AsDyn

Extension trait for Error that casts the error to a trait object.

AsReport

Extension trait for Error that provides a Report which formats the error and its sources in a cleaned-up way.

Derive Macros

Arc

Generates a new type that wraps the original error type in an Arc.

Box

Generates a new type that wraps the original error type in a [struct@Box].

Construct

Generates constructor functions for different variants of the error type.

ContextInto

Generates extension traits for converting the external error type into the the provided one, with extra context.

Macro

Generates macros for different variants of the error type to construct it or directly bail out.

ReportDebug

Generates the [Debug] implementation that delegates to the Report of an error.