cache

README

ttlcache

Cache library with configurable eviction policy, supported LFU and LRU.

Install

$ go get github.com/moeryomenko/ttlcache

License

ttlcache is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0).

See LICENSE-APACHE and/or LICENSE-MIT for details.

Documentation

Index

• Constants
• Variables
• type Cache
  • func NewCache(capacity int, policy evictionPolicy) Cache
• type LFUCache
  • func (c *LFUCache) Get(key string) (interface{}, error)
  • func (c *LFUCache) Set(key string, value interface{}, expiration time.Duration) error
• type LRUCache
  • func (c *LRUCache) Get(key string) (interface{}, error)
  • func (c *LRUCache) Set(key string, value interface{}, expiration time.Duration) error

Constants

const (
	// Discards the least recently used items first.
	LRU evictionPolicy = iota
	// Discards the least frequently used items first.
	LFU
)

Variables

var ErrNotFound = errors.New("key not found")

Types

type Cache

type Cache interface {
	// Set inserts or updates the specified key-value pair with an expiration time.
	Set(key string, value interface{}, expiry time.Duration) error
	// Get returns the value for specified key if it is present in the cache.
	Get(key string) (interface{}, error)
}

Cache is common interface of cache.

func NewCache

func NewCache(capacity int, policy evictionPolicy) Cache

NewCache returns cache with selected eviction policy.

type LFUCache

type LFUCache struct {
	// contains filtered or unexported fields
}

func (*LFUCache) Get

func (c *LFUCache) Get(key string) (interface{}, error)

Get returns the value for specified key if it is present in the cache.

func (*LFUCache) Set

func (c *LFUCache) Set(key string, value interface{}, expiration time.Duration) error

Set inserts or updates the specified key-value pair with an expiration time.

type LRUCache

type LRUCache struct {
	// contains filtered or unexported fields
}

func (*LRUCache) Get

func (c *LRUCache) Get(key string) (interface{}, error)

Get returns the value for specified key if it is present in the cache.

func (*LRUCache) Set

func (c *LRUCache) Set(key string, value interface{}, expiration time.Duration) error

Set inserts or updates the specified key-value pair with an expiration time.