cpdb

0.1.4 • Public • Published

cpdb - crazy pili's database

  1. Introduction
  2. Features
  3. Requirements
  4. Example Code
  5. Maintenance
  6. Tests
  7. Contact

Introduction

cpdb is a NoSQL database for node.js.


Features

  • Stores key / values pairs persistent in the file system
  • Supports transactions
  • Generate unique keys

Requirements

  • DB keys must be strings
  • DB values must be serializable using JSON.stringify and JSON.parse

Example Code

Here's some example code which stores values in a database:

var db = require('cpdb').DB('path/to/my/db/directory');

var trans = db.newTransaction(); trans.set('key', { value: 'hello world!' }); if(somethingWentReallyBad){ trans.rollback(); } else{ trans.commit(function(){ // success console.log('Data stored'); }, function(e){ // error console.log('Error: ' + e); }); }

And some more code which retrieves values from the database:

var db = require('cpdb').DB('path/to/my/db/directory');

var readOnly = true; var trans = db.newTransaction(readOnly); trans.get('key', function(data){ // success if(data === undefined){ console.log('Nothing stored in DB'); } else{ console.log('Got ' + data); } }, function(e){ // error console.log('Error: ' + e); });


Maintenance

The database uses some temporary files and folders for implementing transactions. Sometimes these transaction data is not delete correctly. It is safe to manually clear the transaction data when all database instances are shut down.

To clear the transaction data remove the transactions directory below your database directory.


Tests

Execute the tests using make:

$ make test


Contact

/cpdb/

    Package Sidebar

    Install

    npm i cpdb

    Weekly Downloads

    0

    Version

    0.1.4

    License

    none

    Last publish

    Collaborators

    • marook