feat(codegen): 添加 GoDefine

Author: caixw

.github/workflows/go.yml

@@ -2,18 +2,16 @@ name: Go
 on: [push, pull_request]
 
 jobs:
-
   test:
     name: Test
     runs-on: ${{ matrix.os }}
 
     strategy:
       matrix:
         os: [ubuntu-latest, macOS-latest, windows-latest]
-        go: ['1.22.x', '1.23.x']
+        go: ["1.23.x", "1.24.x"]
 
     steps:
-
       - name: Check out code into the Go module directory
         uses: actions/checkout@v4
 
@@ -30,7 +28,7 @@ jobs:
         run: go test -v -coverprofile='coverage.txt' -covermode=atomic ./...
 
       - name: Upload Coverage report
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@v5
         with:
           token: ${{secrets.CODECOV_TOKEN}}
-          file: ./coverage.txt
+          files: ./coverage.txt

codegen/object.go

@@ -0,0 +1,57 @@
+// SPDX-FileCopyrightText: 2025 caixw
+//
+// SPDX-License-Identifier: MIT
+
+package codegen
+
+import (
+	"reflect"
+	"strconv"
+	"strings"
+
+	"github.com/issue9/errwrap"
+)
+
+// GoDefine 返回对象 v 在 Go 源码中的定义方式
+func GoDefine(t reflect.Type) string {
+	buf := &errwrap.Buffer{}
+	goDefine(buf, 0, t)
+	return buf.String()
+}
+
+func goDefine(buf *errwrap.Buffer, indent int, t reflect.Type) {
+	for t.Kind() == reflect.Pointer {
+		t = t.Elem()
+	}
+
+	switch t.Kind() {
+	case reflect.Func, reflect.Chan: // 忽略
+	case reflect.Slice:
+		buf.WString("[]").WString(t.Elem().Name())
+	case reflect.Array:
+		buf.WByte('[').WString(strconv.Itoa(t.Len())).WByte(']').WString(t.Elem().Name())
+	case reflect.Struct:
+		buf.WString("{\n")
+		indent++
+		for i := 0; i < t.NumField(); i++ {
+			f := t.Field(i)
+			if f.Type.Kind() == reflect.Func || f.Type.Kind() == reflect.Chan {
+				continue
+			}
+
+			buf.WString(strings.Repeat("\t", indent)).WString(f.Name).WByte('\t')
+			goDefine(buf, indent, f.Type)
+
+			if f.Tag != "" {
+				buf.WByte('\t').WByte('`').WString(string(f.Tag)).WByte('`')
+			}
+
+			buf.WByte('\n')
+		}
+
+		indent--
+		buf.WString(strings.Repeat("\t", indent)).WByte('}')
+	default:
+		buf.WString(t.Name())
+	}
+}

codegen/object_test.go

@@ -0,0 +1,41 @@
+// SPDX-FileCopyrightText: 2025 caixw
+//
+// SPDX-License-Identifier: MIT
+
+package codegen
+
+import (
+	"reflect"
+	"testing"
+
+	"github.com/issue9/assert/v4"
+)
+
+type object1 struct {
+	Int   int `json:"int" yaml:"int"`
+	Array [5]int
+	Slice []string
+	Byte  byte
+	Chan  chan int
+}
+
+type object2 struct {
+	Int    int      `json:"int" yaml:"int"`
+	Object *object1 `json:"object"`
+}
+
+func TestGoDefine(t *testing.T) {
+	a := assert.New(t, false)
+
+	wont := "{\n\tInt\tint\t`json:\"int\" yaml:\"int\"`\n\tArray\t[5]int\n\tSlice\t[]string\n\tByte\tuint8\n}"
+	a.Equal(GoDefine(reflect.TypeFor[object1]()), wont)
+
+	wont = "{\n\tInt\tint\t`json:\"int\" yaml:\"int\"`\n\tObject\t{\n\t\tInt\tint\t`json:\"int\" yaml:\"int\"`\n\t\tArray\t[5]int\n\t\tSlice\t[]string\n\t\tByte\tuint8\n\t}\t`json:\"object\"`\n}"
+	a.Equal(GoDefine(reflect.TypeFor[*object2]()), wont)
+
+	a.Equal(GoDefine(reflect.TypeFor[int]()), "int")
+
+	a.Equal(GoDefine(reflect.TypeFor[string]()), "string")
+
+	a.Equal(GoDefine(reflect.TypeFor[func()]()), "")
+}

go.mod

@@ -1,9 +1,9 @@
 module github.com/issue9/source
 
-go 1.22.0
+go 1.23.0
 
 require (
 	github.com/issue9/assert/v4 v4.3.1
 	github.com/issue9/errwrap v0.3.2
-	golang.org/x/mod v0.22.0
+	golang.org/x/mod v0.23.0
 )

go.sum

@@ -2,5 +2,5 @@ github.com/issue9/assert/v4 v4.3.1 h1:dHYODk1yV7j/1baIB6K6UggI4r1Hfuljqic7PaDbwL
 github.com/issue9/assert/v4 v4.3.1/go.mod h1:v7qDRXi7AsaZZNh8eAK2rkLJg5/clztqQGA1DRv9Lv4=
 github.com/issue9/errwrap v0.3.2 h1:7KEme9Pfe75M+sIMcPCn/DV90wjnOcRbO4DXVAHj3Fw=
 github.com/issue9/errwrap v0.3.2/go.mod h1:KcCLuUGiffjooLCUjL89r1cyO8/HT/VRcQrneO53N3A=
-golang.org/x/mod v0.22.0 h1:D4nJWe9zXqHOmWqj4VMOJhvzj7bEZg4wEYa759z1pH4=
-golang.org/x/mod v0.22.0/go.mod h1:6SkKJ3Xj0I0BrPOZoBy3bdMptDDU9oJrpohJ3eWZ1fY=
+golang.org/x/mod v0.23.0 h1:Zb7khfcRGKk+kqfxFaP5tZqCnDZMjC5VtUBs87Hr6QM=
+golang.org/x/mod v0.23.0/go.mod h1:6SkKJ3Xj0I0BrPOZoBy3bdMptDDU9oJrpohJ3eWZ1fY=