2018-02-09 19:23:56 +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](cucumber.io).
|
|
|
|
|
|
2018-02-09 12:58:38 +00:00
|
|
|
# Setup
|
|
|
|
|
|
|
|
|
|
To get started, please run the following command:
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
$ ./prepare.sh
|
|
|
|
|
```
|
|
|
|
|
|
2018-02-09 19:23:56 +00:00
|
|
|
This script will download necessary database drivers and set up
|
2018-02-09 12:58:38 +00:00
|
|
|
the dependencies directory with copies of the Corda fat-JAR and
|
2018-02-09 19:23:56 +00:00
|
|
|
the network bootstrapping tool.
|
