node package manager

seneca-mem-store

Seneca in-memory data storage plugin.

Seneca

A Seneca.js data storage plugin.

seneca-mem-store

npm version Build Status Dependency Status Coveralls Gitter

Description

This module is a plugin for the Seneca framework. It provides an in-memory storage engine that provides a set of data storage action patterns. Data does not persist betweens runs. This plugin is most useful for early development and unit testing. It also provides an example of a document-oriented storage plugin code-base.

The Seneca framework provides an ActiveRecord-style data storage API. Each supported database has a plugin, such as this one, that provides the underlying Seneca plugin actions required for data persistence.

This plugin is included with the main seneca module by default.

  • Node: 0.10, 0.12, 4, 5, 6

seneca-mem-store's source can be read in an annotated fashion by,

  • running npm run annotate
  • viewing online.

The annotated source can be found locally at ./doc/seneca-mem-store.html.

If you're using this module, and need help, you can:

If you are new to Seneca in general, please take a look at senecajs.org. We have everything from tutorials to sample apps to help get you up and running quickly.

Seneca compatibility

Supports Seneca versions 1.x - 3.x

Install

This plugin module is included in the main Seneca module.

npm install seneca

Explicit install

To explicitly install separately,

npm install seneca-mem-store

And in your code:

var seneca = require('seneca')({
  default_plugins: {
    'mem-store': false
  }
})
 
seneca.use(require('seneca-mem-store'))

Quick Example

var seneca = require('seneca')()
 
// Since mem-store is a default plugin, it does not need to be 
// added with .use(). You can just go ahead and use it. 
seneca.ready(function () {
  var apple = seneca.make$('fruit')
  apple.name = 'Pink Lady'
  apple.price = 0.99
 
  apple.save$(function (err, apple) {
    console.log("apple.id = " + apple.id)
  })
})

Usage

You don't use this module directly. It provides an underlying data storage engine for the Seneca entity API:

var entity = seneca.make$('typename')
entity.someproperty = "something"
entity.anotherproperty = 100
 
entity.save$(function (err, entity) { ... })
entity.load$({id: ... }, function (err, entity) { ... })
entity.list$({property: ... }, function (err, entity) { ... })
entity.remove$({id: ... }, function (err, entity) { ... })

Query Support

The standard Seneca query format is supported:

  • .list$({f1:v1, f2:v2, ...}) implies pseudo-query f1==v1 AND f2==v2, ....

  • .list$({f1:v1,...}, {sort$:{field1:1}}) means sort by f1, ascending.

  • .list$({f1:v1,...}, {sort$:{field1:-1}}) means sort by f1, descending.

  • .list$({f1:v1,...}, {limit$:10}) means only return 10 results.

  • .list$({f1:v1,...}, {skip$:5}) means skip the first 5.

  • .list$({f1:v1,...}, {fields$:['fd1','f2']}) means only return the listed fields.

Note: you can use sort$, limit$, skip$ and fields$ together.

Native Driver

This store is an in memory store and as such does not require the need of a native driver.

Contributing

The Senecajs org encourages open participation. If you feel you can help in any way, be it with documentation, examples, extra testing, or new features please get in touch.

Test

To run tests, simply use npm:

npm run test

License

Copyright (c) 2015-2016, Richard Rodger and other contributors. Copyright (c) 2010-2014, Richard Rodger. Licensed under MIT.