lightcache

A lightweight but full-featured Go key-value local memory cache.
Data management and some code are inspired by bigcache, persistence is inspired by Redis AOF.
It's an initial version so far, some features may not meet expectations.

Features(Expected)

• Lightweight.
• Fast enough.
• Thread safe.
• Enable TTL(Time-to-live).
• Customizable TTL for each item.
• Customizable capacity(the maximum number of items allowed in cache).
• Customizable maximum memory usage.
• Simple API.
• Simple source code.
• Data persistence by WAL(write ahead log).
• Compressible WAL(developing...)

QuickStart

Installation

go get github.com/guanhonly/lightCache

Usage

// create lightCache with default config, which
// has permanent ttl and persistence is not enabled.
cache := DefaultCacheBuilder().Build()

// set key value without customized ttl(use global ttl).
cache.Set("key", []byte("value"))

// set key value with customized ttl.
cache.SetWithTTL("key", []byte("value"), 3*60*60)

// get value through key and check if hit cache.
value, hit := cache.Get("key")

// delete key from cache.
cache.Delet("key")

Limitations

• Keys must be string and values must be bytes. Other types must be marshaled to bytes to store in cache.
• Callback function for expiration is not supported, which many other caches did. This is for light weight.
• Atomicity and transaction are not supported.