Browse Source

[qa] Extend README.md

0.13
MarcoFalke 9 years ago
parent
commit
e16ee1cd1e
  1. 5
      README.md
  2. 19
      qa/README.md

5
README.md

@ -49,9 +49,10 @@ lots of money.
### Automated Testing ### Automated Testing
Developers are strongly encouraged to write unit tests for new code, and to 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. in Python, that are run automatically on the build server.
These tests can be run with: `qa/pull-tester/rpc-tests.py` These tests can be run with: `qa/pull-tester/rpc-tests.py`

19
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>`. 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 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 A 200-block -regtest blockchain and wallets for four nodes
is created the first time a regression test is run and is created the first time a regression test is run and
@ -42,5 +50,8 @@ rm -rf cache
killall bitcoind killall bitcoind
``` ```
Writing tests
=============
You are encouraged to write tests for new or existing features.
Further information about the test framework and individual rpc 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).

Loading…
Cancel
Save