abcdan / cachu

🦝 Simple, Minimalistic KV Cache

cachu

Simple, minimalistic key-value cache, created by Azury.

Why should you use cachu?

• fully asynchronous
• small n' easy
• zero dependencies

Installation

Install the Package

Install it using your favorite package manager.

npm i cachu
yarn add cachu
pnpm add cachu

Create New Instance

Just create a new instance, it's as easy as that!

import { Cachu } from 'cachu'

const cache = new Cachu({
  maxAmount: 10, // cache can contain up to 10 items
  maxAge: 60 // delete items after a minute
})

const demo = async () => {
  await cache.set(123, 'hello world')
  console.log(await cache.get(123))
}
demo()

API

Configuration

• maxAge to set the maximum age for each item in the store
• maxAmount to set the maximum size for the store

Features

• set(key, value)
• get(key)
• update(key, value)
• view(key)
• purge(key)
• steal(key)
• has(key)
• prune()
• destroy()
• purgeMany(keys)
• getMany(keys)
• stealMany(keys)
• getAmountOfItems()
• getManyByCondition(condition)
• purgeManyByCondition(condition)
• getValuesOfItems()
• getKeysOfItems()
• each(action)