Initial Vexta Core v0.1.0 release

2026-07-15 14:07:28 +00:00 · 2026-07-15 14:07:28 +00:00 · 25c454329d
commit 25c454329d
2481 changed files with 689289 additions and 0 deletions
--- a/qa/README.md
+++ b/qa/README.md
@ -0,0 +1,97 @@
+# Testing
+
+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 digibyte 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 python3-zmq library is required. On Ubuntu or Debian it can be installed via:
+
+    ```bash
+    sudo apt-get install python3-zmq
+    ```
+
+## OS X
+
+    ```bash
+    pip3 install pyzmq
+    ```
+
+## Running tests
+
+You can run any single test by calling
+
+    ```bash
+    qa/pull-tester/rpc-tests.py <testname>
+    ```
+
+Or you can run any combination of tests by calling
+
+    ```bash
+    qa/pull-tester/rpc-tests.py <testname1> <testname2> <testname3> ...
+    ```
+
+Run the regression test suite with
+
+    ```bash
+    qa/pull-tester/rpc-tests.py
+    ```
+
+Run all possible tests with
+
+    ```bash
+    qa/pull-tester/rpc-tests.py -extended
+    ```
+
+By default, tests will be run in parallel. To specify how many jobs to run,
+append `-parallel=n` (default n=4).
+
+If you want to create a basic coverage report for the rpc test suite, append `--coverage`.
+
+Possible options, which apply to each individual test run:
+
+    ```bash
+    -h, --help            show this help message and exit
+    --nocleanup           Leave digibyteds and test.* datadir on exit or error
+    --noshutdown          Don't stop digibyteds after the test execution
+    --srcdir=SRCDIR       Source directory containing digibyted/digibyte-cli
+                            (default: ../../src)
+    --tmpdir=TMPDIR       Root directory for datadirs
+    --tracerpc            Print out all RPC calls as they are made
+    --coveragedir=COVERAGEDIR
+                            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`).
+
+A 200-block -regtest blockchain and wallets for four nodes
+is created the first time a regression test is run and
+is stored in the cache/ directory. Each node has 25 mature
+blocks (25*50=1250 DGB) in its wallet.
+
+After the first run, the cache/ blockchain and wallets are
+copied into a temporary directory and used as the initial
+test state.
+
+If you get into a bad state, you should be able
+to recover with:
+
+    ```bash
+    rm -rf cache
+    killall digibyted
+    ```
+
+## 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](/qa/rpc-tests).