assert_ok 1.0.2

A macro that asserts a Result is Ok
Documentation 
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

assert_ok
============

[![crates.io](https://img.shields.io/crates/v/assert_ok.svg)](https://crates.io/crates/assert_ok)
[![docs.rs](https://docs.rs/assert_ok/badge.svg)](https://docs.rs/assert_ok)

This crate contains a macro `assert_ok` which takes an expression and
if the expression evaluates to an `Err`, panics with a useful
message. If in contrast the expression evaluates to `Ok(v)` then it
returns the value `v`.

This is commonly useful in tests. Instead of

```
let z = foo(arg1, arg2).unwrap();
```

or

```
let z = foo(arg1, arg2).expect("foo failed");
```

use

```
let z = assert_ok!(foo(arg1, arg2));
```

It's easier to understand (IMO) and more importantly provides a much
more useful error message in the case that it fails.

There is a similar macro in Tokio, however for libraries or applications
that don't use Tokio, pulling it in for a single macro doesn't make sense.