sfcache

Dec 8, 2025

Changes in this version

+ type Store interface

+ Cleanup func(ctx context.Context, maxAge time.Duration) (int, error)

+ Close func() error

+ Delete func(ctx context.Context, key K) error

+ Flush func(ctx context.Context) (int, error)

+ Get func(ctx context.Context, key K) (V, time.Time, bool, error)

+ Len func(ctx context.Context) (int, error)

+ LoadRecent func(ctx context.Context, limit int) (<-chan Entry[K, V], <-chan error)

+ Location func(key K) string

+ Set func(ctx context.Context, key K, value V, expiry time.Time) error

+ ValidateKey func(key K) error

Dec 8, 2025

Changes in this version

type MemoryCache

+ func (c *MemoryCache[K, V]) GetSet(key K, loader func() (V, error), ttl ...time.Duration) (V, error)

type TieredCache

+ func (c *TieredCache[K, V]) GetSet(ctx context.Context, key K, loader func(context.Context) (V, error), ...) (V, error)

Dec 5, 2025

Changes in this version

type MemoryCache

+ func New[K comparable, V any](opts ...Option) *MemoryCache[K, V]

type Option

+ func Size(n int) Option

+ func TTL(d time.Duration) Option

+ type TieredCache struct

+ Store persist.Store[K, V]

+ func NewTiered[K comparable, V any](store persist.Store[K, V], opts ...Option) (*TieredCache[K, V], error)

+ func (c *TieredCache[K, V]) Close() error

+ func (c *TieredCache[K, V]) Delete(ctx context.Context, key K) error

+ func (c *TieredCache[K, V]) Flush(ctx context.Context) (int, error)

+ func (c *TieredCache[K, V]) Get(ctx context.Context, key K) (V, bool, error)

+ func (c *TieredCache[K, V]) Len() int

+ func (c *TieredCache[K, V]) Set(ctx context.Context, key K, value V, ttl ...time.Duration) error

+ func (c *TieredCache[K, V]) SetAsync(ctx context.Context, key K, value V, ttl ...time.Duration) error

Dec 4, 2025

Changes in this version

+ type Entry struct

+ Expiry time.Time

+ Key K

+ UpdatedAt time.Time

+ Value V

+ type MemoryCache struct

+ func Memory[K comparable, V any](opts ...Option) *MemoryCache[K, V]

+ func (*MemoryCache[K, V]) Close()

+ func (c *MemoryCache[K, V]) Delete(key K)

+ func (c *MemoryCache[K, V]) Flush() int

+ func (c *MemoryCache[K, V]) Get(key K) (V, bool)

+ func (c *MemoryCache[K, V]) GetOrSet(key K, loader func() V, ttl ...time.Duration) V

+ func (c *MemoryCache[K, V]) Len() int

+ func (c *MemoryCache[K, V]) Set(key K, value V, ttl ...time.Duration)

+ func (c *MemoryCache[K, V]) SetIfAbsent(key K, value V, ttl ...time.Duration) (V, bool)

+ type Option func(*config)

+ func WithGhostRatio(r float64) Option

+ func WithSize(n int) Option

+ func WithSmallRatio(r float64) Option

+ func WithTTL(d time.Duration) Option

+ func WithWarmup(n int) Option

+ type PersistenceLayer interface

+ Cleanup func(ctx context.Context, maxAge time.Duration) (int, error)

+ Close func() error

+ Delete func(ctx context.Context, key K) error

+ Flush func(ctx context.Context) (int, error)

+ Len func(ctx context.Context) (int, error)

+ Load func(ctx context.Context, key K) (V, time.Time, bool, error)

+ LoadRecent func(ctx context.Context, limit int) (<-chan Entry[K, V], <-chan error)

+ Location func(key K) string

+ Store func(ctx context.Context, key K, value V, expiry time.Time) error

+ ValidateKey func(key K) error

+ type PersistentCache struct

+ Store PersistenceLayer[K, V]

+ func Persistent[K comparable, V any](ctx context.Context, p PersistenceLayer[K, V], opts ...Option) (*PersistentCache[K, V], error)

+ func (c *PersistentCache[K, V]) Close() error

+ func (c *PersistentCache[K, V]) Delete(ctx context.Context, key K) error

+ func (c *PersistentCache[K, V]) Flush(ctx context.Context) (int, error)

+ func (c *PersistentCache[K, V]) Get(ctx context.Context, key K) (V, bool, error)

+ func (c *PersistentCache[K, V]) GetOrSet(ctx context.Context, key K, loader func(context.Context) (V, error), ...) (V, error)

+ func (c *PersistentCache[K, V]) Len() int

+ func (c *PersistentCache[K, V]) Set(ctx context.Context, key K, value V, ttl ...time.Duration) error

+ func (c *PersistentCache[K, V]) SetAsync(ctx context.Context, key K, value V, ttl ...time.Duration) error