orfail

An error handling library for portable unrecoverable errors.

This crate provides,

• Failure struct that represents an unrecoverable error with an error code, message and user-level backtrace
  • Error code and message are optional
  • Constituted with simple types (u32, String, and Vec of those)
  • Portable across process and language boundaries
  • Optional serde support ("serde" feature)
  • Doesn't implement std::error::Error trait
• OrFail trait
  • Backtrace location is appended to Failure each time when calling OrFail::or_fail()
  • bool, Option<_> and Result<_, _> implement OrFail

Examples

```rust use orfail::{OrFail, Result};

fn checknonzero(n: isize) -> Result<()> { (n != 0).or_fail()?; Ok(()) }

fn safediv(x: isize, y: isize) -> Result { checknonzero(y).orfail()?; Ok(x / y) }

// OK asserteq!(safediv(4, 2), Ok(2));

// NG asserteq!(safediv(4, 0).err().map(|e| e.tostring()), Some( r#"failed due to "expected true but got false" at src/lib.rs:7 at src/lib.rs:12 "#.toowned())); ```