Crate rancor

rancor

rancor provides scalable and efficient error handling without using type composition. This makes it best-suited for situations where:

• Programmatic error introspection is not useful
• Functions may error, but succeed most of the time
• Errors should provide as much useful detail as possible when emitted
• Use cases include both no_std and targets with support for std

Features

• alloc: Provides the BoxedError type. Enabled by default.

Macros

fail

Returns the given error from this function.

Structs

BoxedErroralloc

An error type that preserves all detailed error messages. It is optimized to fit in a single pointer.

Error

A good general-purpose error type.

Failure

An error type that only preserves success or failure, throwing away any more detailed error messages.

Strategy

Equips a type with a Fallible implementation that chooses E as its error type.

Enums

Infallible

A re-export of core::convert::Infallible. The error type for errors that can never happen.

Panic

An error type that does not occupy any space, panicking on creation instead.

Traits

Fallible

A type with fallible operations that return its associated error type.

Never

A type that can never be produced.

OptionExt

Helper methods for Options.

ResultExt

Helper methods for Results.

Source

An error type which can be uniformly constructed from an Error and additional trace information.

Trace

An error type which can add additional “trace” information to itself.

Functions

unreachable_checked

Consumes a Never type, returning a primitive !.