Module lib::assert_fn_ok

Assert for comparing functions that return Result::Ok.

These macros help compare functions that return results that are ok, such as ::std::Result::Ok or similar.

The macros use these capabilities:

• implements .is_ok() -> boolean

• implements .unwrap_ok() -> comparable

Compare a function Ok() with another function Ok():

• assert_fn_ok_eq2!(a_function, b_function) ≈ a_function().unwrap_err() = b_function().unwrap_err()

• assert_fn_ok_ne2!(a_function, b_function) ≈ a_function().unwrap_err() ≠ b_function().unwrap_err()

• assert_fn_ok_ge2!(a_function, b_function) ≈ a_function().unwrap_err() ≥ b_function().unwrap_err()

• assert_fn_ok_gt2!(a_function, b_function) ≈ a_function().unwrap_err() > b_function().unwrap_err()

• assert_fn_ok_le2!(a_function, b_function) ≈ a_function().unwrap_err() ≤ b_function().unwrap_err()

• assert_fn_ok_lt2!(a_function, b_function) ≈ a_function().unwrap_err() < b_function().unwrap_err()

Compare a function Ok() with an expression:

• assert_fn_ok_eq2!(function, expr) ≈ function().unwrap_err() = expr

• assert_fn_ok_ne2!(function, expr) ≈ function().unwrap_err() ≠ expr

• assert_fn_ok_ge2!(function, expr) ≈ function().unwrap_err() ≥ expr

• assert_fn_ok_gt2!(function, expr) ≈ function().unwrap_err() > expr

• assert_fn_ok_le2!(function, expr) ≈ function().unwrap_err() ≤ expr

• assert_fn_ok_lt2!(function, expr) ≈ function().unwrap_err() < expr

Example

use assertables::*;
fn f(i: i8) -> Result<String, String> {
    match i {
        0..=9 => Ok(format!("{}", i)),
        _ => Err(format!("{:?} is out of range", i)),
    }
}

let a: i8 = 1;
let b: i8 = 1;
assert_fn_ok_eq2!(f, a, f, b);

Modules

• assert_fn_ok_eq
  Assert a function Ok(…) is equal to an expression.
• assert_fn_ok_eq2
  Assert a function Ok(…) is equal to another.
• assert_fn_ok_ge
  Assert a function Ok(…) is greater than or equal to an expression.
• assert_fn_ok_ge2
  Assert a function Ok(…) is greater than or equal to another.
• assert_fn_ok_gt
  Assert a function Ok(…) is greater than an expression.
• assert_fn_ok_gt2
  Assert a function Ok(…) is greater than another.
• assert_fn_ok_le
  Assert a function Ok(…) is less than or equal to an expression.
• assert_fn_ok_le2
  Assert a function Ok(…) is less than or equal to another.
• assert_fn_ok_lt
  Assert a function Ok(…) is less than an expression.
• assert_fn_ok_lt2
  Assert a function Ok(…) is less than another.
• assert_fn_ok_ne
  Assert a function Ok(…) is not equal to an expression.
• assert_fn_ok_ne2
  Assert a function Ok(…) is not equal to another.