SimpleKeeper

Zookeeper-like distributed server, WIP.

Installation

Via npm on Node:

npm install simplekeeper

Usage

Reference in your program:

var simplekeeper = require('simplekeeper');

In the current version (0.0.1) only local server is implemented, with two flavors: synchronous and asynchronous.

Synchronous Server

Create a server

var server = simplekeeper.createSyncServer('simplekeeper');

Get value

var value = simplekeeper.getValue('/user/1/name');

Return null if path does not exist.

Set value

simplekeeper.setValue('/user/1/name', 'adam');
simplekeeper.setValue('/user/1/age', 800);

Get children

var names = simplekeeper.getChildren('/user/1'); // ['name', 'age']

Delete node (and its children, if any)

simplekeeper.delete('/user/1');

Exists node

simplekeeper.exists('/user/1'); // false after deletoin

Invalid path (throws exceptions)

simplekeeper.getValue(null);   // null
simplekeeper.getValue(123);    // not a string
simplekeeper.getValue('');     // empty string
simplekeeper.getValue('foo');  // it does not start with /

Asynchronous Server

Create a server

var server = simplekeeper.createServer('simplekeeper');

Its functions are the same of a synchronous server, but with a callback. I.e.: Get Value

var value = simplekeeper.getValue('/user/1/name', function (err, value) { ... } );

Development

git clone git://github.com/ajlopez/SimpleKeeper.git
cd SimpleKeeper
npm install
npm test

Samples

TBD

To do

• Samples
• Set Leader
• Distributed Server
• Invalid path when it ends with /

Versions

• 0.0.1: Published

Contribution

Feel free to file issues and submit pull requests � contributions are welcome.

If you submit a pull request, please be sure to add or update corresponding test cases, and ensure that npm test continues to pass.