Crate cloneable_errors 

the cloneable_errors crate

this is basically the core functionality of anyhow, but written from scratch, in safe rust.

this library was previously an internal error_handling crate in DeArrow Browser and was licensed together with the entire project under AGPL. it was spun off into it’s own public crate and is now licensed under MIT.

why?

anyhow errors are not cloneable - caching them is annoying, especially if you want to add more context later on

this crate aims to be a simpler, hopefully less annoying alternative if you do the things I do

• errors use Arc<> internally
• there’s a serializable variant that drops a lot of data, but makes it easy to send error info between workers or over the wire

deps

• no required dependencies
• serde optionally required for serializing the serializable error variant (enable the serde feature)
• anyhow optionally required for turning anyhow errors into serializable errors (enable the anyhow feature)

optional features

• serde: derives (de)serialization traits for the SerializableError struct
• bincode: derives Encode and Decode traits for the SerializableError struct
• anyhow: adds compatibility functions and traits for anyhow error stacks (using those will flatten the errors stacks into SerializableErrors)
• extensions: enables ErrorContext objects to hold arbitrary “extension” attributes (side effect: increases the size of that struct)

Macros

anyhow

Create a new ErrorContext stack

bail

Create a new ErrorContext stack using anyhow! and immediately return it as Result::Err

Structs

ErrorContext

An annotated error stack

ErrorIterator

ErrorIterator - iterates over the chain of Error::source

SerializableError

An error stack with all messages flattened into strings, trivial to (de)serialize

Enums

SharedString

A helper enum for easily cloneable strings

Traits

AnyhowErrContextanyhow

A helper trait for converting an anyhow error stack into an ErrorContext stack

AnyhowResContextanyhow

A helper trait for converting anyhow results into ErrorContext results

ErrContext

A helper trait for annotating any Error with an ErrorContext

Extensionextensions

This trait should be implemented by any structs that are intended to be used as error extensions.

IntoErrorIterator

ResContext

A helper trait for annotating result errors and empty options

ResExtensionsextensions

A helper trait for extending error variants of Result<T, ErrorContext>