haveno/apitest/docs/build-run.md
woodser 88578bed10 general rebase in order to update payment methods and desktop app
Co-authored-by: Alva Swanson <alvasw@protonmail.com>
Co-authored-by: andyheko <haoen.ko@gmail.com>
Co-authored-by: Bisq GitHub Admin <51445974+bisq-github-admin-3@users.noreply.github.com>
Co-authored-by: BtcContributor <79100296+BtcContributor@users.noreply.github.com>
Co-authored-by: cd2357 <cd2357@users.noreply.github.com>
Co-authored-by: chimp1984 <chimp1984@gmx.com>
Co-authored-by: Chris Beams <chris@beams.io>
Co-authored-by: Christoph Atteneder <christoph.atteneder@gmail.com>
Co-authored-by: Devin Bileck <603793+devinbileck@users.noreply.github.com>
Co-authored-by: ghubstan <36207203+ghubstan@users.noreply.github.com>
Co-authored-by: Huey <hueydane@gmail.com>
Co-authored-by: Jakub Loucký <jakub.loucky@outlook.cz>
Co-authored-by: jmacxx <47253594+jmacxx@users.noreply.github.com>
Co-authored-by: KanoczTomas <tomas.kanocz@cnl.sk>
Co-authored-by: m52go <735155+m52go@users.noreply.github.com>
Co-authored-by: Marcus0x <marcus0x@xrhodium.org>
Co-authored-by: MarnixCroes <93143998+MarnixCroes@users.noreply.github.com>
Co-authored-by: Martin Harrigan <martinharrigan@gmail.com>
Co-authored-by: MwithM <50149324+MwithM@users.noreply.github.com>
Co-authored-by: sqrrm <sqrrm@users.noreply.github.com>
Co-authored-by: Stan <36207203+ghubstan@users.noreply.github.com>
Co-authored-by: Stephan Oeste <emzy@emzy.de>
Co-authored-by: Steven Barclay <stejbac@gmail.com>
Co-authored-by: WAT <shiido.it@gmail.com>
Co-authored-by: wiz <j@wiz.biz>
Co-authored-by: xyzmaker123 <84982606+xyzmaker123@users.noreply.github.com>
2022-05-28 13:56:29 -04:00

2.2 KiB

Build and Run API

The Java based API runs on Linux and OSX.

Mainnet

To build from the source, clone the GitHub repository found at https://github.com/bisq-network/bisq, and build with gradle:

$ ./gradlew clean build

To skip tests:

$ ./gradlew clean build -x test

To run the Bisq daemon:

$ ./bisq-daemon --apiPassword=<api-password> --apiPort=<api-port(default=9998)> --appDataDir=$APPDIR`

Note: $APPDIR is empty or otherwise contains a Bisq wallet created by the daemon or the UI.

Note: Never run the API daemon and Bisq UI on the same host, or you will corrupt your wallet. It will be possible with specific command line options, i.e., unique appDatadir and ports, but this scenario has not been tested yet.

Test Harness

The API test harness uses the GNU Bourne-Again SHell bash, and is not supported on Windows.

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.scenario.WalletTest" -DrunApiTests=true

To run test cases from 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.

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