README
dsds
This is a Dead Simple Data Store for Node.js. It's an in-memory data store that automatically persists to file (unless you tell it not to). dsds does not care about speed, security, ACIDity and what not. It's meant for those experiments and quick scripts where you just want to store some data in the easiest and quickest way possible.
It uses synchronous functions just so that you don't have to write a callback.
Installation
npm install dsds --save
and then
var dsds = require('dsds');
API
store = dsds(name [, options])
Creates a new data store with the name name
. If you call dsds()
with
the same name again, you will get the cached object so you can access
the same store from different parts of your code.
Possible options:
idProperty
: String. This is the name of the property where the ID will be stored in. Default: "id";persistence
: Boolean. Whether the data should be persisted to file. Default: trueautoPersist
: Boolean: Whether the data should be automatically persisted on every write operation. Default: true. You can manually callstore.persist()
filePath
: String. Path to the file where the data should be persisted. Default:'./' + name + '.json'
. The directories will be automatically created if necessary.
var store = dsds('fighters', {
filePath: './data/fighters.json'
});
store.get(id)
Returns the object with the ID id
.
var ryu = store.get('ce4c05cd-00fc-410d-9f17-209b543e232f');
store.all()
Returns an array containing all records.
var fighters = store.all();
store.insert(data)
Inserts data
in to the store. And resturns the new object. A unique ID
will be added to the property defined in options.idProperty
(default:
"id").
var ryu = store.insert({
name: 'Ryu',
gender: 'male',
country: 'Japan',
height: 175
});
console.log(ryu.id);
ce4c05cd-00fc-410d-9f17-209b543e232f
store.update(id, data)
Updates a record and returns the updated record. data
will be merged
in to the existing record and leave the other properties intact.
var id = 'ce4c05cd-00fc-410d-9f17-209b543e232f';
var ryu = store.update(id, {
height: 187,
eyeColor: 'brown'
});
store.replace(id, data)
Replaces a record and returns the new record. Leaves the ID intact.
var id = 'ce4c05cd-00fc-410d-9f17-209b543e232f';
var evilRyu = store.replace(id, {
name: 'Evil Ryu',
gender: 'male',
country: 'Japan',
height: 175,
rival: 'Sagat'
});
store.remove(id)
Deletes the record with ID id
.
var id = 'ce4c05cd-00fc-410d-9f17-209b543e232f';
store.remove(id);
store.find(callback)
Returns an array of all records that pass the test in callback
. It
uses lodash's filter
function internally.
var females = store.find(function (fighter) {
return fighter.gender == 'female';
});
store.findOne(callback)
Same as store.find
but returns only the first record. Uses lodash's
find
function internally.
store.persist()
Writes all records to disc. You don't have to call this manually unless
you have set options.autoPersist
to false
.
store.persist();
store.load()
Loads the data from options.filePath
. You don't have to call this
manually.
store.load();
License
MIT License
Copyright (c) 2014 Max Kueng (http://maxkueng.com/)
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.