Plasma-cache NPM

plasma-cache

Object cache for Plasma.

Install

Install with npm

$ npm i plasma-cache --save

Install with bower

$ bower install plasma-cache --save

Usage

var PlasmaCache = require('plasma-cache');
var cache = new PlasmaCache();

API

PlasmaCache

Initialize a new PlasmaCache.

.plasma

Extend the data object with the value returned by plasma.

See the plasma documentation for all available options.

Params

data {Object|String|Array}: File path(s), glob pattern, or object of data.
options {Object}: Options to pass to plasma.

Example

cache
  .plasma({foo: 'bar'}, {baz: 'quux'});
  .plasma({fez: 'bang'});

.dataLoader

Params

ext {String}: The extension of files to read.
fn {String}: The loader function

Example

var fs = require('fs');
var yaml = require('js-yaml');

plasma.dataLoader('yml', function (fp) {
  var str = fs.readFileSync(fp, 'utf8');
  return yaml.safeLoad(str);
});

.process

Use expander to recursively expand template strings into their resolved values.

Params

lookup {*}: Any value to process, usually strings with a cache template, like <%= foo %> or ${foo}.
opts {*}: Options to pass to Lo-Dash _.template.

Example

cache.process({a: '<%= b %>', b: 'c'});
//=> {a: 'c', b: 'c'}

.flattenData

If a data property is on the given data object (e.g. data.data, like when files named data.json or data.yml are used), data.data is flattened to just data

Params

data {Object}
returns {Object}: Flattened object.

.extendData

Extend the cache.data object with the given data. This method is chainable.

returns {Object} PlasmaCache: to enable chaining

Example

cache
  .extendData({foo: 'bar'}, {baz: 'quux'});
  .extendData({fez: 'bang'});

.data

Extend the cache.data object with data from a JSON or YAML file, or by passing an object directly - glob patterns or file paths may be used.

Params

values {Object|Array|String}: Values to pass to plasma.
process {Boolean}: If true is passed as the last argumemnt data will
returns {Object} PlasmaCache: to enable chaining

Example

cache
  .data({a: 'b'})
  .data({c: 'd'});

console.log(cache);
//=> {data: {a: 'b', c: 'd'}}

cache.data('*.{json,yml}');
// or
cache.data('package.json');
//=> {name: 'plasma-cache', ...}

// process config templates
cache.data({a: '<%= b %>', b: 'z'})
//=> {data: {a: 'z', b: 'z'}}