flag

package
v0.0.0-...-5ad4795 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Aug 14, 2023 License: MIT Imports: 10 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func InitFlags 

func InitFlags(flags *pflag.FlagSet)

InitFlags normalizes, parses, then logs the command line flags.

func PrintFlags 

func PrintFlags(flags *pflag.FlagSet)

PrintFlags logs the flags in the flagset.

func PrintSections 

func PrintSections(w io.Writer, fss NamedFlagSets, cols int)

PrintSections prints the given names flag sets in sections, with the maximal given column number. If cols is zero, lines are not wrapped.

func WarnWordSepNormalizeFunc 

func WarnWordSepNormalizeFunc(f *pflag.FlagSet, name string) pflag.NormalizedName

WarnWordSepNormalizeFunc changes and warns for flags that contain "_" separators.

func WordSepNormalizeFunc 

func WordSepNormalizeFunc(f *pflag.FlagSet, name string) pflag.NormalizedName

WordSepNormalizeFunc changes all flags that contain "_" separators.

Types

type ColonSeparatedMultimapStringString 

type ColonSeparatedMultimapStringString struct {
	Multimap *map[string][]string
	// contains filtered or unexported fields
}

ColonSeparatedMultimapStringString supports setting a map[string][]string from an encoding that separates keys from values with ':' and separates key-value pairs with ','. A key can be repeated multiple times, in which case the values are appended to a slice of strings associated with that key. Items in the list associated with a given key will appear in the order provided. For example: `a:hello,b:again,c:world,b:beautiful` results in `{"a": ["hello"], "b": ["again", "beautiful"], "c": ["world"]}` The first call to Set will clear the map before adding entries; subsequent calls will simply append to the map. This makes it possible to override default values with a command-line option rather than appending to defaults, while still allowing the distribution of key-value pairs across multiple flag invocations. For example: `--flag "a:hello" --flag "b:again" --flag "b:beautiful" --flag "c:world"` results in `{"a": ["hello"], "b": ["again", "beautiful"], "c": ["world"]}`.

func NewColonSeparatedMultimapStringString 

func NewColonSeparatedMultimapStringString(m *map[string][]string) *ColonSeparatedMultimapStringString

NewColonSeparatedMultimapStringString takes a pointer to a map[string][]string and returns the ColonSeparatedMultimapStringString flag parsing shim for that map.

func (*ColonSeparatedMultimapStringString) Empty 

func (m *ColonSeparatedMultimapStringString) Empty() bool

Empty implements OmitEmpty.

func (*ColonSeparatedMultimapStringString) Set 

func (m *ColonSeparatedMultimapStringString) Set(value string) error

Set implements github.com/spf13/pflag.Value.

func (*ColonSeparatedMultimapStringString) String 

func (m *ColonSeparatedMultimapStringString) String() string

String implements github.com/spf13/pflag.Value.

func (*ColonSeparatedMultimapStringString) Type 

func (m *ColonSeparatedMultimapStringString) Type() string

Type implements github.com/spf13/pflag.Value.

type ConfigurationMap 

type ConfigurationMap map[string]string

func (*ConfigurationMap) Set 

func (m *ConfigurationMap) Set(value string) error

func (*ConfigurationMap) String 

func (m *ConfigurationMap) String() string

func (*ConfigurationMap) Type 

func (*ConfigurationMap) Type() string

type LangleSeparatedMapStringString 

type LangleSeparatedMapStringString struct {
	Map *map[string]string
	// contains filtered or unexported fields
}

LangleSeparatedMapStringString can be set from the command line with the format `--flag "string<string"`. Multiple comma-separated key-value pairs in a single invocation are supported. For example: `--flag "a<foo,b<bar"`. Multiple flag invocations are supported. For example: `--flag "a<foo" --flag "b<foo"`.

func NewLangleSeparatedMapStringString 

func NewLangleSeparatedMapStringString(m *map[string]string) *LangleSeparatedMapStringString

NewLangleSeparatedMapStringString takes a pointer to a map[string]string and returns the LangleSeparatedMapStringString flag parsing shim for that map.

func (*LangleSeparatedMapStringString) Empty 

func (m *LangleSeparatedMapStringString) Empty() bool

Empty implements OmitEmpty.

func (*LangleSeparatedMapStringString) Set 

func (m *LangleSeparatedMapStringString) Set(value string) error

Set implements github.com/spf13/pflag.Value.

func (*LangleSeparatedMapStringString) String 

func (m *LangleSeparatedMapStringString) String() string

String implements github.com/spf13/pflag.Value.

func (*LangleSeparatedMapStringString) Type 

func (*LangleSeparatedMapStringString) Type() string

Type implements github.com/spf13/pflag.Value.

type MapStringBool 

type MapStringBool struct {
	Map *map[string]bool
	// contains filtered or unexported fields
}

MapStringBool can be set from the command line with the format `--flag "string=bool"`. Multiple comma-separated key-value pairs in a single invocation are supported. For example: `--flag "a=true,b=false"`. Multiple flag invocations are supported. For example: `--flag "a=true" --flag "b=false"`.

func NewMapStringBool 

func NewMapStringBool(m *map[string]bool) *MapStringBool

NewMapStringBool takes a pointer to a map[string]string and returns the MapStringBool flag parsing shim for that map.

func (*MapStringBool) Empty 

func (m *MapStringBool) Empty() bool

Empty implements OmitEmpty.

