1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73
//! Assert macros for comparing functions that return errors.
//!
//! These macros help compare functions that return results that are errors,
//! such as `std::Result::Err` or similar.
//!
//! The macros use these capabilities:
//!
//! * implements `.is_err() -> boolean`
//!
//! * implements `.unwrap_err() -> comparable`
//!
//! Compare a function Err() with another function Err():
//!
//! * [`assert_fn_err_eq!(function1, function2)`](macro@crate::assert_fn_err_eq) ≈ function1().unwrap_err() = function2().unwrap_err()
//!
//! * [`assert_fn_err_ne!(function1, function2)`](macro@crate::assert_fn_err_ne) ≈ function1().unwrap_err() ≠ function2().unwrap_err()
//!
//! * [`assert_fn_err_ge!(function1, function2)`](macro@crate::assert_fn_err_ge) ≈ function1().unwrap_err() ≥ function2().unwrap_err()
//!
//! * [`assert_fn_err_gt!(function1, function2)`](macro@crate::assert_fn_err_gt) ≈ function1().unwrap_err() > function2().unwrap_err()
//!
//! * [`assert_fn_err_le!(function1, function2)`](macro@crate::assert_fn_err_le) ≈ function1().unwrap_err() ≤ function2().unwrap_err()
//!
//! * [`assert_fn_err_lt!(function1, function2)`](macro@crate::assert_fn_err_lt) ≈ function1().unwrap_err() < function2().unwrap_err()
//!
//! Compare a function Err() with an expression:
//!
//! * [`assert_fn_err_eq!(function, expr)`](macro@crate::assert_fn_err_eq) ≈ function().unwrap_err() = expr
//!
//! * [`assert_fn_err_ne!(function, expr)`](macro@crate::assert_fn_err_ne) ≈ function().unwrap_err() ≠ expr
//!
//! * [`assert_fn_err_ge!(function, expr)`](macro@crate::assert_fn_err_ge) ≈ function().unwrap_err() ≥ expr
//!
//! * [`assert_fn_err_gt!(function, expr)`](macro@crate::assert_fn_err_gt) ≈ function().unwrap_err() > expr
//!
//! * [`assert_fn_err_le!(function, expr)`](macro@crate::assert_fn_err_le) ≈ function().unwrap_err() ≤ expr
//!
//! * [`assert_fn_err_lt!(function, expr)`](macro@crate::assert_fn_err_lt) ≈ function().unwrap_err() < expr
//!
//!
//! # Example
//!
//! ```rust
//! use assertables::*;
//! fn f(i: i8) -> Result<String, String> {
//! match i {
//! 0..=9 => Ok(format!("{}", i)),
//! _ => Err(format!("{:?} is out of range", i)),
//! }
//! }
//!
//! # fn main() {
//! let a: i8 = 10;
//! let b: i8 = 10;
//! assert_fn_err_eq!(f, a, f, b);
//! # }
//! ```
// Comparisons
pub mod assert_fn_err_eq;
pub mod assert_fn_err_ne;
pub mod assert_fn_err_lt;
pub mod assert_fn_err_le;
pub mod assert_fn_err_gt;
pub mod assert_fn_err_ge;
// Compare with expression
pub mod assert_fn_err_eq_expr;
pub mod assert_fn_err_ne_expr;
pub mod assert_fn_err_lt_expr;
pub mod assert_fn_err_le_expr;
pub mod assert_fn_err_gt_expr;
pub mod assert_fn_err_ge_expr;