cache

Dec 9, 2025

Changes in this version

+ var ErrFailedToCreateZeroValue = errors.New("failed to create zero item")

+ type Item interface

+ Marshal func() ([]byte, error)

+ Unmarshal func(data []byte) error

+ type Typed struct

+ func NewTyped[T Item](storage Cache) *Typed[T]

+ func (c *Typed[T]) Cleanup(ctx context.Context) error

+ func (c *Typed[T]) Close() error

+ func (c *Typed[T]) Delete(ctx context.Context, key string) error

+ func (c *Typed[T]) Drain(ctx context.Context) (map[string]T, error)

+ func (c *Typed[T]) Get(ctx context.Context, key string, opts ...GetOption) (T, error)

+ func (c *Typed[T]) GetAndDelete(ctx context.Context, key string) (T, error)

+ func (c *Typed[T]) Set(ctx context.Context, key string, value T, opts ...Option) error

+ func (c *Typed[T]) SetOrFail(ctx context.Context, key string, value T, opts ...Option) error

Nov 27, 2025

Changes in this version

+ var ErrInvalidConfig = errors.New("invalid config")

+ type MemoryCache struct

+ func (m *MemoryCache) Cleanup(_ context.Context) error

+ func (m *MemoryCache) Close() error

+ func (m *MemoryCache) Delete(_ context.Context, key string) error

+ func (m *MemoryCache) Drain(_ context.Context) (map[string][]byte, error)

+ func (m *MemoryCache) Get(_ context.Context, key string, opts ...GetOption) ([]byte, error)

+ func (m *MemoryCache) GetAndDelete(ctx context.Context, key string) ([]byte, error)

+ func (m *MemoryCache) Set(_ context.Context, key string, value []byte, opts ...Option) error

+ func (m *MemoryCache) SetOrFail(_ context.Context, key string, value []byte, opts ...Option) error

+ type RedisCache struct

+ func (r *RedisCache) Cleanup(_ context.Context) error

+ func (r *RedisCache) Close() error

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

+ func (r *RedisCache) Drain(ctx context.Context) (map[string][]byte, error)

+ func (r *RedisCache) Get(ctx context.Context, key string, opts ...GetOption) ([]byte, error)

+ func (r *RedisCache) GetAndDelete(ctx context.Context, key string) ([]byte, error)

+ func (r *RedisCache) Set(ctx context.Context, key string, value []byte, opts ...Option) error

+ func (r *RedisCache) SetOrFail(ctx context.Context, key string, value []byte, opts ...Option) error

Oct 28, 2025

Changes in this version

type Cache

+ Close func() error

+ type RedisConfig struct

+ Client *redis.Client

+ Prefix string

+ TTL time.Duration

+ URL string

Oct 22, 2025

Changes in this version

+ type GetOption func(*getOptions)

+ func AndDefaultTTL() GetOption

+ func AndDelete() GetOption

+ func AndSetTTL(ttl time.Duration) GetOption

+ func AndSetValidUntil(validUntil time.Time) GetOption

+ func AndUpdateTTL(ttl time.Duration) GetOption

Sep 24, 2025

Changes in this version

+ var ErrKeyExists = errors.New("key already exists")

+ var ErrKeyExpired = errors.New("key expired")

+ var ErrKeyNotFound = errors.New("key not found")

+ type Cache interface

+ Cleanup func(ctx context.Context) error

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

+ Drain func(ctx context.Context) (map[string]string, error)

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

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

+ Set func(ctx context.Context, key string, value string, opts ...Option) error

+ SetOrFail func(ctx context.Context, key string, value string, opts ...Option) error

+ func NewMemory(ttl time.Duration) Cache

+ func NewRedis(client *redis.Client, prefix string, ttl time.Duration) Cache

+ type Option func(*options)

+ func WithTTL(ttl time.Duration) Option

+ func WithValidUntil(validUntil time.Time) Option