Module lib::assert_result::assert_result_ok

source ·
Expand description

Assert expression.is_ok() is true.

  • If true, return ().

  • Otherwise, call panic! with a message and the values of the expressions with their debug representations.

§Examples

let a: Result<(), i8> = Result::Ok(());
assert_result_ok!(a);
//-> ()

let a: Result<(), i8> = Result::Err(1);
// Panic with error message
let result = panic::catch_unwind(|| {
assert_result_ok!(a);
//-> panic!
});
assert!(result.is_err());
let actual = result.unwrap_err().downcast::<String>().unwrap().to_string();
let expect = concat!(
    "assertion failed: `assert_result_ok!(expr)`\n",
    "   expr label: `a`,\n",
    "   expr debug: `Err(1)`,\n",
    " expr.is_ok(): `false`",
);
assert_eq!(actual, expect);

// Panic with error message
let result = panic::catch_unwind(|| {
assert_result_ok!(a, "message");
//-> panic!
});
assert!(result.is_err());
let actual = result.unwrap_err().downcast::<String>().unwrap().to_string();
let expect = "message";
assert_eq!(actual, expect);

§Module macros