ldcache

type Cache[K Key, V Value] struct {
	// contains filtered or unexported fields
}

type CacheParams[K Key, V Value] struct {
	Type    CacheType     // default LRU
	Size    int           // default 10000
	Expires time.Duration // default never
	Loader  LoaderFunc[K, V]
}

type CacheType int

type Func[K Key, V Value] func(K, V)

type Key comparable

type LoaderFunc[K Key, V Value] func(context.Context, K) (V, error)

type LoadingCache[K Key, V Value] interface {
	SomeCache[K, V]

	// Get returns value associated with Key or call underlying LoaderFunc
	// to load value if it is not present.
	Get(context.Context, K) (V, error)
	// SetLoader changes the underlying loader func
	SetLoader(LoaderFunc[K, V])
	// Refresh loads new value for Key. If the Key already existed, the previous value
	// will continue to be returned by Get while the new value is loading.
	// If Key does not exist, this function will block until the value is loaded.
	Refresh(context.Context, K) error
}

type SomeCache[K Key, V Value] interface {
	// GetIfPresent returns value associated with Key or (nil, false)
	// if there is no cached value for Key.
	GetIfPresent(context.Context, K) (V, bool)

	// Put associates value with Key. If a value is already associated
	// with Key, the old one will be replaced with Value.
	Put(context.Context, K, V)

	// Invalidate discards cached value of the given Key.
	Invalidate(context.Context, K)

	// InvalidateAll discards all entries.
	InvalidateAll(context.Context)

	// Close implements io.Closer for cleaning up all resources.
	// Users must ensure the cache is not being used before closing or
	// after closed.
	Close() error
}

type Value any