leveros - Node client library for Lever OS

The leveros Node client library can be used to invoke Lever methods either from within a Lever service or from outside Lever altogether.

Documentation

See ReadMe.io.

Installation

Installation for use outside Lever

$ npm install leveros

Installation for use within Lever

$ docker run --rm -it --user=root -v "$PWD":/leveros/custcode leveros/levercontainer:latest npm install leveros

The installation procedure is special for Lever because the library depends on grpc which contains C++ extensions for node. These need to be compiled on the OS it will run on. As Lever containers are Docker containers (namely containers based on the ubuntu image), the above command installs the library while running in the same container it will run on Lever.

To use the library, simply

require('leveros');

Quick example

var leveros = require('leveros');

var client = new leveros.Client();
client.forceHost = process.env.LEVEROS_IP_PORT;
var service = client.service('dev.lever', 'helloService');
service.invoke('sayHello', "world", function (error, reply) {
    console.log(reply);
});

# Without docker-machine
$ LEVEROS_IP_PORT="127.0.0.1:8080" node client.js

# With docher-machine
$ LEVEROS_IP_PORT="$(docker-machine ip default):8080" node client.js

Setting LEVEROS_IP_PORT is necessary so that you can invoke the dev.lever environment without adding an entry for it in /etc/hosts and setting the listen port to 80.