Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

bdcache

package module

Go to main page

Versions in this module

v0

v0.6.1

Nov 21, 2025

v0.6.0

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

v0.5.0

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