elemental-live-client

elemental-live-client

JS library to communicate with Elemental live API.

Usage

The client provides standard methods for resources, so calls will use be structured in the format <client-instance>.<resource>().<operation>().

API operations always return promises that resolve with the response data and fail with details about the failure. An example, listing presets:

const client = new ElementalClient('https://elemental-server.example.com');

client.presets().list().then(
  (data) => console.log(`Got presets: ${data}`),
  (err) => console.log(`Something went wrong: ${err}`),
);

Available resources

The following resources are currently available:

• schedules
• liveEvents
• liveEventProfiles
• presets
• presetCategories
• devices

Available operations

Common operations are:

• create
• retrieve
• update
• delete
• list

Some resources might include more specific operations (for example, resetting a live event).

Contributing

Contributions are welcome! In order to run this project locally, you have to have node.js 6+ installed locally. We also recommend using yarn for managing dependencies, but plain-old npm should work just fine.

Just make sure your contributions pass the test suite and eslint validation. Travis CI will help you in ensuring that :)

Setting up local environment

Setting up the local environment is a simple task: just ensure that you have node.js and yarn installed, clone this repo and then run:

% yarn

This will install all dependencies.

Running tests and eslint

After installing all dependencies, you can run the tests with the command:

% yarn test

linting is also available, provided by eslint. The command to lint the source is very intuitive:

% yarn lint

Integration tests/Examples

You can integration tests in the file test/integration-test.js file. It contains integration tests that can also serve as examples on how to use the client.

To run integration tests locally, you need to provide the address of an actual Elemental server through the environment variable ELEMENTAL_CLIENT_INTEGRATION_TESTS_HOST and run yarn test. For example:

% ELEMENTAL_CLIENT_INTEGRATION_TESTS_HOST=http://elemental-live.example.com yarn test