cli

type AddFlagOptions struct {
	// This function must return a slice of regexps to be matched agains all environment variables.
	// Values of matched environment variables will become the flag value. Values priority (from
	// lowest to highest): flag default value -> environment variable value (from first to last
	// regexp; if regexp matches multiple env vars then the last has higher priority) -> cli flag
	// value. For slice and map-type flags: all env vars values and all cli flags values are joined.
	GetEnvVarRegexesFunc GetFlagEnvVarRegexesInterface

	// Group info is saved in Flag annotations, which can be used later, e.g. for grouping flags in
	// the --help output.
	Group *FlagGroup

	Type            FlagType
	ShortName       string
	Deprecated      bool
	Hidden          bool
	Required        bool
	NoSplitOnCommas bool
}

type CommandGroup struct {
	// Unique group identifier.
	ID string
	// Human-readable group title, expected to be used in the usage output.
	Title string
	// CommandGroup priority, expected to be used to sort groups in the usage output.
	Priority int
}

type FlagGroup struct {
	// Unique group identifier.
	ID string
	// Human-readable group title, expected to be used in the usage output.
	Title string
	// FlagGroup priority, expected to be used to sort groups in the usage output.
	Priority int
}

type FlagRegexExpr struct {
	Expr  string
	Human string
}

type FlagType string

type GetFlagEnvVarRegexesInterface func(cmd *cobra.Command, flagName string) ([]*FlagRegexExpr, error)

type GroupCommandOptions struct{}

type SubCommandOptions struct {
	Args              cobra.PositionalArgs
	ValidArgsFunction func(cmd *cobra.Command, args []string, toComplete string) ([]string, cobra.ShellCompDirective)
}