micro_errors

Utilities to deal with errors without taking the derive macro approach.

Exposes a struct ErrorLink_ to typically be used within the Err variant of Result. It contains a generic payload, and further ErrorLink_s whose payloads are Strings. The final link will point to Backtrace instead. The Backtrace is approximate, especially when linking from a non ErrorLink_. Also, remember to set RUST_BACKTRACE.

For the generic payload as String, utilities have been implemented to aid chaining (e.g., .map_err'ing).

Gist

Creating an ErrorLink_ from a non ErrorLink_.

use crate::ErrorLinkable;
pub fn function() -> Result<(), ErrorLink_<String>> {
    Err::<(), _>(std::io::Error::other("Underlying error."))
        .map_err(|e| e.as_link())
}

Linking an ErrorLink_ from a non ErrorLink_.

use crate::ErrorLinkable;
pub fn function() -> Result<(), ErrorLink_<String>> {
    Err::<(), _>(std::io::Error::other("Underlying error."))
        .map_err(|e| e.link("Higher level error."))
}

Linking an ErrorLink_ from an existing ErrorLink_.

pub fn function() -> Result<(), ErrorLink_<String>> {
    Err::<(), _>(ErrorLink_::new_string("Underlying error."))
        .map_err(|e| e.link("Higher level error."))
}

Output of displaying/println!ing the error being something like below.

Error no. 0: Higher level error.
Error no. 1: Underlying error.
Approximate backtrace of error no. 1:
   0: micro_errors::ErrorLink_<alloc::string::String>::new_string
             at ./src/lib.rs:270:51
   1: micro_errors::tests::test__chaining_error_link_
             at ./src/lib.rs:72:26
   2: micro_errors::tests::test__chaining_error_link_::{{closure}}
             at ./src/lib.rs:69:36
   3: core::ops::function::FnOnce::call_once
             at /rustc/051478957371ee0084a7c0913941d2a8c4757bb9/library/core/src/ops/function.rs:250:5
   4: core::ops::function::FnOnce::call_once
             at /rustc/051478957371ee0084a7c0913941d2a8c4757bb9/library/core/src/ops/function.rs:250:5
   5: test::__rust_begin_short_backtrace
             at /rustc/051478957371ee0084a7c0913941d2a8c4757bb9/library/test/src/lib.rs:625:18