0.1.9 • Published 9 years ago

moussaka-client v0.1.9

Weekly downloads
2
License
MIT
Repository
github
Last release
9 years ago

moussaka-client

A javascript library that allows you to use javascript applications with the Moussaka prototyping framework.

Build Status Coverage Status

Usage Example

  // Instantiate client
  var client = new MoussakaClient(opts);

  // Auto detect variable type
  var aNumber = client.registerVar('aNumber', 5);
  var aString = client.registerVar('aString', 'string beans');
  var aColor  = client.registerVar('aColor', new MoussakaClient.types.Color(1, 0, 0, 1)); // Moussaka type

  // Define specific schema
  var validatedNumber = client.registerVar('validatedNumber', 5, {
    type: 'float',
    min: 0,
    max: 100
  });

  // Start polling
  client.connect();

  while(running) {
    // Use Moussaka to adjust variables, MoussakaClient will poll for updates
    // and update the values accordingly.

    console.log(aNumber.value);
    console.log(aString.value);
    console.log(aColor.value.toString());
    console.log(validatedNumber.value);
  }

  // Stop polling afterwards
  client.disconnect();

Options

To instantiate MoussakaClient you must pass in an object with the following keys.

OptionDesciptionDefault
deviceNameThe name of the device (i.e. John Smith's PC.)None
apiKeyThe user API key retreived from the user account settings in Moussaka.None
projectIdThe project ID retreived from the project view page in Moussaka.None
projectVersionA string specifying the particular version of the project that this library is used in.None
serverUrlThe url to your Moussaka server.http://localhost:3000/
pollIntervalThe time in milliseconds between each poll to the server.1000
logLevelSee section below.2 (warning)

Installing

It can be used directly in a node application or in the browser.

In Node:
  • Install the package through npm
npm install moussaka-client
  • Load the module
var MoussakaClient = require('moussaka-client');
var client = new MoussakaClient(opts);
In The Browser:

There are a few ways you can use it in the browser:

Get the package through bower:

bower install moussaka-client

The library bundle will be accessible at '/bower_components/moussaka-client/dist/moussaka-client.min.js'. Then choose your favourite way to load up the module:

  • Consume it with CommonJS
var MoussakaClient = require('/path/to/moussaka-client.js');
  • Consume it with RequireJS
<script src="require.js"></script>
<script src="/path/to/moussaka-client.js"></script>
require('moussaka-client.js', function (MoussakaClient) {
  var client = new MoussakaClient(opts);
});
  • Just use it as a global on the window object
<script src="/path/to/moussaka-client.js"></script>
var client = new MoussakaClient(opts);
  • You could also just use the npm module in node and use Browserify to build your node application for the browser.

Log Level

By passing in a logLevel option you can control the detail of the log messages. The log levels are as follows:

  • trace: 0
  • info: 1
  • warning: 2
  • error: 3
  • exception: 4

For example, to see only messages that are errors or exceptions, you would pass { logLevel: 3 } to the MoussakaClient constructor.

0.1.9

9 years ago

0.1.8

9 years ago

0.1.7

9 years ago

0.1.6

9 years ago

0.1.2

10 years ago

0.1.1

10 years ago

0.1.0

10 years ago