cabinetkv

Brainless Key/Value storage for MongoDB

npm install cabinetkv
2 downloads in the last week
4 downloads in the last month

Cabinet

Brainless Key/Value storage for MongoDB

Cabinet is a tiny module built on top of Cellar (itself built on top of Mongoose) for a simple Key/Value store.

Installation

Through NPM

$ npm install cabinetkv

or using Git

$ git clone git://github.com/treygriffith/cabinet.git node_modules/cabinetkv/

API/How to Use

Instantiate Cabinet with a collection name, and mongoDB details or a Mongoose instance

Cabinet = require('cabinetkv');

// with Mongoose instance

var mongoose = require('mongoose');
var mongoUrl = 'mongodb://' + db.user + ':' + db.pass + '@' + db.host + ':' + db.port + '/' + db.name;
mongoose.connect(mongoUrl);

var cabinet = new Cabinet('mykvstore', mongoose, {maxAge:3})


// with mongoDB details (maxAge of -1 stores docs forever)

var cabinet = new Cabinet('mykvstore', {user:db.user, pass:db.pass, host:db.host, port:db.port, name:db.name}, {maxAge:-1});

Cabinet exposes 2 methods:

  1. set - Store a value

    ``` javascript // Store a value with a specific key cabinet.set('mykey', 'myvalue', function(err, key) { if(err) {

     console.error(err);
     return;
    

    } console.log(key); // prints 'mykey' });

    // Store a value with a randomly generated key cabinet.set('myvalue', function(err, key) { if(err) {

     console.error(err);
     return;
    

    } console.log(key); // prints a random 16 character string });

  2. get - Retrieve a value

    ``` javascript cabinet.get('mykey', function(err, val) { if(err) {

     console.error(err);
     return;
    

    } console.log(val); // prints 'myvalue' });

npm loves you