Merge branch 'master' into fix/orm-with

.github/PULL_REQUEST_TEMPLATE.MD

@@ -1,22 +1,44 @@
 **Please ensure you adhere to every item in this list.**
-+ The PR title is formatted as follows: `os/gtime: fixed time zone issues`
-  + The package name goes before the colon
++ The PR title is formatted as follows: `<type>[optional scope]: <description>` For example, `fix(os/gtime): fix time zone issue`
+  + `<type>` is mandatory and can be one of `fix`, `feat`, `build`, `ci`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`
+    + fix: Used when a bug has been fixed.
+    + feat: Used when a new feature has been added.
+    + build: Used for modifications to the project build system, such as changes to dependencies, external interfaces, or upgrading Node version.
+    + ci: Used for modifications to continuous integration processes, such as changes to Travis, Jenkins workflow configurations.
+    + docs: Used for modifications to documentation, such as changes to README files, API documentation, etc.
+    + style: Used for changes to code style, such as adjustments to indentation, spaces, blank lines, etc.
+    + refactor: Used for code refactoring, such as changes to code structure, variable names, function names, without altering functionality.
+    + perf: Used for performance optimization, such as improving code performance, reducing memory usage, etc.
+    + test: Used for modifications to test cases, such as adding, deleting, or modifying test cases for code.
+    + chore: Used for modifications to non-business-related code, such as changes to build processes or tool configurations.
+  + After `<type>`, specify the affected package name or scope in parentheses, for example, `(os/gtime)`.
   + The part after the colon uses the verb tense + phrase that completes the blank in
   + Lowercase verb after the colon
   + No trailing period
   + Keep the title as short as possible. ideally under 76 characters or shorter
-  + Title not Markdown
+  + [Reference Documentation](https://www.conventionalcommits.org/en/v1.0.0/)
 + If there is a corresponding issue, add either `Fixes #1234` or `Updates #1234`
   (the latter if this is not a complete fix) to this comment
 + Delete these instructions once you have read and applied them
 
 **提交前请遵守每个事项，感谢！**
-+ PR 标题格式如下：`os/gtime: fixed time zone issues`
-  + 冒号前是包名
++ PR 标题格式如下：`<类型>[可选 范围]: <描述>` 例如 `fix(os/gtime): fix time zone issue`
+  + `<类型>`是必须的，可以是 `fix`、`feat`、`build`、`ci`、`docs`、`style`、`refactor`、`perf`、`test`、`chore` 中的一个
+    + fix: 用于修复了一个 bug
+    + feat: 用于新增了一个功能
+    + build: 用于修改项目构建系统，例如修改依赖库、外部接口或者升级 Node 版本等
+    + ci: 用于修改持续集成流程，例如修改 Travis、Jenkins 等工作流配置
+    + docs: 用于修改文档，例如修改 README 文件、API 文档等
+    + style: 用于修改代码的样式，例如调整缩进、空格、空行等
+    + refactor: 用于重构代码，例如修改代码结构、变量名、函数名等但不修改功能逻辑
+    + perf: 用于优化性能，例如提升代码的性能、减少内存占用等
+    + test: 用于修改测试用例，例如添加、删除、修改代码的测试用例等
+    + chore: 用于对非业务性代码进行修改，例如修改构建流程或者工具配置等
+  + `<类型>`后在括号中填写受影响的包名或范围，例如 `(os/gtime)`
   + 冒号后使用动词时态 + 短语
   + 冒号后的动词小写
   + 不要有结尾句号
   + 标题尽量保持简短，最好在 76 个字符或更短
