b208d03f5c
* Compendium of minor changes and improvements: - build fat behave-jar so can run scenarios from shell scripts (from TC) - additional run script to execute basic scenarios (for TC) - default staging path shortened to "corda" (removed deps) - toned down logging (info -> debug) - fixed all compiler warnings - fixed couple of bugs in startup checking steps - base scenarios use variables declared using Examples parameterization * Added missing braces * Changes to address PR feedback. * Mark underlying Cucumber libraries for future de-coupling. |
||
|---|---|---|
| .. | ||
| deps | ||
| src | ||
| build.gradle | ||
| prepare.sh | ||
| README.md | ||
Introduction
This project illustrates how one can use Cucumber / BDD to drive and test homogeneous and heterogeneous Corda networks on a local machine. The framework has built-in support for Dockerised node dependencies so that you easily can spin up a Corda node locally that, for instance, uses a 3rd party database provider such as Postgres.
Structure
The project is split into three pieces:
-
Testing Library (main) - This library contains auxiliary functions that help in configuring and bootstrapping Corda networks on a local machine. The purpose of the library is to aid in black-box testing and automation.
-
Unit Tests (test) - These are various tests for the library described above. Note that there's only limited coverage for now.
-
BDD Framework (scenario) - This module shows how to use BDD-style frameworks to control the testing of Corda networks; more specifically, using Cucumber.
Setup
To get started, please follow the instructions below:
-
Go up to the root directory and build the capsule JAR.
$ cd ../../ $ ./gradlew install -
Come back to this folder and run:
$ cd experimental/behave $ ./prepare.sh
This script will download necessary database drivers and set up the dependencies directory with copies of the Corda fat-JAR and the network bootstrapping tool.
Selective Runs
If you only want to run tests of a specific tag, you can append the following parameter to the Gradle command:
$ ../../gradlew scenario -Ptags="@cash"
# or
$ ../../gradlew scenario -Ptags="@cash,@logging"