chore: cachettl configuration option for not refreshing ttl

cachettl/cachettl.go

@@ -10,10 +10,11 @@ import (
 // the tail node (end) is the node with the highest expiration time
 // Cleanups are done on Get() calls so if Get() is never invoked then Nodes stay in-memory.
 type Cache[K comparable, V any] struct {
-	root      *node[K, V]
-	mu        sync.Mutex
-	m         map[K]*node[K, V]
-	now       func() time.Time
+	root *node[K, V]
+	mu   sync.Mutex
+	m    map[K]*node[K, V]
+
+	config    cacheConfig
 	onEvicted func(key K, value V)
 }
 
@@ -32,24 +33,31 @@ func (n *node[K, V]) remove() {
 }
 
 // New returns a new Cache.
-func New[K comparable, V any]() *Cache[K, V] {
-	return &Cache[K, V]{
-		now:  time.Now,
+func New[K comparable, V any](opts ...Opt) *Cache[K, V] {
+	c := &Cache[K, V]{
+		config: cacheConfig{
+			now:        time.Now,
+			refreshTTL: true,
+		},
 		root: &node[K, V]{},
 		m:    make(map[K]*node[K, V]),
 	}
+	for _, opt := range opts {
+		opt(&c.config)
+	}
+	return c
 }
 
 // Get returns the value associated with the key or nil otherwise.
-// Additionally, Get() will refresh the TTL and cleanup expired nodes.
+// Additionally, Get() will refresh the TTL by default and cleanup expired nodes.
 func (c *Cache[K, V]) Get(key K) (zero V) {
 	c.mu.Lock()
 	defer c.mu.Unlock()
 
 	defer func() { // remove expired nodes
 		cn := c.root.next // start from head since we're sorting by expiration with the highest expiration at the tail
 		for cn != nil && cn != c.root {
-			if c.now().After(cn.expiration) {
+			if c.config.now().After(cn.expiration) {
 				cn.remove()             // removes a node from the linked list (leaves the map untouched)
 				delete(c.m, cn.key)     // remove node from map too
 				if c.onEvicted != nil { // call the OnEvicted callback if it's set
@@ -62,10 +70,12 @@ func (c *Cache[K, V]) Get(key K) (zero V) {
 		}
 	}()
 
-	if n, ok := c.m[key]; ok && n.expiration.After(c.now()) {
-		n.remove()
-		n.expiration = c.now().Add(n.ttl) // refresh TTL
-		c.add(n)
+	if n, ok := c.m[key]; ok && n.expiration.After(c.config.now()) {
+		if c.config.refreshTTL {
+			n.remove()
+			n.expiration = c.config.now().Add(n.ttl) // refresh TTL
+			c.add(n)
+		}
 		return n.value
 	}
 	return zero
@@ -77,7 +87,7 @@ func (c *Cache[K, V]) Put(key K, value V, ttl time.Duration) {
 	c.mu.Lock()
 	defer c.mu.Unlock()
 
-	now := c.now()
+	now := c.config.now()
 
 	n, ok := c.m[key]
 	if !ok {

cachettl/cachettl_config.go

@@ -0,0 +1,22 @@
+package cachettl
+
+import "time"
+
+type Opt func(*cacheConfig)
+
+// WithNoRefreshTTL disables the refresh of the TTL when the cache is accessed.
+var WithNoRefreshTTL = func(c *cacheConfig) {
+	c.refreshTTL = false
+}
+
+// WithNow sets the function to use to get the current time.
+var WithNow = func(now func() time.Time) Opt {
+	return func(c *cacheConfig) {
+		c.now = now
+	}
+}
+
+type cacheConfig struct {
+	now        func() time.Time
+	refreshTTL bool
+}

cachettl/cachettl_test.go

@@ -10,8 +10,7 @@ import (
 func TestCacheTTL(t *testing.T) {
 	now := time.Now()
 
-	c := New[string, string]()
-	c.now = func() time.Time { return now }
+	c := New[string, string](WithNow(func() time.Time { return now }))
 
 	// nothing done so far, we expect the cache to be empty
 	require.Nil(t, c.slice())
@@ -37,30 +36,30 @@ func TestCacheTTL(t *testing.T) {
 	require.Equal(t, []string{"222", "111", "333"}, c.slice())
 
 	// move time forward to expire "222"
-	c.now = func() time.Time { return now.Add(1) } // "222" should still be there
-	require.Empty(t, c.Get("whatever"))            // trigger the cleanup
+	c.config.now = func() time.Time { return now.Add(1) } // "222" should still be there
+	require.Empty(t, c.Get("whatever"))                   // trigger the cleanup
 	require.Equal(t, []string{"222", "111", "333"}, c.slice())
 
-	c.now = func() time.Time { return now.Add(2) } // "222" should still be there
-	require.Empty(t, c.Get("whatever"))            // trigger the cleanup
+	c.config.now = func() time.Time { return now.Add(2) } // "222" should still be there
+	require.Empty(t, c.Get("whatever"))                   // trigger the cleanup
 	require.Equal(t, []string{"222", "111", "333"}, c.slice())
 
-	c.now = func() time.Time { return now.Add(3) } // "222" should be expired!
-	require.Empty(t, c.Get("whatever"))            // trigger the cleanup
+	c.config.now = func() time.Time { return now.Add(3) } // "222" should be expired!
+	require.Empty(t, c.Get("whatever"))                   // trigger the cleanup
 	require.Equal(t, []string{"111", "333"}, c.slice())
 
 	// let's move a lot forward to expire everything
-	c.now = func() time.Time { return now.Add(6) }
+	c.config.now = func() time.Time { return now.Add(6) }
 	require.Empty(t, c.Get("whatever")) // trigger the cleanup
 	require.Nil(t, c.slice())
 	require.Len(t, c.m, 0)
 
 	// now let's set a key, then move forward and get it directly without triggering with a different key
-	c.now = func() time.Time { return now }
+	c.config.now = func() time.Time { return now }
 	c.Put("last", "999", 1)
 	require.Equal(t, "999", c.Get("last"))
 	require.Equal(t, []string{"999"}, c.slice())
-	c.now = func() time.Time { return now.Add(2) }
+	c.config.now = func() time.Time { return now.Add(2) }
 	require.Empty(t, c.Get("last")) // trigger the cleanup
 	require.Nil(t, c.slice())
 	require.Len(t, c.m, 0)
@@ -86,3 +85,32 @@ func TestRefreshTTL(t *testing.T) {
 	require.Equal(t, "333", c.Get("three"))
 	require.Equal(t, []string{"111", "222", "333"}, c.slice())
 }
+
+func TestNoRefreshTTL(t *testing.T) {
+	now := time.Now()
+	c := New[string, string](WithNoRefreshTTL, WithNow(func() time.Time { return now }))
+
+	// nothing done so far, we expect the cache to be empty
+	require.Nil(t, c.slice())
+
+	c.Put("one", "111", time.Second)
+	c.Put("two", "222", time.Second)
+	c.Put("three", "333", time.Second)
+	require.Equal(t, []string{"111", "222", "333"}, c.slice())
+
+	now = now.Add(500 * time.Millisecond)
+	require.Equal(t, "111", c.Get("one"))
+	require.Equal(t, []string{"111", "222", "333"}, c.slice())
+
+	require.Equal(t, "222", c.Get("two"))
+	require.Equal(t, []string{"111", "222", "333"}, c.slice())
+
+	require.Equal(t, "333", c.Get("three"))
+	require.Equal(t, []string{"111", "222", "333"}, c.slice())
+
+	now = now.Add(500 * time.Millisecond)
+
+	require.Empty(t, c.Get("one"))
+	require.Empty(t, c.Get("two"))
+	require.Empty(t, c.Get("three"))
+}

resourcettl/cache.go

@@ -14,6 +14,7 @@ import (
 // NewCache creates a new resource cache.
 //
 //   - ttl - is the time after which the resource is considered expired and cleaned up.
+//   - refreshTTL - if true, the resource's ttl is extended every time it is checked out.
 //
 // A resource's ttl is extended every time it is checked out.
 //
@@ -27,14 +28,18 @@ import (
 //   - Close() error
 //   - Stop()
 //   - Stop() error
-func NewCache[K comparable, R any](ttl time.Duration) *Cache[K, R] {
+func NewCache[K comparable, R any](ttl time.Duration, refreshTTL bool) *Cache[K, R] {
+	var opts []cachettl.Opt
+	if !refreshTTL {
+		opts = append(opts, cachettl.WithNoRefreshTTL)
+	}
 	c := &Cache[K, R]{
 		keyMu:     kitsync.NewPartitionLocker(),
 		resources: make(map[string]R),
 		checkouts: make(map[string]int),
 		expiries:  make(map[string]struct{}),
 		ttl:       ttl,
-		ttlcache:  cachettl.New[K, string](),
+		ttlcache:  cachettl.New[K, string](opts...),
 	}
 	c.ttlcache.OnEvicted(c.onEvicted)
 	return c

resourcettl/cache_test.go

@@ -17,7 +17,7 @@ func TestCache(t *testing.T) {
 	t.Run("checkout, checkin, then expire", func(t *testing.T) {
 		t.Run("using cleanup", func(t *testing.T) {
 			producer := &MockProducer{}
-			c := resourcettl.NewCache[string, *cleanuper](ttl)
+			c := resourcettl.NewCache[string, *cleanuper](ttl, true)
 
 			r1, checkin1, err1 := c.Checkout(key, producer.NewCleanuper)
 			require.NoError(t, err1, "it should be able to create a new resource")
@@ -46,7 +46,7 @@ func TestCache(t *testing.T) {
 
 		t.Run("using closer", func(t *testing.T) {
 			producer := &MockProducer{}
-			c := resourcettl.NewCache[string, *closer](ttl)
+			c := resourcettl.NewCache[string, *closer](ttl, false)
 
 			r1, checkin1, err1 := c.Checkout(key, producer.NewCloser)
 			require.NoError(t, err1, "it should be able to create a new resource")
@@ -76,7 +76,7 @@ func TestCache(t *testing.T) {
 
 	t.Run("expire while being used", func(t *testing.T) {
 		producer := &MockProducer{}
-		c := resourcettl.NewCache[string, *cleanuper](ttl)
+		c := resourcettl.NewCache[string, *cleanuper](ttl, false)
 
 		r1, checkin1, err1 := c.Checkout(key, producer.NewCleanuper)
 		require.NoError(t, err1, "it should be able to create a new resource")
@@ -108,7 +108,7 @@ func TestCache(t *testing.T) {
 
 	t.Run("invalidate", func(t *testing.T) {
 		producer := &MockProducer{}
-		c := resourcettl.NewCache[string, *cleanuper](ttl)
+		c := resourcettl.NewCache[string, *cleanuper](ttl, false)
 
 		r1, checkin1, err1 := c.Checkout(key, producer.NewCleanuper)
 		require.NoError(t, err1, "it should be able to create a new resource")