JSPM

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

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

Package Exports

    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