hubdb

a github-powered database

Hubdb(options)

Create a new Hubdb instance. This is a database-like wrapper for a branch of a GitHub repository that treats JSON objects in that branch as documents.

Hubdb shines where GitHub itself makes sense: you can take advantage of GitHub's well-architected APIs and user permissions. A good example of hubdb in practice is in stickshift, where it powers a lightweight query storage for an analytics app.

Takes a configuration object with options:

• username the user's name of the repository. this is not necessary the user that's logged in.
• repo the repository name
• branch the branch of the repository to use as a database.
• token a GitHub token. You'll need to get this by OAuth'ing into GitHub or use an applicaton token.

Parameters

Example

var db = Hubdb({
 token: 'MY_TOKEN',
 username: 'mapbox',
 repo: 'hubdb',
 branch: 'db'
});
db.add({ grass: 'green' }, function() {
  db.list(function(err, res) {
    // [{
    //   path: '2e959f35c6022428943b9c96d974498d.json'
    //   data: { grass: 'green' }
    // }]
  });
});

list(callback)

List documents within this database. If successful, the given callback is called with an array of documents as { path: string, data: object } objects.

Parameters

add(data, callback)

Add a new object to the database. If successful, the callback is called with (err, res) in which res reveals the id internally chosen for this new item.

Parameters

remove(id, callback)

Remove an item from the database given its id and a callback.

Parameters

get(id, callback)

Get an item from the database given its id and a callback.

Parameters

update(id, data, callback)

Update an object in the database, given its id, new data, and a callback.

Parameters

Installation

Requires nodejs.

$ npm install hubdb

Tests

$ npm test