Crate rancor

source ·
Expand description

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

Structs

  • An error type that preserves all detailed error messages. It is optimized to fit in a single pointer.
  • An error type that only preserves success or failure, throwing away any more detailed error messages.

Enums

  • The error type for errors that can never happen.
  • An error type that does not occupy any space, panicking on creation instead.

Traits

  • Helper methods for Contexts.
  • An error type which can be given additional context.
  • An error type which can be uniformly constructed from a StdError.