fix expiration for non by key cache

add goroutine to clean up old cache entries to save mem

framework/h/cache.go

@@ -1,6 +1,7 @@
 package h
 
 import (
+	"log/slog"
 	"sync"
 	"time"
 )
@@ -11,8 +12,8 @@ type CachedNode struct {
 	byKeyCache      map[any]*Entry
 	byKeyExpiration map[any]time.Time
 	mutex           sync.Mutex
-	expiration      time.Time
 	duration        time.Duration
+	expiration      time.Time
 	html            string
 }
 
@@ -33,15 +34,25 @@ type GetElementFuncT2WithKey[K comparable, T any, T2 any] func(T, T2) (K, GetEle
 type GetElementFuncT3WithKey[K comparable, T any, T2 any, T3 any] func(T, T2, T3) (K, GetElementFunc)
 type GetElementFuncT4WithKey[K comparable, T any, T2 any, T3 any, T4 any] func(T, T2, T3, T4) (K, GetElementFunc)
 
+func startExpiredCacheCleaner(node *CachedNode) {
+	go func() {
+		for {
+			time.Sleep(time.Second)
+			node.ClearExpired()
+		}
+	}()
+}
+
 func Cached(duration time.Duration, cb GetElementFunc) func() *Element {
 	element := &Element{
 		tag: CachedNodeTag,
 		meta: &CachedNode{
 			cb:       cb,
 			html:     "",
-			expiration: time.Now().Add(duration),
+			duration: duration,
 		},
 	}
+	startExpiredCacheCleaner(element.meta.(*CachedNode))
 	return func() *Element {
 		return element
 	}
@@ -57,6 +68,7 @@ func CachedPerKey[K comparable](duration time.Duration, cb GetElementFuncWithKey
 			duration: duration,
 		},
 	}
+	startExpiredCacheCleaner(element.meta.(*CachedNode))
 	return func() *Element {
 		key, componentFunc := cb()
 		return &Element{
@@ -86,6 +98,7 @@ func CachedPerKeyT[K comparable, T any](duration time.Duration, cb GetElementFun
 			duration: duration,
 		},
 	}
+	startExpiredCacheCleaner(element.meta.(*CachedNode))
 	return func(data T) *Element {
 		key, componentFunc := cb(data)
 		return &Element{
@@ -109,6 +122,7 @@ func CachedPerKeyT2[K comparable, T any, T2 any](duration time.Duration, cb GetE
 			duration: duration,
 		},
 	}
+	startExpiredCacheCleaner(element.meta.(*CachedNode))
 	return func(data T, data2 T2) *Element {
 		key, componentFunc := cb(data, data2)
 		return &Element{
@@ -132,6 +146,7 @@ func CachedPerKeyT3[K comparable, T any, T2 any, T3 any](duration time.Duration,
 			duration: duration,
 		},
 	}
+	startExpiredCacheCleaner(element.meta.(*CachedNode))
 	return func(data T, data2 T2, data3 T3) *Element {
 		key, componentFunc := cb(data, data2, data3)
 		return &Element{
@@ -155,6 +170,7 @@ func CachedPerKeyT4[K comparable, T any, T2 any, T3 any, T4 any](duration time.D
 			duration: duration,
 		},
 	}
+	startExpiredCacheCleaner(element.meta.(*CachedNode))
 	return func(data T, data2 T2, data3 T3, data4 T4) *Element {
 		key, componentFunc := cb(data, data2, data3, data4)
 		return &Element{
@@ -173,10 +189,11 @@ func CachedT[T any](duration time.Duration, cb GetElementFuncT[T]) func(T) *Elem
 		tag: CachedNodeTag,
 		meta: &CachedNode{
 			html:     "",
-			expiration: time.Now().Add(duration),
+			duration: duration,
 			mutex:    sync.Mutex{},
 		},
 	}
+	startExpiredCacheCleaner(element.meta.(*CachedNode))
 	return func(data T) *Element {
 		element.meta.(*CachedNode).cb = func() *Element {
 			return cb(data)
@@ -190,9 +207,10 @@ func CachedT2[T any, T2 any](duration time.Duration, cb GetElementFuncT2[T, T2])
 		tag: CachedNodeTag,
 		meta: &CachedNode{
 			html:     "",
-			expiration: time.Now().Add(duration),
+			duration: duration,
 		},
 	}
+	startExpiredCacheCleaner(element.meta.(*CachedNode))
 	return func(data T, data2 T2) *Element {
 		element.meta.(*CachedNode).cb = func() *Element {
 			return cb(data, data2)
@@ -206,9 +224,10 @@ func CachedT3[T any, T2 any, T3 any](duration time.Duration, cb GetElementFuncT3
 		tag: CachedNodeTag,
 		meta: &CachedNode{
 			html:     "",
-			expiration: time.Now().Add(duration),
+			duration: duration,
 		},
 	}
+	startExpiredCacheCleaner(element.meta.(*CachedNode))
 	return func(data T, data2 T2, data3 T3) *Element {
 		element.meta.(*CachedNode).cb = func() *Element {
 			return cb(data, data2, data3)
@@ -222,9 +241,10 @@ func CachedT4[T any, T2 any, T3 any, T4 any](duration time.Duration, cb GetEleme
 		tag: CachedNodeTag,
 		meta: &CachedNode{
 			html:     "",
-			expiration: time.Now().Add(duration),
+			duration: duration,
 		},
 	}
+	startExpiredCacheCleaner(element.meta.(*CachedNode))
 	return func(data T, data2 T2, data3 T3, data4 T4) *Element {
 		element.meta.(*CachedNode).cb = func() *Element {
 			return cb(data, data2, data3, data4)
@@ -240,6 +260,40 @@ func (c *CachedNode) ClearCache() {
 			delete(c.byKeyCache, key)
 		}
 	}
+	if c.byKeyExpiration != nil {
+		for key := range c.byKeyExpiration {
+			delete(c.byKeyExpiration, key)
+		}
+	}
+}
+
+func (c *CachedNode) ClearExpired() {
+	c.mutex.Lock()
+	defer c.mutex.Unlock()
+	deletedCount := 0
+	if c.isByKey == true {
+		if c.byKeyCache != nil && c.byKeyExpiration != nil {
+			for key := range c.byKeyCache {
+				expir, ok := c.byKeyExpiration[key]
+				if ok && expir.Before(time.Now()) {
+					delete(c.byKeyCache, key)
+					delete(c.byKeyExpiration, key)
+					deletedCount++
+				}
+			}
+		}
+	} else {
+		now := time.Now()
+		expiration := c.expiration
+		if c.html != "" && expiration.Before(now) {
+			c.html = ""
+			deletedCount++
+		}
+	}
+
+	if deletedCount > 0 {
+		slog.Debug("Deleted expired cache entries", slog.Int("count", deletedCount))
+	}
 }
 
 func (c *CachedNode) Render(ctx *RenderContext) {
@@ -248,8 +302,13 @@ func (c *CachedNode) Render(ctx *RenderContext) {
 	} else {
 		c.mutex.Lock()
 		defer c.mutex.Unlock()
-		if c.expiration.Before(time.Now()) {
+
+		now := time.Now()
+		expiration := c.expiration
+
+		if expiration.IsZero() || expiration.Before(now) {
 			c.html = ""
+			c.expiration = now.Add(c.duration)
 		}
 
 		if c.html != "" {
@@ -308,5 +367,4 @@ func (c *ByKeyEntry) Render(ctx *RenderContext) {
 
 	// exists in cache and not expired
 	ctx.builder.WriteString(entry.html)
-
 }

framework/h/render_test.go

@@ -6,6 +6,7 @@ import (
 	"github.com/stretchr/testify/assert"
 	"golang.org/x/net/html"
 	"sort"
+	"strconv"
 	"strings"
 	"sync"
 	"testing"
@@ -141,6 +142,70 @@ func TestCached(t *testing.T) {
 	assert.Equal(t, firstRender, sortHtmlAttributes(Render(ComplexPage())))
 }
 
+func TestCachedT(t *testing.T) {
+	t.Parallel()
+	count := 0
+	page := CachedT(time.Hour, func(a string) *Element {
+		count++
+		return ComplexPage()
+	})
+
+	firstRender := sortHtmlAttributes(Render(page("a")))
+	secondRender := sortHtmlAttributes(Render(page("a")))
+
+	assert.Equal(t, firstRender, secondRender)
+	assert.Equal(t, 1, count)
+	assert.Equal(t, firstRender, sortHtmlAttributes(Render(ComplexPage())))
+}
+
+func TestCachedT2(t *testing.T) {
+	t.Parallel()
+	count := 0
+	page := CachedT2(time.Hour, func(a string, b string) *Element {
+		count++
+		return ComplexPage()
+	})
+
+	firstRender := sortHtmlAttributes(Render(page("a", "b")))
+	secondRender := sortHtmlAttributes(Render(page("a", "b")))
+
+	assert.Equal(t, firstRender, secondRender)
+	assert.Equal(t, 1, count)
+	assert.Equal(t, firstRender, sortHtmlAttributes(Render(ComplexPage())))
+}
+
+func TestCachedT3(t *testing.T) {
+	t.Parallel()
+	count := 0
+	page := CachedT3(time.Hour, func(a string, b string, c string) *Element {
+		count++
+		return ComplexPage()
+	})
+
+	firstRender := sortHtmlAttributes(Render(page("a", "b", "c")))
+	secondRender := sortHtmlAttributes(Render(page("a", "b", "c")))
+
+	assert.Equal(t, firstRender, secondRender)
+	assert.Equal(t, 1, count)
+	assert.Equal(t, firstRender, sortHtmlAttributes(Render(ComplexPage())))
+}
+
+func TestCachedT4(t *testing.T) {
+	t.Parallel()
+	count := 0
+	page := CachedT4(time.Hour, func(a string, b string, c string, d string) *Element {
+		count++
+		return ComplexPage()
+	})
+
+	firstRender := sortHtmlAttributes(Render(page("a", "b", "c", "d")))
+	secondRender := sortHtmlAttributes(Render(page("a", "b", "c", "d")))
+
+	assert.Equal(t, firstRender, secondRender)
+	assert.Equal(t, 1, count)
+	assert.Equal(t, firstRender, sortHtmlAttributes(Render(ComplexPage())))
+}
+
 func TestCachedExpired(t *testing.T) {
 	t.Parallel()
 	count := 0
@@ -388,9 +453,82 @@ func TestCacheByKeyT1Expired_2(t *testing.T) {
 	assert.Equal(t, 3, renderCount)
 }
 
+func TestClearExpiredCached(t *testing.T) {
+	t.Parallel()
+	renderCount := 0
+	cachedItem := Cached(time.Millisecond*3, func() *Element {
+		renderCount++
+		return Pf("hello")
+	})
+
+	Render(cachedItem())
+	Render(cachedItem())
+	node := cachedItem().meta.(*CachedNode)
+	assert.Equal(t, 1, renderCount)
+	assert.NotEmpty(t, node.html)
+
+	time.Sleep(time.Millisecond * 3)
+	node.ClearExpired()
+
+	assert.Empty(t, node.html)
+}
+
+func TestClearExpiredCacheByKey(t *testing.T) {
+	t.Parallel()
+	renderCount := 0
+	cachedItem := CachedPerKeyT(time.Millisecond, func(key int) (any, GetElementFunc) {
+		return key, func() *Element {
+			renderCount++
+			return Pf(strconv.Itoa(key))
+		}
+	})
+
+	for i := 0; i < 100; i++ {
+		Render(cachedItem(i))
+	}
+
+	node := cachedItem(0).meta.(*ByKeyEntry).parent.meta.(*CachedNode)
+	assert.Equal(t, 100, len(node.byKeyExpiration))
+	assert.Equal(t, 100, len(node.byKeyCache))
+
+	time.Sleep(time.Millisecond * 2)
+
+	Render(cachedItem(0))
+	node.ClearExpired()
+
+	assert.Equal(t, 1, len(node.byKeyExpiration))
+	assert.Equal(t, 1, len(node.byKeyCache))
+
+	node.ClearCache()
+
+	assert.Equal(t, 0, len(node.byKeyExpiration))
+	assert.Equal(t, 0, len(node.byKeyCache))
+}
+
+func TestBackgroundCleaner(t *testing.T) {
+	t.Parallel()
+	cachedItem := CachedPerKeyT(time.Second*2, func(key int) (any, GetElementFunc) {
+		return key, func() *Element {
+			return Pf(strconv.Itoa(key))
+		}
+	})
+	for i := 0; i < 100; i++ {
+		Render(cachedItem(i))
+	}
+
+	node := cachedItem(0).meta.(*ByKeyEntry).parent.meta.(*CachedNode)
+	assert.Equal(t, 100, len(node.byKeyExpiration))
+	assert.Equal(t, 100, len(node.byKeyCache))
+
+	time.Sleep(time.Second * 3)
+
+	assert.Equal(t, 0, len(node.byKeyExpiration))
+	assert.Equal(t, 0, len(node.byKeyCache))
+}
+
 func BenchmarkCacheByKey(b *testing.B) {
 	b.ReportAllocs()
-	page := CachedPerKeyT(time.Hour, func(userId string) (any, GetElementFunc) {
+	page := CachedPerKeyT(time.Second*3, func(userId string) (any, GetElementFunc) {
 		return userId, func() *Element {
 			return MailTo(userId)
 		}