up: update some for gflag parse and app init logic

app.go

@@ -56,7 +56,7 @@ type App struct {
 	// AppConfig
 
 	fs *Flags
-	// app flag options
+	// cli input options for app
 	opts *GlobalOpts
 
 	// Name app name
@@ -103,21 +103,21 @@ func NewApp(fns ...func(app *App)) *App {
 		Desc: "This is my console application",
 	}
 
-	app.fs = gflag.New("appOpts").WithConfigFn(func(opt *gflag.Config) {
+	app.fs = gflag.New(app.Name).WithConfigFn(func(opt *gflag.Config) {
 		opt.WithoutType = true
 		opt.Alignment = gflag.AlignLeft
 	})
 
 	Logf(VerbCrazy, "create a new cli application, and create base ")
 
-	// set a default version
-	app.Version = "1.0.0"
-	app.Context = gCtx
-
 	// init base
 	app.base = newBase()
 	app.opts = newGlobalOpts()
 
+	// set a default version
+	app.Version = "1.0.0"
+	app.Context = gCtx
+
 	for _, fn := range fns {
 		fn(app)
 	}
@@ -224,7 +224,6 @@ func (app *App) AddCommand(c *Command) {
 
 	// do add command
 	app.addCommand(app.Name, c)
-
 	app.fireWithCmd(events.OnCmdInit, c, nil)
 }
 

base.go

@@ -201,7 +201,7 @@ func newBase() base {
 		cmdAliases: structs.NewAliases(aliasNameCheck),
 		// ExitOnEnd:  false,
 		tplVars: make(map[string]any),
-		Context: NewCtx(),
+		// Context: NewCtx(),
 	}
 }
 

cmd.go

@@ -126,13 +126,13 @@ func NewCommand(name, desc string, setFn ...func(c *Command)) *Command {
 		Desc: desc,
 	}
 
+	// init set name
+	c.Flags.SetName(name)
+
 	// has config func
 	if len(setFn) > 0 {
 		c.Config = setFn[0]
 	}
-
-	// set name
-	c.Arguments.SetName(name)
 	return c
 }
 
@@ -263,8 +263,7 @@ func (c *Command) initialize() {
 	}
 
 	// init for cmd Arguments
-	c.Arguments.SetName(cName)
-	// c.Arguments.SetValidateNum(gOpts.strictMode)
+	c.Flags.SetName(cName)
 
 	// init for cmd flags
 	c.InitFlagSet(cName)

gflag/args.go

@@ -17,7 +17,7 @@ import (
 
 // Arguments definition
 type Arguments struct {
-	// Inherited from Command
+	// name inherited from gcli.Command
 	name string
 	// args definition for a command.
 	//

gflag/opts.go

@@ -16,9 +16,13 @@ import (
 
 // CliOpts cli options manage TODO
 type CliOpts struct {
+	// name inherited from gcli.Command
+	name string
+
 	// the options flag set TODO remove flag.FlagSet, custom implement parse
 	fSet *flag.FlagSet
-	// all option names of the command. {name: length} // TODO delete, move len to opts.
+	// all cli option names.
+	// format: {name: length} // TODO delete, move len to opts.
 	names map[string]int
 	// metadata for all options
 	opts map[string]*CliOpt // TODO support option category
@@ -31,7 +35,7 @@ type CliOpts struct {
 	// eg: "-V, --version" length is 13
 	optMaxLen int
 	// exist short names. useful for render help
-	existShort bool
+	hasShort bool
 }
 
 // InitFlagSet create and init flag.FlagSet
@@ -44,13 +48,19 @@ func (ops *CliOpts) InitFlagSet(name string) {
 	// 	ops.cfg = newDefaultFlagConfig()
 	// }
 
+	ops.name = name
 	ops.fSet = flag.NewFlagSet(name, flag.ContinueOnError)
 	// disable output internal error message on parse flags
 	ops.fSet.SetOutput(io.Discard)
 	// nothing to do ... render usage on after parsed
 	ops.fSet.Usage = func() {}
 }
 
+// SetName for Arguments
+func (ops *CliOpts) SetName(name string) {
+	ops.name = name
+}
+
 /***********************************************************************
  * Options:
  * - binding option var
@@ -319,7 +329,7 @@ func (ops *CliOpts) checkShortNames(name string, shorts []string) {
 		return
 	}
 
-	ops.existShort = true
+	ops.hasShort = true
 	if ops.shorts == nil {
 		ops.shorts = map[string]string{}
 	}

gflag/parser.go

@@ -31,6 +31,7 @@ type Parser struct {
 	// --- cli arguments ---
 	Arguments
 
+	name string
 	// Desc message
 	Desc string
 	// AfterParse options hook
@@ -73,6 +74,13 @@ func New(nameWithDesc ...string) *Parser {
 	return p
 }
 
+// SetName for parser
+func (p *Parser) SetName(name string) {
+	p.name = name
+	p.CliOpts.SetName(name)
+	p.Arguments.SetName(name)
+}
+
 // SetConfig for the object.
 func (p *Parser) SetConfig(opt *Config) { p.cfg = opt }
 

help.go

@@ -6,6 +6,7 @@ import (
 
 	"github.com/gookit/color"
 	"github.com/gookit/gcli/v3/helper"
+	"github.com/gookit/goutil/maputil"
 	"github.com/gookit/goutil/strutil"
 )
 
@@ -58,7 +59,7 @@ Use "<cyan>{$binName} COMMAND -h</>" for more information about a command
 
 // display app help and list all commands. showCommandList()
 func (app *App) showApplicationHelp() bool {
-	Debugf("render application help and commands list")
+	Debugf("render application help and commands list, help.pairs=%s", maputil.ToString2(app.Vars))
 
 	// cmdHelpTemplate = color.ReplaceTag(cmdHelpTemplate)
 	// render help text template