Merge pull request #11 from FishGoddess/develop

v0.6.0-alpha

Author: FishGoddess

.github/workflows/test.yml

@@ -12,7 +12,7 @@ jobs:
       - name: Setup
         uses: actions/setup-go@v4
         with:
-          go-version: "1.17"
+          go-version: "1.20"
       - run: go version
 
       - name: Checkout

FUTURE.md

@@ -1,10 +1,14 @@
 ## ✒ 未来版本的新特性 (Features in future versions)
 
+### v0.6.x
+
+* [ ] 梳理代码，优化代码风格，精简部分代码和注释
+* [ ] 完善监控上报器，提供更多缓存信息查询的方法
+
 ### v0.5.x
 
 * [ ] ~~提供一个清空并设置全量值的方法，方便定时数据的全量替换~~
   目前还找不到一个合适的设计去加入这个功能，并且也不是非常刚需，通过业务手段可以处理，所以先不加
-* [ ] 完善监控上报器，提供更多缓存信息查询的方法
 
 ### v0.4.x
 

HISTORY.md

@@ -1,5 +1,12 @@
 ## ✒ 历史版本的特性介绍 (Features in old versions)
 
+### v0.6.0-alpha
+
+> 此版本发布于 2024-01-13
+
+* 受小徒弟的灵感激发，进行 loader 代码的调整
+* 把 cache 结构去掉，精简这部分设计
+
 ### v0.5.0
 
 > 此版本发布于 2023-11-30

Makefile

@@ -3,10 +3,10 @@
 all: test bench
 
 test:
-	go test -cover ./...
+	go test -cover -count=1 -test.cpu=1 ./...
 
 bench:
-	go test -v -bench=. -benchtime=1s ./_examples/performance_test.go
+	go test -v ./_examples/performance_test.go -bench=. -benchtime=1s
 
 fmt:
 	go fmt ./...

README.en.md

