Browse Source

Merge #7635: [Documentation] Add dependency info to test docs

2ab835a Check if zmq is installed in tests, update docs (Elliot Olds)
pull/1/head
Wladimir J. van der Laan 7 years ago
parent
commit
0fa88ef784
No known key found for this signature in database
GPG Key ID: 74810B012346C9A6
  1. 4
      README.md
  2. 11
      qa/README.md
  3. 9
      qa/pull-tester/rpc-tests.py

4
README.md

@ -55,10 +55,10 @@ submit new unit tests for old code. Unit tests can be compiled and run @@ -55,10 +55,10 @@ submit new unit tests for old code. Unit tests can be compiled and run
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`
These tests can be run (if the [test dependencies](/qa) are installed) with: `qa/pull-tester/rpc-tests.py`
The Travis CI system makes sure that every pull request is built for Windows
and Linux, OSX, and that unit and sanity tests are automatically run.
and Linux, OS X, and that unit and sanity tests are automatically run.
### Manual Quality Assurance (QA) Testing

11
qa/README.md

@ -5,6 +5,17 @@ Every pull request to the bitcoin repository is built and run through @@ -5,6 +5,17 @@ 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.
Test dependencies
=================
Before running the tests, the following must be installed.
Unix
----
The python-zmq library is required. On Ubuntu or Debian it can be installed via:
```
sudo apt-get install python-zmq
```
Running tests
=============

9
qa/pull-tester/rpc-tests.py

@ -40,6 +40,15 @@ if not vars().has_key('ENABLE_UTILS'): @@ -40,6 +40,15 @@ if not vars().has_key('ENABLE_UTILS'):
ENABLE_UTILS=0
if not vars().has_key('ENABLE_ZMQ'):
ENABLE_ZMQ=0
# python-zmq may not be installed. Handle this gracefully and with some helpful info
if ENABLE_ZMQ:
try:
import zmq
except ImportError:
print("WARNING: \"import zmq\" failed. Setting ENABLE_ZMQ=0. " \
"To run zmq tests, see dependency info in /qa/README.md.")
ENABLE_ZMQ=0
ENABLE_COVERAGE=0

Loading…
Cancel
Save