aboutsummaryrefslogtreecommitdiff
path: root/src/test/util/README.md
diff options
context:
space:
mode:
authorMarcoFalke <falke.marco@gmail.com>2019-11-05 15:55:49 -0500
committerMarcoFalke <falke.marco@gmail.com>2019-11-06 11:56:53 -0500
commitfa4c6fa9b1139791f45f1495d662c1c7cd2f7ed6 (patch)
tree5e3268d8a7072c8c033231c2bb7a782abe2c68c6 /src/test/util/README.md
parentfaec28252cf4f8e754c689a7a44fd421f631db50 (diff)
downloadbitcoin-fa4c6fa9b1139791f45f1495d662c1c7cd2f7ed6.tar.xz
doc: Add documentation for new test/lib
Diffstat (limited to 'src/test/util/README.md')
-rw-r--r--src/test/util/README.md11
1 files changed, 11 insertions, 0 deletions
diff --git a/src/test/util/README.md b/src/test/util/README.md
new file mode 100644
index 0000000000..36ad645201
--- /dev/null
+++ b/src/test/util/README.md
@@ -0,0 +1,11 @@
+# Test library
+
+This contains files for the test library, which is used by the test binaries (unit tests, benchmarks, fuzzers, gui
+tests).
+
+Generally, the files in this folder should be well-separated modules. New code should be added to existing modules or
+(when in doubt) a new module should be created.
+
+The utilities in here are compiled into a library, which does not hold any state. However, the main file `setup_common`
+defines the common test setup for all test binaries. The test binaries will handle the global state when they
+instantiate the `BasicTestingSetup` (or one of its derived classes).