# matches2
[](https://crates.io/crates/matches2)
[](https://raw.githubusercontent.com/Laaas/matches2/master/LICENSE)
This is a fork of the matches crate with an extra `unwrap_match!` and `option_match!` macro,
and also better error messages for `assert_matches`.
[Documentation](https://docs.rs/matches2)
## `unwrap_match!` macro
The `unwrap_match!` macro is a general unwrap, used as such:
```rust
let output = unwrap_match!(input, AnEnum::Variant(a) | AnEnum::OtherVariant(a) if a < 5 * 2 => a);
```
If it fails, it emits a descriptive error including the pattern and the input,
for this reason `input` **must** implement `Debug`, unless you provide a custom error message
as the last arguments, in the same way you'd use `format!`.
## `option_match!` macro
The `option_match!` macro is like `unwrap_match!`, except instead of failing,
it just returns an `Option`.
```rust
let output: Option<_> = option_match!(input, AnEnum::Variant(a) | AnEnum::OtherVariant(a) if a < 5 * 2 => a);
```
## Error message improvements
The original matches crate would emit horrible errors when assertions failed,
outputting a pattern such as `Some(_)` as `Some ( _ )`. This version has properly
formatted errors, so you will never experience this again.