JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 277
  • Score
    100M100P100Q121209F
  • License MIT

A simple on-disk cache, supporting local and remote filesystem targets, with time based expiration policies.

Package Exports

  • simple-on-disk-cache
  • simple-on-disk-cache/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (simple-on-disk-cache) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

simple-on-disk-cache

ci_on_commit deploy_on_tag

A simple on-disk cache, supporting local and remote filesystem targets, with time based expiration policies.

Install

npm install --save simple-on-disk-cache

Example

locally mounted

You can easily get and set to a cache persisted in a locally mounted filesystem

import { createCache } from 'simple-on-disk-cache';

const { set, get } = createCache({
  directoryToPersistTo: {
    mounted: {
      path: `${__dirname}/tmp`,
    }
  },
});
set('meaning-of-life', '42');
const meaningOfLife = get('meaning-of-life'); // returns 42

aws s3

You can also easily get and set from a cache persisted in an aws s3 fileystem

import { createCache } from 'simple-on-disk-cache';

const { set, get } = createCache({
  directoryToPersistTo: {
    s3: {
      bucket: '__bucket_name__',
      prefix: '__prefix__',
    }
  },
});
set('meaning-of-life', '42');
const meaningOfLife = get('meaning-of-life'); // returns 42

default expiration

Items in the cache live 5 minutes until expiration, by default.

You can change this default when creating the cache:

const { set, get } = createCache({ defaultSecondsUntilExpiration: 10 * 60 }); // updates the default seconds until expiration to 10 minutes

per item expiration

And you can also override this when setting an item:

set('acceleration due to gravity', '9.81', { secondsUntilExpiration: Infinity }); // gravity will not change, so we dont need to expire it