#assert #let #match #pattern #macro

no-std assert_let_bind

A convenience macro for writing pattern-matching tests

2 releases

Uses new Rust 2021

0.1.1 Aug 15, 2022
0.1.0 Aug 15, 2022

#200 in Debugging

MIT license



A convenience macro for writing pattern-matching tests in the Rust programming language.

The assert_let macro tests whether a value matches a given pattern, binding the pattern in the current scope if the match succeeds and causing a panic if the match fails.

(Strongly inspired by assert_matches)

use assert_let_bind::assert_let;

enum Foo {
    A(i32, i32),

let foo = Foo::A(3000, 2000);

assert_let!(Foo::A(x, y), foo);
assert_eq!(x + y, 5000);

Generally speaking, assert_let(pattern, expr) is roughly equivalent to:

let pattern = expr else { panic!("some panic message with {} {}", pattern, expr)};


This macro relies on let else, and thus only compiles in nightly Rust for now.

To add it to your project:

cargo add assert_let_bind

To add it only to your tests:

cargo add --dev assert_let_bind


This code is distributed under the terms of the MIT license. See LICENSE file for details.


Contributions are unnecessary because this crate is already perfect.

In the unlikely eventuality that it isn't, issues and pull requests welcome.

No runtime deps