- change cobra back to spf13/cobra

- update example
- update README.md

Author: hujun-open

README.md

@@ -31,9 +31,14 @@ the created flags:
 ```
 .\cptool summaryhelp
   = cptool [flags]
-    --backupaddrlist: backup server address list
+    -b, --backupaddrlist: backup server address list
+        default:1.1.1.1,2.2.2.2
     -c, --configfile: working profile
         default:default.conf
+    -f, --floatlist: list of numbers
+        default:1.7,2.2,3.3
+    --strlist: list of string
+        default:a,bb,ccc
     --svraddr: server address to download the archive
         default:<nil>
     = cptool compress
@@ -87,12 +92,12 @@ the created flags:
         default:false
 ```
 some parsing results:
-```
-.\cptool --svraddr 1.1.1.1 --backupaddrlist 2.2.2.2,2001:dead::1 compress -l 3  zipfile  input1 out.zip         
-zipfile &{ConfigFile:default.conf SvrAddr:1.1.1.1 BackupAddrList:[2.2.2.2 2001:dead::1] Arg1: Compress:{Loop:3 Profile: Skip:false NoFlag: DryRun:{} ZipFolder:{FolderName: ArchiveName: CreationTime:2025-01-02 03:04:05 +0000 UTC} ZipFile:{FileName:input1 ArchiveName:out.zip}} Extract:{InputFile: OutputFolder:}}
+```        
+./cptool --svraddr 1.1.1.1 --backupaddrlist 2.2.2.2,2001:dead::1 compress -l 3  zipfile  input1 out.zip
+zipfile &{ConfigFile:default.conf SvrAddr:1.1.1.1 BackupAddrList:[2.2.2.2 2001:dead::1] FloatList:[1.7 2.2 3.3] StrList:[a bb ccc] Compress:{Loop:3 Profile: Skip:false NoFlag: DryRun:{} ZipFolder:{FolderName: ArchiveName: CreationTime:2025-01-02 03:04:05 +0000 UTC} ZipFile:{FileName:input1 ArchiveName:out.zip}} Extract:{InputFile: OutputFolder:}}
 
 .\cptool compress zipfolder folder1 out.zip "2030 01 Jun 13:01" -l 99
