env_assert is a incredibly simple Rust library that allows you to only run an assert! when an the RUST_ENV_ASSERT environmental variable is set to true.
For example:
```rust use envassert::envassert; fn main() { let res = expensivefuncthatshouldreturnpositive(); envassert!(res.is_positive()); // "sanity check"
println!("We got here because the environmental variable was not set!");
}
fn expensivefuncthatshouldreturn_positive() -> i8 { // do some really hard things here
// oh no! our expensive function messed up and is going to return a negative value
-42
} ```
text
$ cargo run
We got here because the environmental variable was not set!
Now lets set our variable and then run
text
$ RUST_ENV_ASSERT=true cargo run
thread 'main' panicked at 'assertion failed: res.is_positive()', src/main.rs:4:5
Sometimes, the performance increase for running in release mode is significant, but I still want asserts. However, some of those asserts are in a sense debug asserts, and I would rather the program continue than crash when it is deployed. This library lets you have asserts while in release mode, without negatively impacting performance for end users.
Eh, probably not.
This crate is good for simple testing and pet projects, but if this behavior is desired you should probably now use a Cargo profile to enable debug_assert!() and optimizations at the same time.