Assertables Rust crate of macros for "assert" and "assertable"

This assertables Rust crate provides macros for assert…! and assertable…!, which are useful for testing and also for runtime reliability checking. By SixArm.com.

Crate: https://crates.io/crates/assertables

Docs: https://docs.rs/assertables/

Repo: https://github.com/sixarm/assertables-rust-crate/

assert & assertable

These macros have two styles:

• assert macros return () or panic!(…).

• assertable macros return Ok(()) or Err(…).

Examples of "assert less than" and "assertable less than":

```rust assert_lt!(1, 2); // assert 1 is less than 2 //-> ()

assert_lt!(2, 1); //-> panic! // assertion failed: assert_lt!(left, right) // left: 2, // right: 1

let x = assertable_lt!(1, 2); //-> Ok(())

let x = assertable_lt!(2, 1); //-> Err("…") // assertable failed: assertable_lt!(left, right) // left: 2, // right: 1 ```

These two styles are useful because:

• assert macros favor compile-time tests and diagnostics.

• assertable macros favor run-time tracing and recoveries.

The macros use abbreviations: eq (equals), ne (not equals), lt (less than), le (less than or equal to), gt (greater than), ge (greater than or equals).

The macros have a second form where a custom error message can be provided.

assert_xx for values

Compare values.

• assert_eq!(a, b) ~ a == b

• assert_ne!(a, b) ~ a != b

• assert_lt!(a, b) ~ a < b

• assert_le!(a, b) ~ a <= b

• assert_gt!(a, b) ~ a > b

• assert_ge!(a, b) ~ a >= b

Examples:

```rust assert_lt!(1, 2); //-> ()

assert_lt!(2, 1); //-> panic! // assertion failed: assert_lt!(left, right) // left: 2 // right: 1 ```

assertfxx for function returns

• assert_f_eq!(f, a, b) ~ f(a) == f(b)

• assert_f_ne!(f, a, b) ~ f(a) != f(b)

• assert_f_lt!(f, a, b) ~ f(a) < f(b)

• assert_f_le!(f, a, b) ~ f(a) <= f(b)

• assert_f_gt!(f, a, b) ~ f(a) > f(b)

• assert_f_ge!(f, a, b) ~ f(a) >= f(b)

Examples:

```rust assertflt!(i32::abs, 1, -2); //-> ()

assertflt!(i32::abs, -2, 1); //-> panic! // assertion failed: assert_f_eq!(function, left, right) // function: \"i32::abs\", // left input: -2, // right input: 1, // left output: 2, // right output: 1 ```

assertfok_xx for function Result Ok values

• assert_f_ok_eq!(f, a, b) ~ f(a).unwrap() == f(b).unwrap()

• assert_f_ok_ne!(f, a, b) ~ f(a).unwrap() != f(b).unwrap()

• assert_f_ok_lt!(f, a, b) ~ f(a).unwrap() < f(b).unwrap()

• assert_f_ok_le!(f, a, b) ~ f(a).unwrap() <= f(b).unwrap()

• assert_f_ok_gt!(f, a, b) ~ f(a).unwrap() > f(b).unwrap()

• assert_f_ok_ge!(f, a, b) ~ f(a).unwrap() >= f(b).unwrap()

```rust fn exampledigitto_string(i: isize) -> Result { match i { 0..=9 => Ok(format!("{}", i)), _ => Err(format!("{:?} is out of range", i)), } }

assertfoklt!(exampledigittostring, 1, 2); //-> ()

assertfoklt!(exampledigittostring, 2, 1); //-> panic! // assertion failed: assert_f_eq!(function, left, right) // function: \"example_digit_to_string\", // left input: 2, // right input: 1, // left output: \"2\", // right output: \"1\" ```

assertferrstringxx for function Result Err strings

• assert_f_err_string_eq!(f, a, b) ~ f(a).unwraperr().tostring() == f(b).unwraperr().tostring()

• assert_f_err_string_ne!(f, a, b) ~ f(a).unwraperr().tostring() != f(b).unwraperr().tostring()

• assert_f_err_string_lt!(f, a, b) ~ f(a).unwraperr().tostring() < f(b).unwraperr().tostring()

• assert_f_err_string_le!(f, a, b) ~ f(a).unwraperr().tostring() <= f(b).unwraperr().tostring()

• assert_f_err_string_gt!(f, a, b) ~ f(a).unwraperr().tostring() > f(b).unwraperr().tostring()

