Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Redis storage backend for Cachetree
JavaScript
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
test
.gitignore
.travis.yml
LICENSE
README.md
index.js
package.json

README.md

cachetree-redis Build Status

A Redis storage backend for Cachetree.

Installation

npm install cachetree-redis

Usage

To create a Cachtree instance using a Redis storage backend:

var cachetreeRedis = require('cachetree-redis'),
    cachetree = require('cachetree),
    store = cachetreeRedis(),
    cache = cachetree(store);

The cachetree-redis module exports a single constructor function that accepts an optional options object and returns a Redis storage backend instance.

cachetreeRedis(options)

  • options: An object containing the following configuration options:
    • client: Redis client instance. If provided, port, host, options, pw and db are ignored
    • port: Redis server port
    • host: Redis server host
    • options: Redis client options passed to redis.createClient
    • pw: Password for authenticating with Redis
    • pass: Alias for pw, if you're not a fan of the whole brevity thing
    • password: Alias for pw, same as pass
    • db: Number of the database to select
    • database: Alias for db
    • delimiter: Redis key delimiter, defaults to :
    • autoCast: Automatically stringify and parse values, defaults to true

The returned store exposes the underlying Redis client through a property named client.

Running Tests

cachetree-redis tests require Mocha and can be run with either npm test or make test. You can specify Mocha options, such as the reporter, by adding a mocha.opts file, which is ignored by git, to the test directory.

By default, the test suite uses fakeredis to mock a Redis server. To run the tests against an actual Redis server, add a JSON file named options.json to the test directory. This file should contain the options to be passed to the cachetree-redis constructor function. Like the mocha.opts file, options.json is ignored by git.

Something went wrong with that request. Please try again.