aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMarcoFalke <falke.marco@gmail.com>2015-11-18 00:26:07 +0100
committerMarcoFalke <falke.marco@gmail.com>2015-11-18 11:59:12 +0100
commite16ee1cd1e1fd604ab9c2c4a715166d3fb40a53b (patch)
tree07f4fbb374397226d6d4c1469f0aeba6f1edd7a9
parentcc975745d585edf6ae3a9313f45da6dbdee16cf6 (diff)
[qa] Extend README.md
-rw-r--r--README.md5
-rw-r--r--qa/README.md19
2 files changed, 18 insertions, 6 deletions
diff --git a/README.md b/README.md
index c08b2fb0bc..b40ad0e396 100644
--- a/README.md
+++ b/README.md
@@ -49,9 +49,10 @@ lots of money.
### Automated Testing
Developers are strongly encouraged to write unit tests for new code, and to
-submit new unit tests for old code. Unit tests can be compiled and run (assuming they weren't disabled in configure) with: `make check`
+submit new unit tests for old code. Unit tests can be compiled and run
+(assuming they weren't disabled in configure) with: `make check`
-There are also regression and integration tests of the RPC interface, written
+There are also [regression and integration tests](/qa) of the RPC interface, written
in Python, that are run automatically on the build server.
These tests can be run with: `qa/pull-tester/rpc-tests.py`
diff --git a/qa/README.md b/qa/README.md
index 93157f4f1f..758d1f47e5 100644
--- a/qa/README.md
+++ b/qa/README.md
@@ -1,5 +1,12 @@
-Notes
-=====
+The [pull-tester](/qa/pull-tester/) folder contains a script to call
+multiple tests from the [rpc-tests](/qa/rpc-tests/) folder.
+
+Every pull request to the bitcoin repository is built and run through
+the regression test suite. You can also run all or only individual
+tests locally.
+
+Running tests
+=============
You can run any single test by calling `qa/pull-tester/rpc-tests.py <testname>`.
@@ -23,7 +30,8 @@ Possible options:
Write tested RPC commands into this directory
```
-If you set the environment variable `PYTHON_DEBUG=1` you will get some debug output (example: `PYTHON_DEBUG=1 qa/pull-tester/rpc-tests.py wallet`).
+If you set the environment variable `PYTHON_DEBUG=1` you will get some debug
+output (example: `PYTHON_DEBUG=1 qa/pull-tester/rpc-tests.py wallet`).
A 200-block -regtest blockchain and wallets for four nodes
is created the first time a regression test is run and
@@ -42,5 +50,8 @@ rm -rf cache
killall bitcoind
```
+Writing tests
+=============
+You are encouraged to write tests for new or existing features.
Further information about the test framework and individual rpc
-tests is found in [qa/rpc-tests/README.md](/qa/rpc-tests/README.md).
+tests is found in [qa/rpc-tests](/qa/rpc-tests).