corda/experimental/behave
2018-02-12 10:18:18 +00:00
..
deps Port library functionality from corda/behave 2018-02-09 19:08:26 +00:00
src Make RPC scaffolding available for Node 2018-02-12 10:18:18 +00:00
build.gradle Port library functionality from corda/behave 2018-02-09 19:08:26 +00:00
prepare.sh Update instructions 2018-02-12 10:07:27 +00:00
README.md Update instructions 2018-02-12 10:07:27 +00:00

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 MS SQL Server or 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.