cache

type Cache ¶

type Cache[K ~string, V any] interface {
	Claimer[K, V]
	Set(key K, value V, ttl time.Duration) error
	Get(key K) (V, error)
	Remove(key ...K) error
	Pop(key K) (V, error)
	Keys(prefix K) []K
}

type CacheConfigFunc ¶

type CacheConfigFunc func(*config)

func AsyncSetter(value bool) CacheConfigFunc

func OnError(fn func(err error)) CacheConfigFunc

func TTL(duration time.Duration) CacheConfigFunc

type Claimer ¶ added in v0.11.0

type Claimer[K ~string, V any] interface {
	Add(key K, value V, ttl time.Duration) (bool, error)
}

Claimer is an optional capability for caches that can perform atomic set-if-absent. Backends that cannot provide this guarantee should not implement it.

Add inserts key→value only if the key is absent or expired. It returns true if this caller won the claim, false if another caller already holds an unexpired entry. Use this for deduplication or leader-election where a Get-then-Set sequence would race.