better-assert

Crates.iobetter-assert
lib.rsbetter-assert
version0.3.2
created_at2025-05-20 21:39:21.320383+00
updated_at2025-05-20 22:07:14.21489+00
descriptionAssertion helpers with built-in logging powered by better-logger
homepagehttps://github.com/Gistyr/better-assert
repositoryhttps://github.com/Gistyr/better-assert
max_upload_size
id1682487
size58,324
Justin (Lozlof)

documentation

https://docs.rs/better-assert

README

better-assert

Assertion helpers with built-in logging powered by better-logger

⚠️ Is this crate right for you?

Dependency note

See better-logger before you use this crate

better-assert incorporates better-logger as its logging facade. Any project using better-assert must do the same.
better-logger has terminal, file, and network logging functionality.

Why you might need it

Scenario Pain point with plain assert! How better-assert helps
WASM front-end An assert_eq! fails silently in a user’s browser, you never see it log_assert_eq() sends a log entry to your backend before the panic
Headless server / embedded A panic! crash disappears into /dev/null or an unknown serial console log_panic() sends the details to a file, syslog, or over-the-wire sink

HOW TO USE

😺 ONE: Declare Feature

/* no default feature enabled (enabling both at once won't compile) */
better-assert = { version = "0.3.2", features = ["native"] }
better-assert = { version = "0.3.2", features = ["wasm"] }

🦮 TWO: Incorporate better-logger

See the better-logger docs for the quick-start

/* Also has no default feature enabled (enabling both at once won't compile) */
better-logger = { version = "1.0.3", features = ["native"] }
better-logger = { version = "1.0.3", features = ["wasm"] }

💻 THREE: Use

use better_assert::*;

let left = "value".to_string();
let right = "value".to_string(); 

log_assert_eq(&left, &right); // enabled in all builds
log_assert_ne(&left, &right);

debug_log_assert_eq(&left, &right); // enabled only in debug builds
debug_log_assert_ne(&left, &right);

log_panic(); // always logs, then panics

License

© 2025 Gistyr LLC
This project, better-assert, is dual-licensed under your choice of:

Commit count: 17

cargo fmt