altoque

A dead-simple cache for simple apps

Usage no npm install needed!

<script type="module">
  import altoque from 'https://cdn.skypack.dev/altoque';
</script>

README

Al toque Build Status

A simple, persistent cache for dead-simple apps.

Install

$ yarn add altoque
# or npm i altoque

Usage

import Cache from 'altoque'
// or const Cache = require('altoque')

// Cache(<Boolean saveFile>, <String filename>)
// e.g const cache = Cache()
// or const cache = require('altoque')()
const cache = Cache(true, './cache.json')

cache.set('hello', 'there')
cache.get('hello') // there

cache.del('hello')
cache.get('hello') // undefined

cache.set('🌚', '🌝', 2) // save for 2 seconds
cache.get('🌚', true) // { val: 🌝, expires: 1535065557820 }

setTimeout(() => cache.get('🌚'), 1000) // 🌝 
setTimeout(() => cache.get('🌚'), 1000) // undefined

API

Note: All methods are synchronous.

Cache.set(key, value)

Returns an object: { val: <value>, expires: <ms> }.

  • key: string
  • value: string | any serializable object

Cache.get(key, showExpire)

Returns the entry value.

When showExpire is true, it returns an object: { val: <value>, expires: <ms> }.

  • key: string
  • showExpire: boolean

Cache.del(key)

  • key: string

Test

$ yarn test

License

MIT