Introduction

This repository contains the runtime assets for the various application flavors in the Exabyte platform workflow units.

Installation

Javascript

npm install @exabyte-io/application-flavors.js

Repo Organization

Application templates live in assets, with each subdirectory being the name of each application. All files in here are considered to be Jinja2 templates (regardless of the file extension), and so each file has a *.j2.* name as a reminder.

The javascript library source code lives in src/js to make room for other language libraries in the future.

Building, Testing, and Using in Development

With a working NPM environment, do:

 npm install
 npm test

To build the library's source such that you can import it from another project during development, do:

npm run prepublishOnly

Then you can change your importing project's package.json to temporarily include the file path import instead of installing from NPM:

"@exabyte-io/application-flavors.js": "file:/some/path/to/application-flavors",

Remember to revert this line to an NPM version when you're done developing.

Python Integration Tests

We use the built-in unittests module to run our unit tests. They can be run by doing:

cd test/pythonml
python -m unittest

This set of tests is configured using the integration_configuration.yaml file, which contains information for which units are to be present in a test, and the order they're to be run in. It also contains general settings, such as where the test fixtures are located, and which files need to be cleaned up when a test job is complete.

Applications and Models

The available models for each application are defined via asset files in the models directory, which are used to construct a single object whitelisting all models implemented by a given application (model_list.js). These asset files are organized in the specific way, whereby the filepath also plays a role in the generation of the model list object:

directory - application name
filename - application version
first level (of the object defined by asset) - executable
second level - build of the executable

The build property contains a list of objects defining the path of the node in the feature tree (path) as well as additional data (data), which is used to redefine tree data locally.