Documentation
¶
Index ¶
- Constants
- func AddCommand(cli ...*CLI) error
- func Alias(alias, original string)
- func Args() []string
- func Bool(name string, value bool, usage string, item ...FlagItem) *bool
- func BoolFunc(name, usage string, fn func(string) error)
- func BoolShortLong(short, long string, value bool, usage string, item ...FlagItem) *bool
- func BoolVar(p *bool, name string, value bool, usage string, item ...FlagItem)
- func BoolVarShortLong(p *bool, short, long string, value bool, usage string, item ...FlagItem)
- func Duration(name string, value time.Duration, usage string, item ...FlagItem) *time.Duration
- func DurationShortLong(short, long string, value time.Duration, usage string, item ...FlagItem) *time.Duration
- func DurationVar(p *time.Duration, name string, value time.Duration, usage string, ...)
- func DurationVarShortLong(p *time.Duration, short, long string, value time.Duration, usage string, ...)
- func Float64(name string, value float64, usage string, item ...FlagItem) *float64
- func Float64ShortLong(short, long string, value float64, usage string, item ...FlagItem) *float64
- func Float64Var(p *float64, name string, value float64, usage string, item ...FlagItem)
- func Float64VarShortLong(p *float64, short, long string, value float64, usage string, item ...FlagItem)
- func Func(name, usage string, fn func(string) error)
- func Int(name string, value int, usage string, item ...FlagItem) *int
- func Int64(name string, value int64, usage string, item ...FlagItem) *int64
- func Int64ShortLong(short, long string, value int64, usage string, item ...FlagItem) *int64
- func Int64Var(p *int64, name string, value int64, usage string, item ...FlagItem)
- func Int64VarShortLong(p *int64, short, long string, value int64, usage string, item ...FlagItem)
- func IntShortLong(short, long string, value int, usage string, item ...FlagItem) *int
- func IntVar(p *int, name string, value int, usage string, item ...FlagItem)
- func IntVarShortLong(p *int, short, long string, value int, usage string, item ...FlagItem)
- func Lookup(name string) *flag.Flag
- func NArg() int
- func Parse() error
- func Parsed() bool
- func PasswordString(name string, value string, usage string, showNum ...int) *string
- func PasswordStringShortLong(short, long string, value string, usage string, showNum int, item ...FlagItem) *string
- func PasswordStringVar(p *string, name string, value string, usage string, showNum ...int)
- func PasswordStringVarShortLong(p *string, short, long string, value string, usage string, showNum int, ...)
- func Run() error
- func Set(name, value string) error
- func String(name string, value string, usage string, item ...FlagItem) *string
- func StringShortLong(short, long string, value string, usage string, item ...FlagItem) *string
- func StringVar(p *string, name string, value string, usage string, item ...FlagItem)
- func StringVarShortLong(p *string, short, long string, value string, usage string, item ...FlagItem)
- func Strings(name string, value []string, usage string, item ...FlagItem) *[]string
- func StringsShortLong(short, long string, value []string, usage string, item ...FlagItem) *[]string
- func StringsVar(p *[]string, name string, value []string, usage string, item ...FlagItem)
- func StringsVarShortLong(p *[]string, short, long string, value []string, usage string, ...)
- func TextVar(p encoding.TextUnmarshaler, name string, value encoding.TextMarshaler, ...)
- func Uint(name string, value uint, usage string, item ...FlagItem) *uint
- func Uint64(name string, value uint64, usage string, item ...FlagItem) *uint64
- func Uint64ShortLong(short, long string, value uint64, usage string, item ...FlagItem) *uint64
- func Uint64Var(p *uint64, name string, value uint64, usage string, item ...FlagItem)
- func Uint64VarShortLong(p *uint64, short, long string, value uint64, usage string, item ...FlagItem)
- func UintShortLong(short, long string, value uint, usage string, item ...FlagItem) *uint
- func UintVar(p *uint, name string, value uint, usage string, item ...FlagItem)
- func UintVarShortLong(p *uint, short, long string, value uint, usage string, item ...FlagItem)
- func Var(p flag.Value, name string, usage string)
- func Visit(fn func(*flag.Flag))
- func VisitAll(fn func(*flag.Flag))
- type CLI
- type CommandFunc
- type FlagItem
- type FlagItemNode
- type FlagSet
- func (f *FlagSet) Alias(alias, original string)
- func (f *FlagSet) Bool(name string, value bool, usage string, item ...FlagItem) *bool
- func (f *FlagSet) BoolShortLong(short, long string, value bool, usage string, item ...FlagItem) *bool
- func (f *FlagSet) BoolVar(p *bool, name string, value bool, usage string, item ...FlagItem)
- func (f *FlagSet) BoolVarShortLong(p *bool, short, long string, value bool, usage string, item ...FlagItem)
- func (f *FlagSet) Duration(name string, value time.Duration, usage string, item ...FlagItem) *time.Duration
- func (f *FlagSet) DurationShortLong(short, long string, value time.Duration, usage string, item ...FlagItem) *time.Duration
- func (f *FlagSet) DurationVar(p *time.Duration, name string, value time.Duration, usage string, ...)
- func (f *FlagSet) DurationVarShortLong(p *time.Duration, short, long string, value time.Duration, usage string, ...)
- func (f *FlagSet) Float64(name string, value float64, usage string, item ...FlagItem) *float64
- func (f *FlagSet) Float64ShortLong(short, long string, value float64, usage string, item ...FlagItem) *float64
- func (f *FlagSet) Float64Var(p *float64, name string, value float64, usage string, item ...FlagItem)
- func (f *FlagSet) Float64VarShortLong(p *float64, short, long string, value float64, usage string, item ...FlagItem)
- func (f *FlagSet) Int(name string, value int, usage string, item ...FlagItem) *int
- func (f *FlagSet) Int64(name string, value int64, usage string, item ...FlagItem) *int64
- func (f *FlagSet) Int64ShortLong(short, long string, value int64, usage string, item ...FlagItem) *int64
- func (f *FlagSet) Int64Var(p *int64, name string, value int64, usage string, item ...FlagItem)
- func (f *FlagSet) Int64VarShortLong(p *int64, short, long string, value int64, usage string, item ...FlagItem)
- func (f *FlagSet) IntShortLong(short, long string, value int, usage string, item ...FlagItem) *int
- func (f *FlagSet) IntVar(p *int, name string, value int, usage string, item ...FlagItem)
- func (f *FlagSet) IntVarShortLong(p *int, short, long string, value int, usage string, item ...FlagItem)
- func (f *FlagSet) Parse(arguments []string) error
- func (f *FlagSet) PasswordString(name string, value string, usage string, showNum ...int) *string
- func (f *FlagSet) PasswordStringShortLong(short, long string, value string, usage string, showNum int, item ...FlagItem) *string
- func (f *FlagSet) PasswordStringVar(p *string, name string, value string, usage string, showNum ...int)
- func (f *FlagSet) PasswordStringVarShortLong(p *string, short, long string, value string, usage string, showNum int, ...)
- func (f *FlagSet) PrintDefaults()
- func (f *FlagSet) String(name string, value string, usage string, item ...FlagItem) *string
- func (f *FlagSet) StringShortLong(short, long string, value string, usage string, item ...FlagItem) *string
- func (f *FlagSet) StringVar(p *string, name string, value string, usage string, item ...FlagItem)
- func (f *FlagSet) StringVarShortLong(p *string, short, long string, value string, usage string, item ...FlagItem)
- func (f *FlagSet) Strings(name string, value []string, usage string, item ...FlagItem) *[]string
- func (f *FlagSet) StringsShortLong(short, long string, value []string, usage string, item ...FlagItem) *[]string
- func (f *FlagSet) StringsVar(p *[]string, name string, value []string, usage string, item ...FlagItem)
- func (f *FlagSet) StringsVarShortLong(p *[]string, short, long string, value []string, usage string, ...)
- func (f *FlagSet) Uint(name string, value uint, usage string, item ...FlagItem) *uint
- func (f *FlagSet) Uint64(name string, value uint64, usage string, item ...FlagItem) *uint64
- func (f *FlagSet) Uint64ShortLong(short, long string, value uint64, usage string, item ...FlagItem) *uint64
- func (f *FlagSet) Uint64Var(p *uint64, name string, value uint64, usage string, item ...FlagItem)
- func (f *FlagSet) Uint64VarShortLong(p *uint64, short, long string, value uint64, usage string, item ...FlagItem)
- func (f *FlagSet) UintShortLong(short, long string, value uint, usage string, item ...FlagItem) *uint
- func (f *FlagSet) UintVar(p *uint, name string, value uint, usage string, item ...FlagItem)
- func (f *FlagSet) UintVarShortLong(p *uint, short, long string, value uint, usage string, item ...FlagItem)
- type FlagType
- type PasswordValue
- type ShortLongValue
- type StringsValue
- type SubCommands
- func (s *SubCommands) Add(cli ...*CLI) error
- func (s *SubCommands) CloneList() []*CLI
- func (s *SubCommands) Get(use string) *CLI
- func (s *SubCommands) GetSort() commandSort
- func (s *SubCommands) Len() int
- func (s *SubCommands) Range(f func(cli *CLI) bool)
- func (s *SubCommands) SetSort(sort commandSort)
Constants ¶
const ( // CommandSortAdded 表示按照添加顺序排序命令 CommandSortAdded commandSort = iota // CommandSortAlphaAsc 表示按照字母升序排序命令 CommandSortAlphaAsc // CommandSortAlphaDesc 表示按照字母降序排序命令 CommandSortAlphaDesc )
Variables ¶
This section is empty.
Functions ¶
func AddCommand ¶
func BoolShortLong ¶ added in v0.1.13
func BoolVarShortLong ¶ added in v0.1.13
func DurationShortLong ¶ added in v0.1.13
func DurationVar ¶
func DurationVarShortLong ¶ added in v0.1.13
func Float64ShortLong ¶ added in v0.1.13
func Float64Var ¶
func Float64VarShortLong ¶ added in v0.1.13
func Int64ShortLong ¶ added in v0.1.13
func Int64VarShortLong ¶ added in v0.1.13
func IntShortLong ¶ added in v0.1.13
func IntVarShortLong ¶ added in v0.1.13
func PasswordString ¶ added in v0.1.12
func PasswordStringShortLong ¶ added in v0.1.13
func PasswordStringVar ¶ added in v0.1.12
func PasswordStringVarShortLong ¶ added in v0.1.13
func StringShortLong ¶ added in v0.1.13
func StringVarShortLong ¶ added in v0.1.13
func StringsShortLong ¶ added in v0.1.13
func StringsVar ¶ added in v0.1.13
func StringsVarShortLong ¶ added in v0.1.13
func TextVar ¶
func TextVar(p encoding.TextUnmarshaler, name string, value encoding.TextMarshaler, usage string)
func Uint64ShortLong ¶ added in v0.1.13
func Uint64VarShortLong ¶ added in v0.1.13
func UintShortLong ¶ added in v0.1.13
func UintVarShortLong ¶ added in v0.1.13
Types ¶
type CLI ¶
type CLI struct {
// Use 是命令的名称
Use string
// Instruction 是命令被调用时显示的说明信息
Instruction string
// Usage 是在没有参数时显示的用法信息
Usage string
// CommandFunc 是该命令被调用时执行的函数
CommandFunc CommandFunc
*FlagSet
SubCommands *SubCommands
// Hidden 表示该命令在帮助中不显示
Hidden bool
// Raw 表示该命令不被解析
Raw bool
}
var CommandLine *CLI
func (*CLI) AddCommand ¶
func (*CLI) IsCompleteFlag ¶ added in v0.1.14
IsCompleteFlag 检查给定的字符串是否是一个完整的参数名
func (*CLI) IsCompleteFlagInContext ¶ added in v0.1.14
IsCompleteFlagInContext 在给定上下文中检查参数是否完整
type CommandFunc ¶
type FlagItem ¶ added in v0.1.14
type FlagItem struct {
Type FlagType
Nodes []FlagItemNode
}
func NewFlagItemDir ¶ added in v0.1.14
func NewFlagItemDir() FlagItem
func NewFlagItemFile ¶ added in v0.1.14
func NewFlagItemFile() FlagItem
func NewFlagItemSelect ¶ added in v0.1.14
func NewFlagItemSelect(nodes ...FlagItemNode) FlagItem
func NewFlagItemSelectString ¶ added in v0.1.14
type FlagItemNode ¶ added in v0.1.14
func NewFlagItemNode ¶ added in v0.1.14
func NewFlagItemNode(value string, description string) FlagItemNode
type FlagSet ¶ added in v0.1.12
type FlagSet struct {
*flag.FlagSet
ShortLongMap map[string]*ShortLongValue // 跟踪短长名关系
Item map[*ShortLongValue]FlagItem
}
func (*FlagSet) BoolShortLong ¶ added in v0.1.13
func (f *FlagSet) BoolShortLong(short, long string, value bool, usage string, item ...FlagItem) *bool
BoolShortLong 定义并返回一个带短名和长名的 bool 类型 flag 指针
func (*FlagSet) BoolVarShortLong ¶ added in v0.1.13
func (f *FlagSet) BoolVarShortLong(p *bool, short, long string, value bool, usage string, item ...FlagItem)
BoolVarShortLong 定义一个带短名和长名的 bool 类型 flag
func (*FlagSet) Duration ¶ added in v0.1.14
func (f *FlagSet) Duration(name string, value time.Duration, usage string, item ...FlagItem) *time.Duration
Duration 定义并返回一个 time.Duration 类型 flag 指针 (支持 FlagItem)
func (*FlagSet) DurationShortLong ¶ added in v0.1.13
func (f *FlagSet) DurationShortLong(short, long string, value time.Duration, usage string, item ...FlagItem) *time.Duration
DurationShortLong 定义并返回一个带短名和长名的 time.Duration 类型 flag 指针
func (*FlagSet) DurationVar ¶ added in v0.1.14
func (f *FlagSet) DurationVar(p *time.Duration, name string, value time.Duration, usage string, item ...FlagItem)
DurationVar 定义一个 time.Duration 类型 flag (支持 FlagItem)
func (*FlagSet) DurationVarShortLong ¶ added in v0.1.13
func (f *FlagSet) DurationVarShortLong(p *time.Duration, short, long string, value time.Duration, usage string, item ...FlagItem)
DurationVarShortLong 定义一个带短名和长名的 time.Duration 类型 flag
func (*FlagSet) Float64ShortLong ¶ added in v0.1.13
func (f *FlagSet) Float64ShortLong(short, long string, value float64, usage string, item ...FlagItem) *float64
Float64ShortLong 定义并返回一个带短名和长名的 float64 类型 flag 指针
func (*FlagSet) Float64Var ¶ added in v0.1.14
func (f *FlagSet) Float64Var(p *float64, name string, value float64, usage string, item ...FlagItem)
Float64Var 定义一个 float64 类型 flag (支持 FlagItem)
func (*FlagSet) Float64VarShortLong ¶ added in v0.1.13
func (f *FlagSet) Float64VarShortLong(p *float64, short, long string, value float64, usage string, item ...FlagItem)
Float64VarShortLong 定义一个带短名和长名的 float64 类型 flag
func (*FlagSet) Int64ShortLong ¶ added in v0.1.13
func (f *FlagSet) Int64ShortLong(short, long string, value int64, usage string, item ...FlagItem) *int64
Int64ShortLong 定义并返回一个带短名和长名的 int64 类型 flag 指针
func (*FlagSet) Int64VarShortLong ¶ added in v0.1.13
func (f *FlagSet) Int64VarShortLong(p *int64, short, long string, value int64, usage string, item ...FlagItem)
Int64VarShortLong 定义一个带短名和长名的 int64 类型 flag
func (*FlagSet) IntShortLong ¶ added in v0.1.13
IntShortLong 定义并返回一个带短名和长名的 int 类型 flag 指针
func (*FlagSet) IntVarShortLong ¶ added in v0.1.13
func (f *FlagSet) IntVarShortLong(p *int, short, long string, value int, usage string, item ...FlagItem)
IntVarShortLong 定义一个带短名和长名的 int 类型 flag
func (*FlagSet) PasswordString ¶ added in v0.1.12
PasswordString 定义并返回一个密码字符串类型 flag 指针
func (*FlagSet) PasswordStringShortLong ¶ added in v0.1.13
func (f *FlagSet) PasswordStringShortLong(short, long string, value string, usage string, showNum int, item ...FlagItem) *string
PasswordStringShortLong 定义并返回一个带短名和长名的密码字符串类型 flag 指针 showNum: 0 表示*数量与 value 一致
func (*FlagSet) PasswordStringVar ¶ added in v0.1.12
func (f *FlagSet) PasswordStringVar(p *string, name string, value string, usage string, showNum ...int)
PasswordStringVar 定义一个密码字符串类型 flag,在帮助信息中密码值会被隐藏
func (*FlagSet) PasswordStringVarShortLong ¶ added in v0.1.13
func (f *FlagSet) PasswordStringVarShortLong(p *string, short, long string, value string, usage string, showNum int, item ...FlagItem)
PasswordStringVarShortLong 定义一个带短名和长名的密码字符串类型 flag showNum: 0 表示*数量与 value 一致
func (*FlagSet) PrintDefaults ¶ added in v0.1.13
func (f *FlagSet) PrintDefaults()
PrintDefaults 自定义帮助信息显示,将短长名合并显示
func (*FlagSet) StringShortLong ¶ added in v0.1.13
func (f *FlagSet) StringShortLong(short, long string, value string, usage string, item ...FlagItem) *string
StringShortLong 定义并返回一个带短名和长名的 string 类型 flag 指针
func (*FlagSet) StringVarShortLong ¶ added in v0.1.13
func (f *FlagSet) StringVarShortLong(p *string, short, long string, value string, usage string, item ...FlagItem)
StringVarShortLong 定义一个带短名和长名的 string 类型 flag
func (*FlagSet) StringsShortLong ¶ added in v0.1.13
func (f *FlagSet) StringsShortLong(short, long string, value []string, usage string, item ...FlagItem) *[]string
StringsShortLong 定义并返回一个带短名和长名的字符串切片类型 flag 指针
func (*FlagSet) StringsVar ¶ added in v0.1.13
func (f *FlagSet) StringsVar(p *[]string, name string, value []string, usage string, item ...FlagItem)
StringsVar 定义一个字符串切片类型 flag (支持 FlagItem)
func (*FlagSet) StringsVarShortLong ¶ added in v0.1.13
func (f *FlagSet) StringsVarShortLong(p *[]string, short, long string, value []string, usage string, item ...FlagItem)
StringsVarShortLong 定义一个带短名和长名的字符串切片类型 flag
func (*FlagSet) Uint64ShortLong ¶ added in v0.1.13
func (f *FlagSet) Uint64ShortLong(short, long string, value uint64, usage string, item ...FlagItem) *uint64
Uint64ShortLong 定义并返回一个带短名和长名的 uint64 类型 flag 指针
func (*FlagSet) Uint64VarShortLong ¶ added in v0.1.13
func (f *FlagSet) Uint64VarShortLong(p *uint64, short, long string, value uint64, usage string, item ...FlagItem)
Uint64VarShortLong 定义一个带短名和长名的 uint64 类型 flag
func (*FlagSet) UintShortLong ¶ added in v0.1.13
func (f *FlagSet) UintShortLong(short, long string, value uint, usage string, item ...FlagItem) *uint
UintShortLong 定义并返回一个带短名和长名的 uint 类型 flag 指针
type PasswordValue ¶ added in v0.1.13
type PasswordValue struct {
// contains filtered or unexported fields
}
func (*PasswordValue) Get ¶ added in v0.1.13
func (p *PasswordValue) Get() any
func (*PasswordValue) Set ¶ added in v0.1.13
func (p *PasswordValue) Set(s string) error
func (*PasswordValue) String ¶ added in v0.1.13
func (p *PasswordValue) String() string
type ShortLongValue ¶ added in v0.1.13
func (*ShortLongValue) Get ¶ added in v0.1.13
func (sl *ShortLongValue) Get() any
func (*ShortLongValue) GetNames ¶ added in v0.1.13
func (sl *ShortLongValue) GetNames() string
func (*ShortLongValue) Set ¶ added in v0.1.13
func (sl *ShortLongValue) Set(s string) error
func (*ShortLongValue) String ¶ added in v0.1.13
func (sl *ShortLongValue) String() string
type StringsValue ¶ added in v0.1.13
type StringsValue []string
func (*StringsValue) Get ¶ added in v0.1.13
func (s *StringsValue) Get() any
func (*StringsValue) Set ¶ added in v0.1.13
func (s *StringsValue) Set(value string) error
func (*StringsValue) String ¶ added in v0.1.13
func (s *StringsValue) String() string
type SubCommands ¶ added in v0.1.14
type SubCommands struct {
// contains filtered or unexported fields
}
func (*SubCommands) Add ¶ added in v0.1.14
func (s *SubCommands) Add(cli ...*CLI) error
func (*SubCommands) CloneList ¶ added in v0.1.14
func (s *SubCommands) CloneList() []*CLI
func (*SubCommands) Get ¶ added in v0.1.14
func (s *SubCommands) Get(use string) *CLI
func (*SubCommands) GetSort ¶ added in v0.1.14
func (s *SubCommands) GetSort() commandSort
func (*SubCommands) Len ¶ added in v0.1.14
func (s *SubCommands) Len() int
func (*SubCommands) Range ¶ added in v0.1.14
func (s *SubCommands) Range(f func(cli *CLI) bool)
func (*SubCommands) SetSort ¶ added in v0.1.14
func (s *SubCommands) SetSort(sort commandSort)
Directories
¶
| Path | Synopsis |
|---|---|
|
completion_exec 是一个可执行的二进制工具,用于解析 Go 项目代码 它能识别使用 github.com/Rehtt/Kit/cli 注册的命令和 flag 并生成对应的 shell 补全脚本(支持 bash/zsh/fish)
|
completion_exec 是一个可执行的二进制工具,用于解析 Go 项目代码 它能识别使用 github.com/Rehtt/Kit/cli 注册的命令和 flag 并生成对应的 shell 补全脚本(支持 bash/zsh/fish) |