#sorting #testing #assertions #debugging #diff #non-deterministic #output

pretty_assertions_sorted_fork

Wrapper around the rust-pretty-assertions crate that allows for the ability to sort the Debug output

1 unstable release

0.10.0 Aug 19, 2024

#1388 in Development tools


Used in opentelemetry_gcloud_moni…

MIT/Apache

160KB
845 lines

Pretty Assertions (Sorted) (FORK)

This crate is deprecated please use this one

main repo

In this fork add sort_all for ignore ordering in array

If we dont need ignore ordering in array please use this crate

This crate wraps the pretty_assertions crate, which highlights differences in a test failure via a colorful diff.

However, the diff is based on the Debug output of the objects. For objects that have non-deterministic output, eg. two HashMaps with close to the same contents, the diff will be polluted and obscured with with false-positive differences like here:

standard assertion

This is much easier to understand when the diff is sorted:

sorted assertion

This is a pretty trivial example, you could solve this instead by converting the HashMap to a BTreeMap in your tests. But it's not always feasible to replace the types with ordered versions, especially for HashMaps that are deeply nested in types outside of your control.

To use the sorted version, import like this:

use pretty_assertions_sorted::{assert_eq, assert_eq_sorted};

assert_eq is provided as a re-export of pretty_assertions::assert_eq and should be used if you don't want the Debug output to be sorted, or if the Debug output can't be sorted (not supported types, eg. f64::NEG_INFINITY, or custom Debug output).

Tip

Specify it as [dev-dependencies] and it will only be used for compiling tests, examples, and benchmarks. This way the compile time of cargo build won't be affected!

License: MIT/Apache-2.0

Dependencies

~2MB
~32K SLoC