Crate assertables

source
Expand description

§Assertables: Rust crate of assert macros for testing

The assertables Rust crate provides many assert macros to improve your compile-time tests and run-time reliability.

§Introduction

The Rust programming language provides a few built-in assert macros to test code:

The Rust programming language provides assert macros to test code:

The assertables crate provides many more, so you can write smarter tests.

Examples:

Top 3 benefits:

  1. You can write better tests to improve reliability and maintainability.
  2. You can handle more corner cases without needing to write custom code.
  3. You can troubleshoot faster because error messages show specifics.

Top 3 features:

  1. Easy to use: everything is well-documented with runnable examples.
  2. Runtime savvy: all the assertables macros have runtime versions.
  3. Zero overhead: if you don’t use a macro, then it’s never compiled.

To use this crate, add it to your Cargo.toml file:

[dev-dependencies]
assertables = "8.13.0"

§Assert macros

For values:

For approximation:

For strings:

For matching:

For infix operators:

For nearness:

For Result Ok/Err:

For Option Some/None:

For Poll Ready/Pending:

For collections such as arrays, vectors, iterators, sets, bags:

For file system paths and input/output readers:

For command capture of standard output and standard error:

There are many more macros that are grouped into modules.

Modules for collections, such as arrays, vectors, lists, maps:

Modules for variants:

Modules for functions:

Modules for readers:

Modules for external calls:

§Forms

All assertables macros have forms for different outcomes:

All assertables macros have forms for an optional message:

Many assertables macros have forms for comparing left hand side (LHS) and right hand side (RHS) as the same type or as an expression:

§Tracking

  • Package: assertables-rust-crate
  • Version: 8.13.0
  • Created: 2021-03-30T15:47:49Z
  • Updated: 2024-10-03T16:03:50Z
  • License: MIT or Apache-2.0 or GPL-2.0 or GPL-3.0 or contact us for more
  • Contact: Joel Parker Henderson (joel@sixarm.com)

Modules§

Macros§