2020-08-17 20:57:54 +02:00
|
|
|
# Build and Run API Test Harness
|
|
|
|
|
|
|
|
|
|
## Linux & OSX
|
|
|
|
|
|
|
|
|
|
The API test harness uses the GNU Bourne-Again SHell `bash`, and is not supported on Windows.
|
|
|
|
|
|
|
|
|
|
## Predefined DAO / Regtest Setup
|
|
|
|
|
|
|
|
|
|
The API test harness depends on the contents of https://github.com/bisq-network/bisq/raw/master/docs/dao-setup.zip.
|
|
|
|
|
The files contained in dao-setup.zip include a bitcoin-core wallet, a regtest genesis tx and chain of 111 blocks, plus
|
|
|
|
|
data directories for Bob and Alice Bisq instances. Bob & Alice wallets are pre-configured with 10 BTC each, and the
|
|
|
|
|
equivalent of 2.5 BTC in BSQ distributed among Bob & Alice's BSQ wallets.
|
|
|
|
|
|
|
|
|
|
See https://github.com/bisq-network/bisq/blob/master/docs/dao-setup.md for details.
|
|
|
|
|
|
|
|
|
|
## Install DAO / Regtest Setup Files
|
|
|
|
|
|
|
|
|
|
Bisq's gradle build file defines a task for downloading dao-setup.zip and extracting its contents to the
|
|
|
|
|
`apitest/src/main/resources` folder, and the test harness will install a fresh set of data files to the
|
|
|
|
|
`apitest/build/resources/main` folder during a test case's scaffold setup phase -- normally a static `@BeforeAll` method.
|
|
|
|
|
|
|
|
|
|
The dao-setup files can be downloaded during a normal build:
|
|
|
|
|
|
|
|
|
|
$ ./gradlew clean build :apitest:installDaoSetup
|
|
|
|
|
|
|
|
|
|
Or by running a single task:
|
|
|
|
|
|
|
|
|
|
$ ./gradlew :apitest:installDaoSetup
|
|
|
|
|
|
|
|
|
|
The `:apitest:installDaoSetup` task does not need to be run again until after the next time you run the gradle `clean` task.
|
|
|
|
|
|
|
|
|
|
## Run API Tests
|
|
|
|
|
|
|
|
|
|
The API test harness supports narrow & broad functional and full end to end test cases requiring
|
|
|
|
|
long setup and teardown times -- for example, to start a bitcoind instance, seednode, arbnode, plus Bob & Alice
|
|
|
|
|
Bisq instances, then shut everything down in proper order. For this reason, API test cases do not run during a normal
|
|
|
|
|
gradle build.
|
|
|
|
|
|
|
|
|
|
To run API test cases, pass system property`-DrunApiTests=true`.
|
|
|
|
|
|
|
|
|
|
To run all existing test cases:
|
|
|
|
|
|
|
|
|
|
$ ./gradlew :apitest:test -DrunApiTests=true
|
|
|
|
|
|
|
|
|
|
To run all test cases in a package:
|
|
|
|
|
|
|
|
|
|
$ ./gradlew :apitest:test --tests "bisq.apitest.method.*" -DrunApiTests=true
|
|
|
|
|
|
|
|
|
|
To run a single test case:
|
|
|
|
|
|
|
|
|
|
$ ./gradlew :apitest:test --tests "bisq.apitest.method.GetBalanceTest" -DrunApiTests=true
|
|
|
|
|
|
2020-08-17 21:11:31 +02:00
|
|
|
To run test cases from an Intellij, add two JVM arguments to your JUnit launchers:
|
|
|
|
|
|
|
|
|
|
-DrunApiTests=true -Dlogback.configurationFile=apitest/build/resources/main/logback.xml
|
|
|
|
|
|
|
|
|
|
The `-Dlogback.configurationFile` property will prevent `logback` from printing warnings about multiple `logback.xml`
|
|
|
|
|
files it will find in Bisq jars `cli.jar`, `daemon.jar`, and `seednode.jar`.
|
|
|
|
|
|
2020-08-17 20:57:54 +02:00
|
|
|
## Gradle Test Reports
|
|
|
|
|
|
|
|
|
|
To see detailed test results, logs, and full stack traces for test failures, open
|
|
|
|
|
`apitest/build/reports/tests/test/index.html` in a browser.
|
|
|
|
|
|
|
|
|
|
## See also
|
|
|
|
|
|
|
|
|
|
- [test-categories.md](test-categories.md)
|
|
|
|
|
|
