@fnndsc/chrisapi

ChRIS API

JavaScript 6 client for the ChRIS API.

Installation

npm i @fnndsc/chrisapi

API Documentation

If you have a ChRIS server up and running (eg. as explained below) then you can test the API in your Javascript code.

For more information visit the API documentation

Development and testing

ChRIS server preconditions

These preconditions are only necessary to be able to test the client against an actual instance of a ChRIS server both during development and for the automated tests.

Install latest Docker and Docker Compose.

Currently tested platforms:

• Docker 18.06.0+
• Docker Compose 1.27.0+
• Ubuntu 18.04+ and MAC OS X 10.14+

On a Linux machine make sure to add your computer user to the docker group

Install latest just command runner.

Fire up the full set of ChRIS services:

Open a terminal and run the following commands in any working directory:

$> git clone https://github.com/FNNDSC/ChRIS_ultron_backEnd.git
$> cd ChRIS_ultron_backEnd
$> just

Check that all the services are up:

$> docker ps -a

Create a test feed and two pipelines:

Run the following shell script on the directory of this README file. NOTE: The script depends on the popular curl and jq command line tools.

$> ./pre_test.sh

Tear down the full set of ChRIS services:

You can later remove all the backend containers and release storage volumes with:

$ cd ChRIS_ultron_backEnd
$ just nuke

JavaScript package manager prerequisite

• yarn

Open a terminal in the directory of this README file

Commands

Install dependencies

$> yarn install

Start tests in watch mode (used for developing)

$> yarn start

Start test in single run mode (used by Travis CI)

$> yarn test

Compile library to standalone bundle

$> yarn build

Generate source code documentation

$> yarn docs