Node-zenhub NPM

node-zenhub

A Node.js wrapper for the ZenHub API

Install

node-zenhub is available on npm and as such, can be installed through npm with ease.

To install node-zenhub and add it to your package.json file, use the following command:

$ npm install --save node-zenhub

Documentation

The official ZenHub documentation

Usage

In order to use node-zenhub you will need to generate an API token on the ZenHub website. Once you have this, add the library to your project with the following command:

$ npm install --save node-zenhub

Once installed you need to instantiate a new copy of node-zenhub in your application, like so:

var callback = function (error, data) {
    console.log(error);
    console.log(data);
}

var ZenHub = require('node-zenhub'),
    api = new ZenHub('[token]', [zenhub_api_url]);

api.boards.getBoard('[repoId]', callback);

Note: replace token with your token.

Note: zenhub_api_url is optional, you can use it with enterprise versions with custom URL

Available methods

Issues

Boards

getBoard

Epics

Milestones

Release Reports

Running the Tests

The tests are based on the mocha module, which may be installed via npm. To run the tests make sure that the npm dependencies are installed by running npm install from the project directory.

create file test/config.json from test/config.sample.json with your values

{
    "token": "xxxxxxxxxx",
    "repoId": "xxxxx",
    "issueId": 1,
    "milestoneNumber": 1,
    "releaseId": "59d3cd520a430a6344fd3bdb",
    "zenhubAPI": "https://zenhub.enterprise.com"
}

At the moment, test classes can only be run separately. This will e.g. run the Issues Api test: