docs(workflow): 更新 GitHub Actions 工作流配置

- 将 Go 版本条件从 '1.23' 更改为 'stable'
- 保持静态检查工具的运行条件一致

docs(strutil): 为字符串工具函数添加使用示例

- 为 ReplaceVars 函数添加使用示例代码
- 为 TextWrap 和 WidthWrap 函数添加功能说明和示例
- 明确标注 TextWrap 作为 WidthWrap 的别名

docs(group): 标记旧的错误组函数为废弃状态

- 为 NewCtxErrGroup 和 NewErrGroup 添加废弃说明
- 修复 QuickRun 中上下文键名冲突问题

Author: inhere

.github/workflows/go.yml

@@ -33,14 +33,14 @@ jobs:
 
 #    - name: Revive check
 #      uses: morphy2k/revive-action@v2.5.10
-#      if: ${{ matrix.os == 'ubuntu-latest' && matrix.go_version == '1.23' }}
+#      if: ${{ matrix.os == 'ubuntu-latest' && matrix.go_version == 'stable' }}
 #      with:
 #        # Exclude patterns, separated by semicolons (optional)
 #        exclude: "./internal/..."
 
     - name: Run staticcheck
       uses: reviewdog/action-staticcheck@v1
-      if: ${{ matrix.os == 'ubuntu-latest' && matrix.go_version == '1.23' }}
+      if: ${{ matrix.os == 'ubuntu-latest' && matrix.go_version == 'stable' }}
       with:
         github_token: ${{ secrets.github_token }}
         # Change reviewdog reporter if you need [github-pr-check,github-check,github-pr-review].

group.go

@@ -12,11 +12,15 @@ import (
 type ErrGroup = syncs.ErrGroup
 
 // NewCtxErrGroup instance. use for batch run tasks, can with context.
+//
+// Deprecated: use syncs.NewCtxErrGroup instead
 func NewCtxErrGroup(ctx context.Context, limit ...int) (*ErrGroup, context.Context) {
 	return syncs.NewCtxErrGroup(ctx, limit...)
 }
 
 // NewErrGroup instance. use for batch run tasks
+//
+// Deprecated: use syncs.NewErrGroup instead
 func NewErrGroup(limit ...int) *ErrGroup {
 	return syncs.NewErrGroup(limit...)
 }
@@ -47,7 +51,7 @@ func (p *QuickRun) Add(fns ...RunFn) *QuickRun {
 // Run all func
 func (p *QuickRun) Run() error {
 	for i, fn := range p.fns {
-		p.ctx.Set("index", i)
+		p.ctx.Set("_index", i)
 		if err := fn(p.ctx); err != nil {
 			return err
 		}

group_test.go

@@ -12,19 +12,13 @@ import (
 )
 
 func TestNewErrGroup(t *testing.T) {
-	httpreq.SetTimeout(3000)
-
 	eg := goutil.NewErrGroup()
 	eg.Add(func() error {
 		resp, err := httpreq.Get(testSrvAddr + "/get")
 		if err != nil {
 			return err
 		}
 
-		fmt.Println(testutil.ParseBodyToReply(resp.Body))
-		return nil
-	}, func() error {
-		resp := httpreq.MustResp(httpreq.Post(testSrvAddr+"/post", "hi"))
 		fmt.Println(testutil.ParseBodyToReply(resp.Body))
 		return nil
 	})

reflects/check_test.go

@@ -1,6 +1,7 @@
 package reflects_test
 
 import (
+	"fmt"
 	"reflect"
 	"testing"
 	"time"
@@ -70,9 +71,18 @@ func TestIsEqual(t *testing.T) {
 	is.True(reflects.IsEqual([]byte("abc"), []byte("abc")))
 	is.False(reflects.IsEqual([]byte("abc"), 123))
 
+	/*
+			原因
+			变量初始化状态不同：
+		      []string{} 是一个非零值的空切片，其长度为0，但已初始化
+			  data []string 是一个零值的切片，声明但未初始化
+			底层实现差异：
+			  []string{}：len=0, cap=0, ptr != nil
+			  data []string：len=0, cap=0, ptr = nil
+	*/
 	var data []string
-	// fmt.Printf("%+v %+v\n", data, []string{})
 	is.False(reflects.IsEqual([]string{}, data))
+	fmt.Printf("%+v %+v\n", []string{}, data)
 }
 
 // ST for testing

strutil/format.go

@@ -198,6 +198,12 @@ func Replaces(str string, pairs map[string]string) string {
 }
 
 // ReplaceVars replaces simple variables in a string. format: {varName}
+//
+// Usage:
+//	strutil.ReplaceVars("{name}, age is {age}", map[string]string{
+//		"name": "Joe",
+//		"age": "18"
+//	})
 func ReplaceVars(s string, vars map[string]string) string {
 	if !ContainsByte(s, '{') {
 		return s

strutil/runes.go

@@ -180,10 +180,14 @@ func Utf8Split(s string, w int) []string {
 	return ss
 }
 
-// TextWrap a string by "\n"
+// TextWrap a string by "\n". alias of the WidthWrap()
 func TextWrap(s string, w int) string { return WidthWrap(s, w) }
 
 // WidthWrap a string by "\n"
+//
+// Example:
+//	s := "hello 你好, world 世界"
+//  s1 := strutil.TextWrap(s, 6) // "hello \n你好, \nworld \n世界"
 func WidthWrap(s string, w int) string {
 	tmpW := 0
 	out := ""