corda/experimental/behave
Rick Parker 384a7c37b9 CORDA-2525 - Start pooling classpath scanning and related fixes (#4664) (#4685)
* Start pooling classpath scanning

Quickly patch synchronisation of attachment class loader cache.  Needs a revisit but more complicated due to DJVM.

Annotate away for DJVM

Take ClassGraph utils into their own file so we can exclude for DJVM

Clean up a little

* Daemonize the threads

* Seems to be some concurrency problems with use of ClassGraph.  Using a mutex for now to work around.

(cherry picked from commit 7dc7313fb7)
2019-01-30 14:26:47 +00:00
..
deps Corda Behave extensions for CTS (#2968) 2018-04-19 09:56:16 +01:00
src CORDA-2525 - Start pooling classpath scanning and related fixes (#4664) (#4685) 2019-01-30 14:26:47 +00:00
build.gradle CORDA-2331 Split Workflow and contracts of Finance App into separate Cordapps (#4422) 2018-12-19 18:02:51 +00:00
prepare.sh CORDA-1602: Added cmd line flags to the network bootstrapper (#3419) 2018-06-23 11:36:10 +01:00
README.md Corda Behave extensions for CTS (#2968) 2018-04-19 09:56:16 +01: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 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"