2 releases
0.1.1 | Oct 24, 2024 |
---|---|
0.1.0 | Oct 23, 2024 |
#318 in Parser tooling
262 downloads per month
74KB
1K
SLoC
test_eq!
assert_eq!
-like macros that return a Result instead.
The primary use case is in writing parsers, where you want to check that magic values are correct and that values
are as expected. The macros are implemented using macro_rules
and should therefore not have a significant impact
on compile times.
Usage
This crate contains two kinds of macros:
- Macros that check variables are as expected (
test_eq!
,test_any!
, …). - Macros that compose the test macros (
test_and!
andtest_or!
).
Examples
use test_eq::{TestFailure, test_eq, test_and, test_or, test_any, test_ge};
pub fn parser() -> Result<(), TestFailure> {
let magic: u32 = todo!();
test_eq!(magic, 0xDEAD_BEEF)?;
let version: u8 = todo!();
test_any!(version, 1..4, "unsupported version found")?;
let field: String = todo!();
test_or!(test_ge!(field.len(), 8), test_eq!(field, "spam"))?;
let field2: u32 = todo!();
test_and!(
test_any!(field2, 42..=2048),
test_eq!(field2 % 2, 0),
"related field: {}", field
)?;
}
Features
line-info
Provide the location in the source file where the error happened. This feature is enabled by default.
This information is set at compile time and cannot be removed with debug=false
or strip=true
.
Copyright
The implementation of these macros is based on the implementations of the assert*!
macros in the standard library.
The Rust standard library is dual-licensed under the MIT and Apache-2.0 licenses just like this library.