cp

cacheman-promise

cacheman library with a promise interface

Showing:

Popularity

Downloads/wk

60

GitHub Stars

4

Maintenance

Last Commit

5yrs ago

Contributors

1

Package

Dependencies

4

License

MIT

Type Definitions

Tree-Shakeable

No?

Categories

Readme

Cacheman-Promise

NPM version Downloads Build Status Dependency Status Coverage Status

NPM

Cacheman library with a promise interface.

Installation

$ npm install --save cacheman-promise

Usage

Cacheman-promise only support set, get, del, clear, pull and wrap promise interface.

Cacheman([name, [options]])

Please refer to Cacheman Options API

var Cacheman = require('cacheman-promise');

var options = {
  ttl: 90,
  engine: 'redis',
  port: 9999,
  host: '127.0.0.1'
};

var cache = new Cacheman('todo', options);
// or
var cache = new Cacheman(options);

cache.set(key, value, [ttl, [fn]])

Usage:

var key = 'foo';
var data = 'bar';

cache.set(key, {name: data})
  .then(function(val){
    // output "{name: 'bar'}"
    console.log(val);
  });

cache.get(key, fn)

You can pass array or string as key.

Usage:


cache.set('foo', 'bar');

cache.get('foo')
  .then(function(val){
    // output "bar"
    console.log(val);
  });

pass array as multiple keys

Usage:


cache.set('foo', 1);
cache.set('bar', 2);

cache.get(['foo', 'bar'])
  .then(function(result){
    // output {"foo": 1, "bar": 2}
    console.log(result);
  });

cache.pull(key, default)

If you need to retrieve an item from the cache and then delete it, you may use the pull method. Like the get method, null will be returned if the item does not exist in the cache.

cache.set('foo', 'bar');

cache.pull('foo')
  .then(function(result){
    // output 'bar'
    console.log(result);
  }).then(function() {
    return cache.get('foo');
  }).then(function(result) {
    // output 'null'
    console.log(result);
  });

You can pass default value as second paramaeter if the item doesn't exist in the cache.

// make sure `foo` cache doesn't exist.
cache.del('foo');

cache.pull('foo', 'bar')
  .then(function(result){
    // output 'bar'
    console.log(result);
  });

cache.del(key, [fn])

You can pass array or string as key.

Usage:

cache.del('foo')
  .then(function(){
    console.log('foo was deleted');
  });

or

cache.del(['foo', 'bar'])
  .then(function(){
    console.log('foo and bar was deleted');
  });

Clear some items with prefix name:

cache.clear('foo*')
  .then(function(){
    console.log('clear cache with `foo` prefix name like `foo1`, `foo2` etc.');
  });

cache.clear([fn])

Clear all cache as follwoing:

cache.clear()
  .then(function(){
    console.log('cache is now clear');
  });

cache.wrap(key, default, [ttl, [fn]])

Wraps a function in cache. I.e., the first time the function is run, its results are stored in cache so subsequent calls retrieve from cache instead of calling the function.

var key = 'foo';
var data = 'bar';

cache.wrap(key, data)
  .then(function(val) {

    // get foo key from cache
    return cache.get(key);
  }).then(function(val) {

    // output 'bar'
    console.log(val);
  });

Run tests

$ npm test

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100
No reviews found
Be the first to rate

Alternatives

No alternatives found

Tutorials

No tutorials found
Add a tutorial