-zipfolder &{ConfigFile:default.conf SvrAddr:<nil> BackupAddrList:[] Arg1: Compress:{Loop:99 Profile: Skip:false NoFlag: DryRun:{} ZipFolder:{FolderName:folder1 ArchiveName:out.zip CreationTime:2030-06-01 13:01:00 +0000 UTC} ZipFile:{FileName:defaultzip.file ArchiveName:}} Extract:{InputFile: OutputFolder:}}
+zipfolder &{ConfigFile:default.conf SvrAddr:<nil> BackupAddrList:[1.1.1.1 2.2.2.2] FloatList:[1.7 2.2 3.3] StrList:[a bb ccc] Compress:{Loop:99 Profile: Skip:false NoFlag: DryRun:{} ZipFolder:{FolderName:folder1 ArchiveName:out.zip CreationTime:2030-06-01 13:01:00 +0000 UTC} ZipFile:{FileName:defaultzip.file ArchiveName:}} Extract:{InputFile: OutputFolder:}}
 ```
 
 
@@ -117,32 +122,36 @@ Base:
 - string
 - bool
 
-provided by `github.com/hujun-open/myflags/v2/types`:
+following are provided by `github.com/hujun-open/myflags/v2/types`:
 
 - all int/uint types: support `base` tag for the base
 - net.HardwareAddr
 - net.IPNet
 - net.IP
 - time.Time
 - time.Duration
-- all int/uint types
 
 Others:
 - All types implement both of following interface:
-    - `encoding.TextUnmarshaler`
+    - `encoding.TextMarshaler`
     - `encoding.TextUnmarshaler`
 - All type register via `myflags.Register` function
 
 Note: flag is only created for exported struct field.
 
+### Slice / Array
 
 In addition to above types, following types are also supported:
 
 - pointer to the type above
 - slice/array of type above
 - slice/array of pointer to the type above
 
-for slice/array, use "," as separator. 
+Use "," as separator of items in the input string
+
+note: if the item type is struct, then it must be either registered type or implements `encoding.TextMarshaler`/`encoding.TextUnmarshaler`
+
+### Nested / Embeded struct
 
 myflags also supports following type of struct:
 

docgen.go

@@ -5,8 +5,8 @@ import (
 	"log"
 	"strconv"
 
-	"github.com/hujun-open/cobra"
-	"github.com/hujun-open/cobra/doc"
+	"github.com/spf13/cobra"
+	"github.com/spf13/cobra/doc"
 )
 
 type genDoc struct {

example/go.mod

@@ -3,16 +3,16 @@ module cptool
 go 1.20
 
 require (
-	github.com/hujun-open/cobra v0.3.0
 	github.com/hujun-open/myflags/v2 v2.0.1
+	github.com/spf13/cobra v1.10.1
 
 )
 
 require (
 	github.com/cpuguy83/go-md2man/v2 v2.0.6 // indirect
 	github.com/inconshreveable/mousetrap v1.1.0 // indirect
 	github.com/russross/blackfriday/v2 v2.1.0 // indirect
-	github.com/spf13/pflag v1.0.7 // indirect
+	github.com/spf13/pflag v1.0.9 // indirect
 	golang.org/x/exp v0.0.0-20230801115018-d63ba01acd4b // indirect
 	gopkg.in/yaml.v3 v3.0.1 // indirect
 )

example/main.go

@@ -6,16 +6,16 @@ import (
 	"net/netip"
 	"time"
 
-	"github.com/hujun-open/cobra"
 	"github.com/hujun-open/myflags/v2"
 	_ "github.com/hujun-open/myflags/v2/types"
+	"github.com/spf13/cobra"
 )
 
 type ZipCLI struct {
 	ConfigFile     string       `short:"c" usage:"working profile"`
 	SvrAddr        net.IP       `usage:"server address to download the archive" complete:"SvrComplete"` //using completer method SvrComplete for shell completion
 	BackupAddrList []netip.Addr `short:"b" usage:"backup server address list"`
-	IntList        []float32    `short:"i" usage:"list of numbers"`
+	FloatList      []float32    `short:"f" usage:"list of numbers"`
 	StrList        []string     `usage:"list of string"`
 	Compress       struct {
 		Loop      uint   `base:"16" short:"l" usage:"number of compress iterations"`
@@ -79,7 +79,7 @@ func main() {
 	}
 	zipcli.BackupAddrList = []netip.Addr{netip.MustParseAddr("1.1.1.1"), netip.MustParseAddr("2.2.2.2")}
 	zipcli.Compress.Loop = 0x20
-	zipcli.IntList = []float32{1.7, 2.2, 3.3}
+	zipcli.FloatList = []float32{1.7, 2.2, 3.3}
 	zipcli.Compress.ZipFile.FileName = "defaultzip.file"
 	zipcli.Compress.ZipFolder.CreationTime = time.Date(2025, 1, 2, 3, 4, 5, 0, time.UTC)
 

flagvalidvalues.go

@@ -3,7 +3,7 @@ package myflags
 import (
 	"strings"
 
-	"github.com/hujun-open/cobra"
+	"github.com/spf13/cobra"
 )
 
 // validFlagValues is a helper struct used to support ValidValuesTag

go.mod

@@ -3,8 +3,8 @@ module github.com/hujun-open/myflags/v2
 go 1.20
 
 require (
-	github.com/hujun-open/cobra v0.3.0
-	github.com/spf13/pflag v1.0.7
+	github.com/spf13/cobra v1.10.1
+	github.com/spf13/pflag v1.0.9
 	golang.org/x/exp v0.0.0-20230801115018-d63ba01acd4b
 )
 

go.sum

@@ -1,13 +1,13 @@
 github.com/cpuguy83/go-md2man/v2 v2.0.6 h1:XJtiaUW6dEEqVuZiMTn1ldk455QWwEIsMIJlo5vtkx0=
 github.com/cpuguy83/go-md2man/v2 v2.0.6/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=
-github.com/hujun-open/cobra v0.3.0 h1:S40jvWTCocUzG+dExWP8lOSfPaYdWacw1QOhmdlMNvM=
-github.com/hujun-open/cobra v0.3.0/go.mod h1:Bfy9ZzyA06VIvmbowRPx0O6dcvx8jv6iVfRVBq5EUAE=
 github.com/inconshreveable/mousetrap v1.1.0 h1:wN+x4NVGpMsO7ErUn/mUI3vEoE6Jt13X2s0bqwp9tc8=
 github.com/inconshreveable/mousetrap v1.1.0/go.mod h1:vpF70FUmC8bwa3OWnCshd2FqLfsEA9PFc4w1p2J65bw=
 github.com/russross/blackfriday/v2 v2.1.0 h1:JIOH55/0cWyOuilr9/qlrm0BSXldqnqwMsf35Ld67mk=
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
-github.com/spf13/pflag v1.0.7 h1:vN6T9TfwStFPFM5XzjsvmzZkLuaLX+HS+0SeFLRgU6M=
-github.com/spf13/pflag v1.0.7/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
+github.com/spf13/cobra v1.10.1 h1:lJeBwCfmrnXthfAupyUTzJ/J4Nc1RsHC/mSRU2dll/s=
+github.com/spf13/cobra v1.10.1/go.mod h1:7SmJGaTHFVBY0jW4NXGluQoLvhqFQM+6XSKD+P4XaB0=
+github.com/spf13/pflag v1.0.9 h1:9exaQaMOCwffKiiiYk6/BndUBv+iRViNW+4lEMi0PvY=
+github.com/spf13/pflag v1.0.9/go.mod h1:McXfInJRrz4CZXVZOBLb0bTZqETkiAhM9Iw0y3An2Bg=
 golang.org/x/exp v0.0.0-20230801115018-d63ba01acd4b h1:r+vk0EmXNmekl0S0BascoeeoHk/L7wmaW2QF90K+kYI=
 golang.org/x/exp v0.0.0-20230801115018-d63ba01acd4b/go.mod h1:FXUEEKJgO7OQYeo8N01OfiKP8RXMtf6e8aTskBGqWdc=
 gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405 h1:yhCVgyC4o1eVCa2tZl7eS0r+SDo693bJlVdllGtEeKM=

myflags.go

@@ -14,7 +14,7 @@ import (
 	flag "github.com/spf13/pflag"
 	"golang.org/x/exp/slices"
 
-	"github.com/hujun-open/cobra"
+	"github.com/spf13/cobra"
 )
 
 // encodingTextMarshaler is the interface includes both encoding.TextMarshaler and encoding.TextUnmarshaler

myflags_test.go

@@ -9,7 +9,7 @@ import (
 	"testing"
 	"time"
 
-	"github.com/hujun-open/cobra"
+	"github.com/spf13/cobra"
 	flag "github.com/spf13/pflag"
 
 	"github.com/hujun-open/myflags/v2"

noun.go

@@ -9,7 +9,7 @@ import (
 	"text/tabwriter"
 	"unicode"
 
-	"github.com/hujun-open/cobra"
+	"github.com/spf13/cobra"
 	"golang.org/x/exp/slices"
 )