Dead simple data store. In-memory with persistence to file.
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.
npm install dsds --save
var dsds = require'dsds';
Creates a new data store with the name
name. If you call
the same name again, you will get the cached object so you can access
the same store from different parts of your code.
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: true
autoPersist: Boolean: Whether the data should be automatically persisted on every write operation. Default: true. You can manually call
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';
Returns the object with the ID
var ryu = storeget'ce4c05cd-00fc-410d-9f17-209b543e232f';
Returns an array containing all records.
var fighters = storeall;
data in to the store. And resturns the new object. A unique ID
will be added to the property defined in
var ryu = storeinsertname: 'Ryu'gender: 'male'country: 'Japan'height: 175;console.logryuid;
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 = storeupdateidheight: 187eyeColor: 'brown';
Replaces a record and returns the new record. Leaves the ID intact.
var id = 'ce4c05cd-00fc-410d-9f17-209b543e232f';var evilRyu = storereplaceidname: 'Evil Ryu'gender: 'male'country: 'Japan'height: 175rival: 'Sagat';
Deletes the record with ID
var id = 'ce4c05cd-00fc-410d-9f17-209b543e232f';storeremoveid;
Returns an array of all records that pass the test in
filter function internally.
var females = storefindreturn fightergender == 'female';;
store.find but returns only the first record. Uses lodash's
find function internally.
Writes all records to disc. You don't have to call this manually unless
you have set
Loads the data from
options.filePath. You don't have to call this
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.