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

cache

package

Go to main page

Versions in this module

v0

v0.3.0

May 26, 2026

Changes in this version

+ type Codec interface

+ Decode func([]byte) (V, error)

+ Encode func(V) ([]byte, error)

+ type JSONCodec struct

+ func (JSONCodec[V]) Decode(b []byte) (V, error)

+ func (JSONCodec[V]) Encode(v V) ([]byte, error)

+ type Namespaced struct

+ func NewNamespaced[V any](inner Cache[V], prefix string) *Namespaced[V]

+ func (n *Namespaced[V]) Clear(ctx context.Context) error

+ func (n *Namespaced[V]) Delete(ctx context.Context, key string) error

+ func (n *Namespaced[V]) Get(ctx context.Context, key string) (V, error)

+ func (n *Namespaced[V]) GetOrLoad(ctx context.Context, key string, ttl time.Duration, ...) (V, error)

+ func (n *Namespaced[V]) Set(ctx context.Context, key string, value V, ttl time.Duration) error

+ type Redis struct

+ func NewRedis[V any](client redis.UniversalClient, opts ...RedisOption[V]) *Redis[V]

+ func (r *Redis[V]) Clear(ctx context.Context) error

+ func (r *Redis[V]) Delete(ctx context.Context, key string) error

+ func (r *Redis[V]) Get(ctx context.Context, key string) (V, error)

+ func (r *Redis[V]) GetOrLoad(ctx context.Context, key string, ttl time.Duration, ...) (V, error)

+ func (r *Redis[V]) Set(ctx context.Context, key string, value V, ttl time.Duration) error

+ type RedisOption func(*Redis[V])

+ func WithCodec[V any](c Codec[V]) RedisOption[V]

+ func WithKeyPrefix[V any](prefix string) RedisOption[V]

+ type Tiered struct

+ L1TTL time.Duration

+ OnL1Error func(op string, err error)

+ func NewTiered[V any](l1, l2 Cache[V]) *Tiered[V]

+ func (t *Tiered[V]) Clear(ctx context.Context) error

+ func (t *Tiered[V]) Delete(ctx context.Context, key string) error

+ func (t *Tiered[V]) Get(ctx context.Context, key string) (V, error)

+ func (t *Tiered[V]) GetOrLoad(ctx context.Context, key string, ttl time.Duration, ...) (V, error)

+ func (t *Tiered[V]) Set(ctx context.Context, key string, value V, ttl time.Duration) error

v0.1.2

May 25, 2026

v0.1.1

May 25, 2026

Changes in this version

+ var ErrMiss = errors.New("cache: miss")

+ type Cache interface

+ Clear func(ctx context.Context) error

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

+ Get func(ctx context.Context, key string) (V, error)

+ GetOrLoad func(ctx context.Context, key string, ttl time.Duration, ...) (V, error)

+ Set func(ctx context.Context, key string, value V, ttl time.Duration) error

+ type Memory struct

+ func NewMemory[V any]() *Memory[V]

+ func (m *Memory[V]) Clear(_ context.Context) error

+ func (m *Memory[V]) Delete(_ context.Context, key string) error

+ func (m *Memory[V]) Get(ctx context.Context, key string) (V, error)

+ func (m *Memory[V]) GetOrLoad(ctx context.Context, key string, ttl time.Duration, ...) (V, error)

+ func (m *Memory[V]) Len() int

+ func (m *Memory[V]) Set(ctx context.Context, key string, value V, ttl time.Duration) error

+ func (m *Memory[V]) SetClock(now func() time.Time)