diff options
| author | Martin Hořeňovský | 2025-07-24 21:55:30 +0200 |
|---|---|---|
| committer | Martin Hořeňovský | 2025-07-24 21:55:30 +0200 |
| commit | bdc634e9f1be010a7fe9558053215c9a18f23a24 (patch) | |
| tree | 8e99148d0a937ffaa9d27e9d227080fda0464dde /docs | |
| parent | 2a8a8a7210513fc2f6ae5e65986c0f2d730c1537 (diff) | |
| download | catch3-bdc634e9f1be010a7fe9558053215c9a18f23a24.tar.gz | |
Document that the default test run order is now random
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/command-line.md | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/docs/command-line.md b/docs/command-line.md index 18c4eeaf..6096802e 100644 --- a/docs/command-line.md +++ b/docs/command-line.md @@ -398,18 +398,24 @@ use test specs to filter this list down to what you want first. Test cases are ordered one of three ways: ### decl -Declaration order (this is the default order if no --order argument is provided). +Declaration order. + Tests in the same translation unit are sorted using their declaration orders, different TUs are sorted in an implementation (linking) dependent order. ### lex -Lexicographic order. Tests are sorted by their name, their tags are ignored. +Lexicographic order. + +Tests are sorted by their name, their tags are ignored. ### rand +Randomized order. The default order. + +> Randomized order has been made default in Catch2 X.Y.Z -Randomly ordered. The order is dependent on Catch2's random seed (see +The order is dependent on Catch2's random seed (see [`--rng-seed`](#rng-seed)), and is subset invariant. What this means is that as long as the random seed is fixed, running only some tests (e.g. via tag) does not change their relative order. |