func (*MapStringBool) Set 

func (m *MapStringBool) Set(value string) error

Set implements github.com/spf13/pflag.Value.

func (*MapStringBool) String 

func (m *MapStringBool) String() string

String implements github.com/spf13/pflag.Value.

func (*MapStringBool) Type 

func (*MapStringBool) Type() string

Type implements github.com/spf13/pflag.Value.

type MapStringString 

type MapStringString struct {
	Map *map[string]string

	NoSplit bool
	// contains filtered or unexported fields
}

MapStringString can be set from the command line with the format `--flag "string=string"`. Multiple flag invocations are supported. For example: `--flag "a=foo" --flag "b=bar"`. If this is desired to be the only type invocation `NoSplit` should be set to true. Multiple comma-separated key-value pairs in a single invocation are supported if `NoSplit` is set to false. For example: `--flag "a=foo,b=bar"`.

func NewMapStringString 

func NewMapStringString(m *map[string]string) *MapStringString

NewMapStringString takes a pointer to a map[string]string and returns the MapStringString flag parsing shim for that map.

func NewMapStringStringNoSplit 

func NewMapStringStringNoSplit(m *map[string]string) *MapStringString

NewMapStringString takes a pointer to a map[string]string and sets `NoSplit` value to `true` and returns the MapStringString flag parsing shim for that map.

func (*MapStringString) Empty 

func (m *MapStringString) Empty() bool

Empty implements OmitEmpty.

func (*MapStringString) Set 

func (m *MapStringString) Set(value string) error

Set implements github.com/spf13/pflag.Value.

func (*MapStringString) String 

func (m *MapStringString) String() string

String implements github.com/spf13/pflag.Value.

func (*MapStringString) Type 

func (*MapStringString) Type() string

Type implements github.com/spf13/pflag.Value.

type NamedCertKey 

type NamedCertKey struct {
	Names             []string
	CertFile, KeyFile string
}

NamedCertKey is a flag value parsing "certfile,keyfile" and "certfile,keyfile:name,name,name".

func (*NamedCertKey) Set 

func (nkc *NamedCertKey) Set(value string) error

func (*NamedCertKey) String 

func (nkc *NamedCertKey) String() string

func (*NamedCertKey) Type 

func (*NamedCertKey) Type() string

type NamedCertKeyArray 

type NamedCertKeyArray struct {
	// contains filtered or unexported fields
}

NamedCertKeyArray is a flag value parsing NamedCertKeys, each passed with its own flag instance (in contrast to comma separated slices).

func NewNamedCertKeyArray 

func NewNamedCertKeyArray(p *[]NamedCertKey) *NamedCertKeyArray

NewNamedKeyCertArray creates a new NamedCertKeyArray with the internal value pointing to p.

func (*NamedCertKeyArray) Set 

func (a *NamedCertKeyArray) Set(val string) error

func (*NamedCertKeyArray) String 

func (a *NamedCertKeyArray) String() string

func (*NamedCertKeyArray) Type 

func (a *NamedCertKeyArray) Type() string

type NamedFlagSets 

type NamedFlagSets struct {
	// Order is an ordered list of flag set names.
	Order []string
	// FlagSets stores the flag sets by name.
	FlagSets map[string]*pflag.FlagSet
}

NamedFlagSets stores named flag sets in the order of calling FlagSet.

func (*NamedFlagSets) FlagSet 

func (nfs *NamedFlagSets) FlagSet(name string) *pflag.FlagSet

FlagSet returns the flag set with the given name and adds it to the ordered name list if it is not in there yet.

type NoOp 

type NoOp struct{}

NoOp implements goflag.Value and plfag.Value, but has a noop Set implementation.

func (NoOp) Set 

func (NoOp) Set(val string) error

func (NoOp) String 

func (NoOp) String() string

func (NoOp) Type 

func (NoOp) Type() string

type OmitEmpty 

type OmitEmpty interface {
	Empty() bool
}

OmitEmpty is an interface for flags to report whether their underlying value is "empty." If a flag implements OmitEmpty and returns true for a call to Empty(), it is assumed that flag may be omitted from the command line.

type StringFlag 

type StringFlag struct {
	// contains filtered or unexported fields
}

StringFlag is a string flag compatible with flags and pflags that keeps track of whether it had a value supplied or not.

func NewStringFlag 

func NewStringFlag(defaultVal string) StringFlag

func (*StringFlag) Default 

func (f *StringFlag) Default(value string)

func (StringFlag) Provided 

func (f StringFlag) Provided() bool

func (*StringFlag) Set 

func (f *StringFlag) Set(value string) error

func (StringFlag) String 

func (f StringFlag) String() string

func (*StringFlag) Type 

func (f *StringFlag) Type() string

func (StringFlag) Value 

func (f StringFlag) Value() string

type Tristate 

type Tristate int

Tristate is a flag compatible with flags and pflags that keeps track of whether it had a value supplied or not. 

const (
	Unset Tristate = iota // 0
	True
	False
)

func (*Tristate) Default 

func (f *Tristate) Default(value bool)

func (Tristate) Provided 

func (f Tristate) Provided() bool

func (*Tristate) Set 

func (f *Tristate) Set(value string) error

func (Tristate) String 

func (f Tristate) String() string

func (*Tristate) Type 

func (f *Tristate) Type() string

func (Tristate) Value 

func (f Tristate) Value() bool

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.