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
- API
  
  Reference documentation for the pkg.go.dev API
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

ascache

package module

Go to main page

Versions in this module

v0

v0.3.0

Aug 3, 2026

Changes in this version

+ var ErrInvalidEpochRequests = errors.New("epoch requests must not be negative")

type Settings

+ EpochRequests int64

v0.2.0

Aug 3, 2026

Changes in this version

+ type EpochBandit interface

+ RecordEpoch func(report EpochReport)

+ type EpochReport struct

+ Active PolicyType

+ Capacity int

+ EpochID int64

+ SampleRate float64

+ Stats []ShadowStats

v0.1.1

Jul 26, 2026

Changes in this version

+ const DefaultMinShadowCapacity

+ var ErrDuplicatePolicy = errors.New("duplicate policy type")

+ var ErrEmptyPolicies = errors.New("must provide non zero policies size")

+ var ErrInvalidEpochDuration = errors.New("epoch duration must be positive")

+ var ErrNilBandit = errors.New("bandit must not be nil")

+ var ErrNilPolicy = errors.New("policy must not be nil")

+ var ErrNilSettings = errors.New("settings must not be nil")

+ type AdaptiveCache struct

+ func NewAdaptiveCache[K comparable, V any](policies []Policy[K, V], bandit Bandit, settings *Settings) (*AdaptiveCache[K, V], error)

+ func (c *AdaptiveCache[K, V]) ActivePolicy() PolicyType

+ func (c *AdaptiveCache[K, V]) Add(key K, value V) bool

+ func (c *AdaptiveCache[K, V]) Advice() Advice

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

+ func (c *AdaptiveCache[K, V]) Contains(key K) bool

+ func (c *AdaptiveCache[K, V]) Get(key K) (V, bool)

+ func (c *AdaptiveCache[K, V]) Keys() []K

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

+ func (c *AdaptiveCache[K, V]) Peek(key K) (value V, ok bool)

+ func (c *AdaptiveCache[K, V]) Purge()

+ func (c *AdaptiveCache[K, V]) Remove(key K) bool

+ func (c *AdaptiveCache[K, V]) Resize(size int) int

+ func (c *AdaptiveCache[K, V]) Stats() GlobalStats

+ func (c *AdaptiveCache[K, V]) Values() []V

+ type Advice struct

+ Active PolicyType

+ Best PolicyType

+ Epochs int64

+ Improvement float64

+ Reports []PolicyReport

+ SampleRate float64

+ Sampled bool

+ func (a Advice) String() string

+ type Bandit interface

+ RecordStats func(stats ShadowStats)

+ SelectPolicy func() PolicyType

+ type CacheStats interface

+ GetStats func() PolicyStats

+ ResetStats func()

+ type CacheWrapper struct

+ func NewCache[K comparable, V any](cache Cacher[K, V], policy PolicyType, size int) *CacheWrapper[K, V]

+ func (c *CacheWrapper[K, V]) Cap() int

+ func (c *CacheWrapper[K, V]) Get(key K) (value V, ok bool)

+ func (c *CacheWrapper[K, V]) GetStats() PolicyStats

+ func (c *CacheWrapper[K, V]) GetType() PolicyType

+ func (c *CacheWrapper[K, V]) Name() string

+ func (c *CacheWrapper[K, V]) ResetStats()

+ func (c *CacheWrapper[K, V]) Resize(size int) int

+ type Cacher interface

+ Add func(key K, value V) (evicted bool)

+ Contains func(key K) bool

+ Get func(key K) (value V, ok bool)

+ Keys func() []K

+ Len func() int

+ Peek func(key K) (value V, ok bool)

+ Purge func()

+ Remove func(key K) (present bool)

+ Resize func(size int) (evicted int)

+ Values func() []V

+ type GlobalStats struct

+ Hits int64

+ Misses int64

+ type MigrationStrategy uint

+ const MigrationCold

+ const MigrationGradual

+ const MigrationWarm

+ type Policy interface

+ Cap func() int

+ GetType func() PolicyType

+ type PolicyReport struct

+ Active bool

+ Hits int64

+ Misses int64

+ Policy PolicyType

+ func (r PolicyReport) HitRate() float64

+ type PolicyStats struct

+ Hits int64

+ Misses int64

+ type PolicyType uint

+ const ARC

+ const LFU

+ const LRU

+ const Random

+ const TTL

+ const TinyLFU

+ const TwoQueue

+ const Undefined

+ func (i PolicyType) String() string

+ type Settings struct

+ EpochDuration time.Duration

+ EvictPartialCapacityFilling bool

+ MigrationStrategy MigrationStrategy

+ MinEpochRequests int64

+ MinHitRateImprovement float64

+ MinShadowCapacity int

+ ObserveOnly bool

+ ShadowSampleRate float64

+ SwitchCooldownEpochs int64

+ type ShadowStats struct

+ Hits int64

+ Misses int64

+ Policy PolicyType

v0.1.0

Jul 26, 2026