• assert_f_err_string_ge!(f, a, b)~ f(a).unwraperr().tostring() >= f(b).unwraperr().tostring()

Examples:

```rust fn exampledigitto_string(i: isize) -> Result { match i { 0..=9 => Ok(format!("{}", i)), _ => Err(format!("{:?} is out of range", i)), } }

assertferrstringlt!(exampledigitto_string, 10, 20); //-> ()

assertferrstringlt!(exampledigitto_string, 20, 10); //-> panic! // assertion failed: assert_f_err_string_eq!(example_digit_to_string, left, right) // function: \"example_digit_to_string\", // left input: 20, // right input: 10``, // left is err:true, // right is err:true, // left output:\"20 is out of range\", // right output:\"10 is out of range\"` ```

Two functions that we use often:

• assert_f_ok_eq!(i32::from_str, str1, str2); // compare parsing of numbers

• assert_f_ok_eq!(std::fs::read_to_string, file1, file2); // compare file text

assertsetxx for set comparisons

These macros help with comparison of set parameters, such as two arrays or two vectors. where the item order does not matter, and the item count does not matter. The macros convert inputs into HashSet iterators.

• assert_set_eq!(a, b) ~ set a == set b

• assert_set_ne!(a, b) ~ set a != set b

• assert_set_subset!(a, b) ~ set a ⊆ set b

• assert_set_superset!(a, b) ~ set a ⊇ set b

• assert_set_joint!(a, b) ~ set a is joint with set b

• assert_set_disjoint!(a, b) ~ set a is disjoint with set b

Examples:

```rust assertseteq!([1, 2], [2, 1]); //-> ()

assertseteq!([1, 2], [3, 4]); //-> panic // assertion failed: assert_set_eq!(left, right) // left: [1, 2], // right: [3, 4] //-> panic!("assertion failed: assert_set_eq!(left, right)\n left: [1, 2],\n right: [3, 4]"); ```

assertbagxx for bag comparisons

These macros help with comparison of bag parameters, such as comparison of two arrays or two vectors, where the item order does not matter, and the item count does matter. The macros convert inputs into HashMap iterators.

• assert_bag_eq(a, b) ~ bag a == bag b

• assert_bag_ne(a, b) ~ bag a != bag b

• assert_bag_subbag(a, b) ~ bag a ⊆ bag b

• assert_bag_superbag(a, b) ~ bag a ⊇ bag b

Examples:

```rust assertbageq!([1, 1], [1, 1]); //-> ()

assertbageq!([1, 1], [1, 1, 1]); //-> panic! // assertion failed: assert_bag_eq!(left, right) // left: [1, 1], // right: [1, 1, 1] ```

assertioxx for input/output comparisons

These macros help with input/output checking, such as with comparison of disk files, IO streams, etc.

• assert_io!(a) ~ a is true

• assert_io_eq!(a, b) ~ a == b

• assert_io_ne!(a, b) ~ a != b

• assert_io_lt!(a, b) ~ a < b

• assert_io_le!(a, b) ~ a <= b

• assert_io_gt!(a, b) ~ a > b

• assert_io_ge!(a, b) ~ a >= b

Examples:

```rust assertiolt!(1, 2); //-> ()

assertiolt!(2, 1); //-> panic! // assertion failed: assert_io_lt!(left, right) // left: 2, // right: 1 ```

assertreadtostringxx for std::io::Read comparisons

These macros help with readers, such as file handles, byte arrays, input streams, and the trait std::io::Read.

• assert_read_to_string_eq!(a, b) ~ a.readtostring() == b.readtostring()

• assert_read_to_string_ne!(a, b) ~ a.readtostring() != b.readtostring()

• assert_read_to_string_lt!(a, b) ~ a.readtostring() < b.readtostring()

• assert_read_to_string_le!(a, b) ~ a.readtostring() <= b.readtostring()

• assert_read_to_string_gt!(a, b) ~ a.readtostring() > b.readtostring()

• assert_read_to_string_ge!(a, b) ~ a.readtostring() >= b.readtostring()

Examples:

```rust use std::io::Read;

let mut a = "a".asbytes(); let mut b = "b".asbytes(); assertreadtostringlt!(a, b); //-> ()

let mut a = "a".asbytes(); let mut b = "b".asbytes(); assertreadtostringlt!(b, a); //-> panic! // assertion failed: assert_read_to_string_lt!(left, right) // left: \"b\", // right: \"a\" ```