bdcache

Dec 4, 2025

Changes in this version

type MemoryCache

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

Dec 3, 2025

Changes in this version

+ 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)

type Option

+ func WithSize(n int) Option

+ func WithTTL(d time.Duration) Option

+ 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)

+ 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

Dec 2, 2025

Changes in this version

type PersistenceLayer

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

Dec 1, 2025

Changes in this version

type Cache

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

type PersistenceLayer

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

Nov 21, 2025

Changes in this version

type Cache

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

type Option

+ func WithCleanup(maxAge time.Duration) Option

+ func WithPersistence[K comparable, V any](p PersistenceLayer[K, V]) Option

type Options

+ CleanupEnabled bool

+ CleanupMaxAge time.Duration

+ Persister any

type PersistenceLayer

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

+ Location func(key K) string

Nov 20, 2025

Changes in this version

+ type Cache struct

+ func New[K comparable, V any](ctx context.Context, options ...Option) (*Cache[K, V], error)

+ func (c *Cache[K, V]) Cleanup() int

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

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

+ func (c *Cache[K, V]) Get(ctx context.Context, key K) (value V, found bool, err error)

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

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

+ type Entry struct

+ Expiry time.Time

+ Key K

+ UpdatedAt time.Time

+ Value V

+ type Option func(*Options)

+ func WithBestStore(cacheID string) Option

+ func WithCloudDatastore(cacheID string) Option

+ func WithDefaultTTL(d time.Duration) Option

+ func WithLocalStore(cacheID string) Option

+ func WithMemorySize(n int) Option

+ func WithWarmup(n int) Option

+ type Options struct

+ CacheID string

+ DefaultTTL time.Duration

+ MemorySize int

+ UseDatastore bool

+ WarmupLimit int

+ type PersistenceLayer interface

+ Close func() error

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

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

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

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

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

+ ValidateKey func(key K) error