balena-pine
Balena PineJS client.
Role
The intention of this module is to provide a ready to use subclass of pinejs-client-js which uses balena-request.
THIS MODULE IS LOW LEVEL AND IS NOT MEANT TO BE USED BY END USERS DIRECTLY.
Unless you know what you're doing, use the balena SDK instead.
Installation
Install balena-pine
by running:
$ npm install --save balena-pine
Documentation
Instantiate the PineJS like that:
const { BalenaPine } = require('balena-pine')
var pine = new BalenaPine({}, {
apiUrl: "https://api.balena-cloud.com/",
apiVersion: "v2",
request: request, // An instantiated balena-request instance
auth: auth // An instantiated balena-auth instance
})
Where the second argument of the constructor accepts the following options:
apiUrl
, string, required, is the balena API url likehttps://api.balena-cloud.com/
,apiVersion
, string, required, is the version of the API to talk to, likev2
. The current stable version isv2
,apiKey
, string, optional, is the API key to make the requests with,request
, object, an instantiated balena-request instance.auth
, object, an instantiated balena-auth instance.
There are multiple builds you can use, to set the version globally use @balena/es-version, eg:
// Must be set before the first require // We support exact matches on es2015 (default) / es2018, see https://github.com/balena-io-modules/balena-es-version for a full list a possible versions // requires the version set above
or to force a specific version overriding the default (not recommended) you can use
// es2015/es6 // es2018
Head over to pinejs-client-js for the returned PineJS instance documentation.
Support
If you're having any problem, please raise an issue on GitHub and the balena team will be happy to help.
Tests
Run the test suite by doing:
$ npm test
Contribute
- Issue Tracker: github.com/balena-io-modules/balena-pine/issues
- Source Code: github.com/balena-io-modules/balena-pine
Before submitting a PR, please make sure that you include tests, and that coffeelint runs without any warning:
$ npm run lint
License
The project is licensed under the Apache 2.0 license.