Skip to content

Commit 14c7de0

Browse files
committed
doc: unit test runner documentation improvements
including hoisting the `test_bitcoin --help` sentence to the beginning of the section, where it is probably the most useful.
1 parent 03c48f9 commit 14c7de0

File tree

1 file changed

+16
-7
lines changed

1 file changed

+16
-7
lines changed

src/test/README.md

+16-7
Original file line numberDiff line numberDiff line change
@@ -35,15 +35,26 @@ the `src/qt/test/test_main.cpp` file.
3535

3636
### Running individual tests
3737

38-
`test_bitcoin` accepts the command line arguments from the boost framework.
39-
For example, to run just the `getarg_tests` suite of tests:
38+
The `test_bitcoin` runner accepts command line arguments from the Boost
39+
framework. To see the list of arguments that may be passed, run:
40+
41+
```
42+
test_bitcoin --help
43+
```
44+
45+
For example, to run only the tests in the `getarg_tests` file, with full logging:
4046

4147
```bash
4248
build/src/test/test_bitcoin --log_level=all --run_test=getarg_tests
4349
```
4450

45-
`log_level` controls the verbosity of the test framework, which logs when a
46-
test case is entered, for example.
51+
or
52+
53+
```bash
54+
build/src/test/test_bitcoin -l all -t getarg_tests
55+
```
56+
57+
The `--log_level=` (or `-l`) argument controls the verbosity of the test output.
4758

4859
`test_bitcoin` also accepts some of the command line arguments accepted by
4960
`bitcoind`. Use `--` to separate these sets of arguments:
@@ -62,7 +73,7 @@ standard terminal output.
6273
build/src/test/test_bitcoin --run_test=getarg_tests/doubledash
6374
```
6475

65-
`test_bitcoin` creates a temporary working (data) directory with a randomly
76+
Running `test_bitcoin` creates a temporary working (data) directory with a randomly
6677
generated pathname within `test_common bitcoin/`, which in turn is within
6778
the system's temporary directory (see
6879
[`temp_directory_path`](https://en.cppreference.com/w/cpp/filesystem/temp_directory_path)).
@@ -97,8 +108,6 @@ If you run an entire test suite, such as `--run_test=getarg_tests`, or all the t
97108
(by not specifying `--run_test`), a separate directory
98109
will be created for each individual test.
99110

100-
Run `test_bitcoin --help` for the full list of arguments that can be passed.
101-
102111
### Adding test cases
103112

104113
To add a new unit test file to our test suite, you need

0 commit comments

Comments
 (0)