https://github.com/poignardazur/assert_let
Rust macro `assert_let` to provide convenient pattern matching in tests.
https://github.com/poignardazur/assert_let
Last synced: 3 months ago
JSON representation
Rust macro `assert_let` to provide convenient pattern matching in tests.
- Host: GitHub
- URL: https://github.com/poignardazur/assert_let
- Owner: PoignardAzur
- License: mit
- Created: 2022-08-15T14:28:42.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-02-21T13:21:25.000Z (over 3 years ago)
- Last Synced: 2025-03-25T12:41:19.100Z (about 1 year ago)
- Language: Rust
- Size: 7.81 KB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# assert_let_bind
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](https://github.com/murarth/assert_matches))
```
use assert_let_bind::assert_let;
#[derive(Debug)]
enum Foo {
A(i32, i32),
B(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:
```rust
let pattern = expr else { panic!("some panic message with {} {}", pattern, expr)};
```
## Usage
This macro relies on `let else`, and thus only compiles from Rust 1.65 onwards.
To add it to your project:
```rust
cargo add assert_let_bind
```
To add it only to your tests:
```rust
cargo add --dev assert_let_bind
```
## License
This code is distributed under the terms of the MIT license. See LICENSE file
for details.
## Contributing
Contributions are unnecessary because this crate is already perfect.
In the unlikely eventuality that it isn't, issues and pull requests welcome.