-  + 标题不要使用 Markdown
+  + [参考文档](https://www.conventionalcommits.org/zh-hans/v1.0.0/)
 + 如果有对应的 issue，请在此评论中添加 `Fixes #1234`，如果不是完全修复则添加 `Updates #1234`
 + 应用这些规则后删除所有的说明

.github/workflows/ci-main.sh

@@ -52,6 +52,12 @@ for file in `find . -name go.mod`; do
           echo "ignore example as go version: $(go version)"
           continue 1
         fi
+        echo "the example directory only needs to be built, not unit tests and coverage tests."
+        cd $dirpath
+        go mod tidy
+        go build ./...
+        cd -
+        continue 1
     fi
 
     # package otlpgrpc needs golang >= v1.20

.github/workflows/ci-main.yml

@@ -190,8 +190,9 @@ jobs:
 
     steps:
     # TODO: szenius/set-timezone update to node16
+    # sudo ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
     - name: Setup Timezone
-      uses: szenius/set-timezone@v1.1
+      uses: szenius/set-timezone@v2.0
       with:
         timezoneLinux: "Asia/Shanghai"
 
@@ -244,3 +245,4 @@ jobs:
       if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/master' }}
       with:
         flags: go-${{ matrix.go-version }}-${{ matrix.goarch }}
+        token: ${{ secrets.CODECOV_TOKEN }}

.github/workflows/ci-sub.yml

@@ -42,7 +42,7 @@ jobs:
 
     steps:
     - name: Setup Timezone
-      uses: szenius/set-timezone@v1.1
+      uses: szenius/set-timezone@v2.0
       with:
         timezoneLinux: "Asia/Shanghai"
 

.github/workflows/golangci-lint.yml

@@ -47,8 +47,8 @@ jobs:
         with:
           go-version: ${{ matrix.go-version }}
       - name: golangci-lint
-        uses: golangci/golangci-lint-action@v4
+        uses: golangci/golangci-lint-action@v6
         with:
           # Required: the version of golangci-lint is required and must be specified without patch version: we always use the latest patch version.
-          version: v1.56.2
+          version: v1.58.2
           args: --timeout 3m0s

.golangci.yml

@@ -38,7 +38,7 @@ linters:
   # Custom enable linters we want to use.
   enable:
     - errcheck      # Errcheck is a program for checking for unchecked errors in go programs.
-    - errchkjson    # Checks types passed to the json encoding functions. Reports unsupported types and optionally reports occasions, where the check for the returned error can be omitted.
+    - errchkjson    # Checks types passed to the JSON encoding functions. Reports unsupported types and optionally reports occasions, where the check for the returned error can be omitted.
     - funlen        # Tool for detection of long functions
     - goconst       # Finds repeated strings that could be replaced by a constant
     - gocritic      # Provides diagnostics that check for bugs, performance and style issues.
@@ -172,10 +172,6 @@ linters-settings:
 
   # https://golangci-lint.run/usage/linters/#gosimple
   gosimple:
-    # Select the Go version to target.
-    # Default: 1.13
-    # Deprecated: use the global `run.go` instead.
-    go: "1.15"
     # Sxxxx checks in https://staticcheck.io/docs/configuration/options/#checks
     # Default: ["*"]
     checks: [
@@ -184,9 +180,6 @@ linters-settings:
 
   # https://golangci-lint.run/usage/linters/#govet
   govet:
-    # Report about shadowed variables.
-    # Default: false
-    check-shadowing: true
     # Settings per analyzer.
     settings:
       # Analyzer name, run `go tool vet help` to see all analyzers.
@@ -259,10 +252,6 @@ linters-settings:
 
   # https://golangci-lint.run/usage/linters/#staticcheck
   staticcheck:
-    # Select the Go version to target.
-    # Default: "1.13"
-    # Deprecated: use the global `run.go` instead.
-    go: "1.20"
     # SAxxxx checks in https://staticcheck.io/docs/configuration/options/#checks
     # Default: ["*"]
     checks: [ "all","-SA1019","-SA4015","-SA1029","-SA1016","-SA9003","-SA4006","-SA6003" ]

cmd/gf/Makefile

@@ -1,5 +1,5 @@
 
-pack: pack.template-single pack.template-mono
+pack: pack.template-single pack.template-mono pack.template-mono-app
 
 pack.template-single:
 	@rm -fr temp
@@ -15,4 +15,18 @@ pack.template-mono:
 	@cd temp && git clone https://github.com/gogf/template-mono
 	@rm -fr temp/template-mono/.git
 	@cd temp && gf pack template-mono ../internal/packed/template-mono.go -n=packed -y
+	@rm -fr temp
+
+pack.template-mono-app:
+	@rm -fr temp
+	@mkdir temp || exit 0
+	@cd temp && git clone https://github.com/gogf/template-single
+	@cd temp && mv template-single template-mono-app
+	@rm -fr temp/template-mono-app/.git
+	@rm -fr temp/template-mono-app/.gitattributes
+	@rm -fr temp/template-mono-app/.gitignore
+	@rm -fr temp/template-mono-app/go.mod
+	@rm -fr temp/template-mono-app/go.sum
+	@sed -i 's/template-single/template-mono-app/g' temp/template-mono-app/main.go
+	@cd temp && gf pack template-mono-app ../internal/packed/template-mono-app.go -n=packed -y
 	@rm -fr temp

cmd/gf/gfcmd/gfcmd.go

@@ -88,6 +88,7 @@ func GetCommand(ctx context.Context) (*Command, error) {
 		cmd.Docker,
 		cmd.Install,
 		cmd.Version,
+		cmd.Doc,
 	)
 	if err != nil {
 		return nil, err

cmd/gf/go.mod

@@ -3,13 +3,13 @@ module github.com/gogf/gf/cmd/gf/v2
 go 1.18
 
 require (
-	github.com/gogf/gf/contrib/drivers/clickhouse/v2 v2.7.0
-	github.com/gogf/gf/contrib/drivers/mssql/v2 v2.7.0
-	github.com/gogf/gf/contrib/drivers/mysql/v2 v2.7.0
-	github.com/gogf/gf/contrib/drivers/oracle/v2 v2.7.0
-	github.com/gogf/gf/contrib/drivers/pgsql/v2 v2.7.0
-	github.com/gogf/gf/contrib/drivers/sqlite/v2 v2.7.0
-	github.com/gogf/gf/v2 v2.7.0
+	github.com/gogf/gf/contrib/drivers/clickhouse/v2 v2.7.2
+	github.com/gogf/gf/contrib/drivers/mssql/v2 v2.7.2
+	github.com/gogf/gf/contrib/drivers/mysql/v2 v2.7.2
+	github.com/gogf/gf/contrib/drivers/oracle/v2 v2.7.2
+	github.com/gogf/gf/contrib/drivers/pgsql/v2 v2.7.2
+	github.com/gogf/gf/contrib/drivers/sqlite/v2 v2.7.2
+	github.com/gogf/gf/v2 v2.7.2
 	github.com/gogf/selfupdate v0.0.0-20231215043001-5c48c528462f
 	github.com/olekukonko/tablewriter v0.0.5
 	golang.org/x/mod v0.17.0
@@ -18,27 +18,28 @@ require (
 
 require (
 	aead.dev/minisign v0.2.0 // indirect
-	github.com/BurntSushi/toml v1.2.0 // indirect
+	github.com/BurntSushi/toml v1.3.2 // indirect
 	github.com/ClickHouse/clickhouse-go/v2 v2.0.15 // indirect
 	github.com/clbanning/mxj/v2 v2.7.0 // indirect
-	github.com/denisenkom/go-mssqldb v0.12.3 // indirect
 	github.com/dustin/go-humanize v1.0.1 // indirect
-	github.com/fatih/color v1.15.0 // indirect
+	github.com/emirpasic/gods v1.18.1 // indirect
+	github.com/fatih/color v1.16.0 // indirect
 	github.com/fsnotify/fsnotify v1.7.0 // indirect
 	github.com/glebarez/go-sqlite v1.21.2 // indirect
 	github.com/go-logr/logr v1.2.4 // indirect
 	github.com/go-logr/stdr v1.2.2 // indirect
 	github.com/go-sql-driver/mysql v1.7.1 // indirect
-	github.com/golang-sql/civil v0.0.0-20190719163853-cb61b32ac6fe // indirect
+	github.com/golang-sql/civil v0.0.0-20220223132316-b832511892a9 // indirect
 	github.com/golang-sql/sqlexp v0.1.0 // indirect
-	github.com/google/uuid v1.3.0 // indirect
-	github.com/gorilla/websocket v1.5.0 // indirect
-	github.com/grokify/html-strip-tags-go v0.0.1 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/gorilla/websocket v1.5.1 // indirect
+	github.com/grokify/html-strip-tags-go v0.1.0 // indirect
 	github.com/lib/pq v1.10.9 // indirect
-	github.com/magiconair/properties v1.8.6 // indirect
+	github.com/magiconair/properties v1.8.7 // indirect
 	github.com/mattn/go-colorable v0.1.13 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/mattn/go-runewidth v0.0.15 // indirect
+	github.com/microsoft/go-mssqldb v1.7.1 // indirect
 	github.com/paulmach/orb v0.7.1 // indirect
 	github.com/pierrec/lz4/v4 v4.1.14 // indirect
 	github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect