Skip to content

DistributedWeb/ddatabase-cache

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ddatabase-cache

Build Status

A caching module for dDatabase tree nodes and blocks.

This module mplements the hashlru algorithm internally for LRU caching, but it uses byte length estimates instead of the entry count for eviction.

Installation

npm i ddatabase-cache --save

API

const cache = new DdatabaseCache(opts = {})

Creates a new cache.

Options can include:

{
  maxByteSize: 1e6,  // The soft maximum size of the cache (actual max size can go up to 2x this value).
  estimateSize: val => { ... },  // A function from a value to its size estimate.
  onEvict: (evicted) => { ... }  // A hook that's called when stale entries (a Map) have been evicted.
}

cache.set(key, value)

Sets key to value.

cache.get(key)

Gets the value for key.

cache.del(key)

Deletes key from the cache.

const subCache = cache.namespace()

Creates a namespaced sub-cache which mirrors the ddatabase-cache API.

This is useful if you want to create a single cache instance that manages resources for multiple dWebCores.

License

MIT