Merge pull request #69 from gookit/dev

Author: inhere

.github/workflows/go.yml

@@ -18,7 +18,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        go_version: [1.18, 1.19]
+        go_version: [1.17, 1.18, 1.19]
 
     steps:
     - name: Check out codes
@@ -31,7 +31,7 @@ jobs:
         go-version: ${{ matrix.go_version }}
 
     - name: Revive check
-      uses: morphy2k/[email protected].0
+      uses: morphy2k/[email protected].1
       if: ${{ matrix.os == 'ubuntu-latest' }}
       with:
         # Exclude patterns, separated by semicolons (optional)

README.md

@@ -4,7 +4,7 @@
 [![Actions Status](https://github.com/gookit/gcli/workflows/action-tests/badge.svg)](https://github.com/gookit/gcli/actions)
 [![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/gookit/gcli)](https://github.com/gookit/gcli)
 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/4f071e6858fb4117b6c1376c9316d8ef)](https://www.codacy.com/gh/gookit/gcli/dashboard?utm_source=github.com&utm_medium=referral&utm_content=gookit/gcli&utm_campaign=Badge_Grade)
-[![GoDoc](https://godoc.org/github.com/gookit/gcli?status.svg)](https://pkg.go.dev/github.com/gookit/gcli/v3)
+[![Go Reference](https://pkg.go.dev/badge/github.com/gookit/goutil.svg)](https://pkg.go.dev/github.com/gookit/goutil)
 [![Go Report Card](https://goreportcard.com/badge/github.com/gookit/gcli)](https://goreportcard.com/report/github.com/gookit/gcli)
 [![Coverage Status](https://coveralls.io/repos/github/gookit/gcli/badge.svg?branch=master)](https://coveralls.io/github/gookit/gcli?branch=master)
 

README.zh-CN.md

@@ -4,7 +4,7 @@
 [![Actions Status](https://github.com/gookit/gcli/workflows/action-tests/badge.svg)](https://github.com/gookit/gcli/actions)
 [![GitHub tag (latest SemVer)](https://img.shields.io/github/tag/gookit/gcli)](https://github.com/gookit/gcli)
 [![Codacy Badge](https://app.codacy.com/project/badge/Grade/4f071e6858fb4117b6c1376c9316d8ef)](https://www.codacy.com/gh/gookit/gcli/dashboard?utm_source=github.com&utm_medium=referral&utm_content=gookit/gcli&utm_campaign=Badge_Grade)
-[![GoDoc](https://godoc.org/github.com/gookit/gcli?status.svg)](https://pkg.go.dev/github.com/gookit/gcli/v3)
+[![Go Reference](https://pkg.go.dev/badge/github.com/gookit/goutil.svg)](https://pkg.go.dev/github.com/gookit/goutil)
 [![Go Report Card](https://goreportcard.com/badge/github.com/gookit/gcli)](https://goreportcard.com/report/github.com/gookit/gcli)
 [![Coverage Status](https://coveralls.io/repos/github/gookit/gcli/badge.svg?branch=master)](https://coveralls.io/github/gookit/gcli?branch=master)
 

_examples/cliapp/main.go

@@ -1,29 +1,35 @@
 package main
 
 import (
+	"fmt"
+
 	"github.com/gookit/color"
 	"github.com/gookit/gcli/v3"
 	"github.com/gookit/gcli/v3/_examples/cmd"
 	"github.com/gookit/gcli/v3/builtin"
+	"github.com/gookit/gcli/v3/events"
 	// "github.com/gookit/gcli/v3/builtin/filewatcher"
 	// "github.com/gookit/gcli/v3/builtin/reverseproxy"
 )
 
+var customGOpt string
+
 // local run:
 //
 //	go run ./_examples/cliapp
 //	go build ./_examples/cliapp && ./cliapp
 //
 // run on windows(cmd, powerShell):
 //
+//	go run ./_examples/cliapp
 //	go build ./_examples/cliapp && ./cliapp
 func main() {
 	app := gcli.NewApp(func(app *gcli.App) {
 		app.Version = "3.0.0"
 		app.Desc = "this is my cli application"
-		app.On(gcli.EvtAppInit, func(data ...any) bool {
+		app.On(gcli.EvtAppInit, func(ctx *gcli.HookCtx) bool {
 			// do something...
-			// fmt.Println("init app")
+			fmt.Println("init app event", ctx.Name())
 			return false
 		})
 
@@ -40,11 +46,17 @@ func main() {
 	// disable global options
 	// gcli.GOpts().SetDisable()
 
-	var customGOpt string
-	app.GOptsBinder = func(gf *gcli.Flags) {
-		// gcli.Logf(gcli.VerbInfo, "custom add and global option flag")
-		gf.StrVar(&customGOpt, &gcli.FlagMeta{Name: "custom", Desc: "desc message for the option"})
-	}
+	// app.BeforeAddOpts = func(opts *gcli.Flags) {
+	// 	opts.StrVar(&customGOpt, &gcli.FlagMeta{Name: "custom", Desc: "desc message for the option"})
+	// }
+
+	app.On(events.OnAppBindOptsAfter, func(ctx *gcli.HookCtx) (stop bool) {
+		ctx.App.Flags().StrVar(&customGOpt, &gcli.FlagMeta{
+			Name: "custom",
+			Desc: "desc message for the option",
+		})
+		return false
+	})
 
 	// app.Strict = true
 	app.Add(cmd.GitCmd)

_examples/cmd/example.go

@@ -8,7 +8,7 @@ import (
 	"github.com/gookit/goutil/dump"
 )
 
-// The string flag list, implemented flag.Value interface
+// Names The string flag list, implemented flag.Value interface
 type Names []string
 
 func (ns *Names) String() string {
@@ -64,7 +64,8 @@ var Example = &gcli.Command{
 
 // command running
 // example run:
-// 	go run ./_examples/cliapp.go ex -c some.txt -d ./dir --id 34 -n tom -n john val0 val1 val2 arrVal0 arrVal1 arrVal2
+//
+//	go run ./_examples/cliapp.go ex -c some.txt -d ./dir --id 34 -n tom -n john val0 val1 val2 arrVal0 arrVal1 arrVal2
 func exampleExecute(c *gcli.Command, args []string) error {
 	color.Infoln("hello, in example command")
 

builtin/sflag/README.md _examples/sflag/README.md

@@ -0,0 +1,7 @@
+//go:build !go1.18
+// +build !go1.18
+
+package gcli
+
+// alias of interface{}, use for go < 1.18
+type any = interface{}