@@ -2,7 +2,7 @@
 
 [![Go Doc](_icons/godoc.svg)](https://pkg.go.dev/github.com/FishGoddess/cachego)
 [![License](_icons/license.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
-[![License](_icons/coverage.svg)](_icons/coverage.svg)
+[![Coverage](_icons/coverage.svg)](_icons/coverage.svg)
 ![Test](https://github.com/FishGoddess/cachego/actions/workflows/test.yml/badge.svg)
 
 **cachego** is an api friendly memory-based cache for [GoLang](https://golang.org) applications.

README.md

@@ -2,7 +2,7 @@
 
 [![Go Doc](_icons/godoc.svg)](https://pkg.go.dev/github.com/FishGoddess/cachego)
 [![License](_icons/license.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
-[![License](_icons/coverage.svg)](_icons/coverage.svg)
+[![Coverage](_icons/coverage.svg)](_icons/coverage.svg)
 ![Test](https://github.com/FishGoddess/cachego/actions/workflows/test.yml/badge.svg)
 
 **cachego** 是一个拥有分片机制的轻量级内存缓存库，API 友好，支持多种数据淘汰机制，可以应用于所有的 [GoLang](https://golang.org) 应用程序中。

_examples/task.go

@@ -54,10 +54,5 @@ func main() {
 	// Duration is the duration between two loop of fn, optional.
 	// Run will start a new goroutine and run the task loop.
 	// The task will stop if context is done.
-	task.New(printContextValue).
-		Before(beforePrint).
-		After(afterPrint).
-		Context(ctx).
-		Duration(time.Second).
-		Run()
+	task.New(printContextValue).Before(beforePrint).After(afterPrint).Context(ctx).Duration(time.Second).Run()
 }

_icons/coverage.svg

@@ -16,7 +16,6 @@ package cachego
 
 import (
 	"context"
-	"sync"
 	"time"
 
 	"github.com/FishGoddess/cachego/pkg/task"
@@ -27,20 +26,6 @@ const (
 	NoTTL = 0
 )
 
-const (
-	// standard cache is a simple cache with locked map.
-	// It evicts entries randomly if cache size reaches to max entries.
-	standard CacheType = "standard"
-
-	// lru cache is a cache using lru to evict entries.
-	// More details see https://en.wikipedia.org/wiki/Cache_replacement_policies#Least_recently_used_(LRU).
-	lru CacheType = "lru"
-
-	// lfu cache is a cache using lfu to evict entries.
-	// More details see https://en.wikipedia.org/wiki/Cache_replacement_policies#Least-frequently_used_(LFU).
-	lfu CacheType = "lfu"
-)
-
 var (
 	newCaches = map[CacheType]func(conf *config) Cache{
 		standard: newStandardCache,
@@ -49,29 +34,6 @@ var (
 	}
 )
 
-// CacheType is the type of cache.
-type CacheType string
-
-// String returns the cache type in string form.
-func (ct CacheType) String() string {
-	return string(ct)
-}
-
-// IsStandard returns if cache type is standard.
-func (ct CacheType) IsStandard() bool {
-	return ct == standard
-}
-
-// IsLRU returns if cache type is lru.
-func (ct CacheType) IsLRU() bool {
-	return ct == lru
-}
-
-// IsLFU returns if cache type is lfu.
-func (ct CacheType) IsLFU() bool {
-	return ct == lfu
-}
-
 // Cache is the core interface of cachego.
 // We provide some implements including standard cache and sharding cache.
 type Cache interface {
@@ -101,38 +63,10 @@ type Cache interface {
 	// Reset resets cache to initial status which is like a new cache.
 	Reset()
 
-	// Loader loads a value to cache.
-	// See Loader interface.
-	Loader
-}
-
-type cache struct {
-	*config
-	Loader
-
-	lock sync.RWMutex
-}
-
-func (c *cache) setup(conf *config, cache Cache) {
-	c.config = conf
-	c.Loader = NewLoader(cache, conf.singleflight)
-}
-
-// RunGCTask runs a gc task in a new goroutine and returns a cancel function to cancel the task.
-// However, you don't need to call it manually for most time, instead, use options is a better choice.
-// Making it a public function is for more customizations in some situations.
-// For example, using options to run gc task is un-cancelable, so you can use it to run gc task by your own
-// and get a cancel function to cancel the gc task.
-func RunGCTask(cache Cache, duration time.Duration) (cancel func()) {
-	fn := func(ctx context.Context) {
-		cache.GC()
-	}
-
-	ctx := context.Background()
-	ctx, cancel = context.WithCancel(ctx)
-
-	go task.New(fn).Context(ctx).Duration(duration).Run()
-	return cancel
+	// Load loads a key with ttl to cache and returns an error if failed.
+	// We recommend you use this method to load missed keys to cache,
+	// because it may use singleflight to reduce the times calling load function.
+	Load(key string, ttl time.Duration, load func() (value interface{}, err error)) (value interface{}, err error)
 }
 
 func newCache(withReport bool, opts ...Option) (cache Cache, reporter *Reporter) {
@@ -180,3 +114,20 @@ func NewCache(opts ...Option) (cache Cache) {
 func NewCacheWithReport(opts ...Option) (cache Cache, reporter *Reporter) {
 	return newCache(true, opts...)
 }
+
+// RunGCTask runs a gc task in a new goroutine and returns a cancel function to cancel the task.
+// However, you don't need to call it manually for most time, instead, use options is a better choice.
+// Making it a public function is for more customizations in some situations.
+// For example, using options to run gc task is un-cancelable, so you can use it to run gc task by your own
+// and get a cancel function to cancel the gc task.
+func RunGCTask(cache Cache, duration time.Duration) (cancel func()) {
+	fn := func(ctx context.Context) {
+		cache.GC()
+	}
+
+	ctx := context.Background()
+	ctx, cancel = context.WithCancel(ctx)
+
+	go task.New(fn).Context(ctx).Duration(duration).Run()
+	return cancel
+}