flagutil

Documentation

Index

• func IsSecretFlag(s string) bool
• func RegisterSecretFlag(flagName string)
• func Usage(s string)
• func WriteFlags(w io.Writer)
• type ArrayBool
  • func NewArrayBool(name, description string) *ArrayBool
  • func (a *ArrayBool) GetOptionalArg(argIdx int) bool
  • func (a *ArrayBool) IsBoolFlag() bool
  • func (a *ArrayBool) Set(value string) error
  • func (a *ArrayBool) String() string
• type ArrayBytes
  • func NewArrayBytes(name, description string) *ArrayBytes
  • func (a *ArrayBytes) GetOptionalArgOrDefault(argIdx int, defaultValue int64) int64
  • func (a *ArrayBytes) Set(value string) error
  • func (a *ArrayBytes) String() string
• type ArrayDuration
  • func NewArrayDuration(name, description string) *ArrayDuration
  • func (a *ArrayDuration) GetOptionalArgOrDefault(argIdx int, defaultValue time.Duration) time.Duration
  • func (a *ArrayDuration) Set(value string) error
  • func (a *ArrayDuration) String() string
• type ArrayInt
  • func NewArrayInt(name, description string) *ArrayInt
  • func (a *ArrayInt) GetOptionalArgOrDefault(argIdx, defaultValue int) int
  • func (a *ArrayInt) Set(value string) error
  • func (a *ArrayInt) String() string
• type ArrayString
  • func NewArrayString(name, description string) *ArrayString
  • func (a *ArrayString) GetOptionalArg(argIdx int) string
  • func (a *ArrayString) Set(value string) error
  • func (a *ArrayString) String() string
• type Bytes
  • func NewBytes(name string, defaultValue int64, description string) *Bytes
  • func (b *Bytes) IntN() int
  • func (b *Bytes) Set(value string) error
  • func (b *Bytes) String() string
• type Duration
  • func NewDuration(name string, defaultValue string, description string) *Duration
  • func (d *Duration) Set(value string) error
  • func (d *Duration) String() string

Functions

func IsSecretFlag

func IsSecretFlag(s string) bool

IsSecretFlag returns true of s contains flag name with secret value, which shouldn't be exposed.

func RegisterSecretFlag

func RegisterSecretFlag(flagName string)

RegisterSecretFlag registers flagName as secret.

This function must be called before starting logging. It cannot be called from concurrent goroutines.

Secret flags aren't exported at `/metrics` page.

func Usage

func Usage(s string)

Usage prints s and optional description for all the flags if -h or -help flag is passed to the app.

func WriteFlags

func WriteFlags(w io.Writer)

WriteFlags writes all the explicitly set flags to w.

Types

type ArrayBool

type ArrayBool []bool

ArrayBool is a flag that holds an array of booleans values.

Has the same api as ArrayString.

func NewArrayBool

func NewArrayBool(name, description string) *ArrayBool

NewArrayBool returns new ArrayBool with the given name and description.

func (*ArrayBool) GetOptionalArg

func (a *ArrayBool) GetOptionalArg(argIdx int) bool

GetOptionalArg returns optional arg under the given argIdx.

func (*ArrayBool) IsBoolFlag

func (a *ArrayBool) IsBoolFlag() bool

IsBoolFlag implements flag.IsBoolFlag interface

func (*ArrayBool) Set

func (a *ArrayBool) Set(value string) error

Set implements flag.Value interface

func (*ArrayBool) String

func (a *ArrayBool) String() string

String implements flag.Value interface

type ArrayBytes

type ArrayBytes []*Bytes

ArrayBytes is flag that holds an array of Bytes.

Has the same api as ArrayString.

func NewArrayBytes

func NewArrayBytes(name, description string) *ArrayBytes

NewArrayBytes returns new ArrayBytes with the given name and description.

func (*ArrayBytes) GetOptionalArgOrDefault

func (a *ArrayBytes) GetOptionalArgOrDefault(argIdx int, defaultValue int64) int64

GetOptionalArgOrDefault returns optional arg under the given argIdx.

func (*ArrayBytes) Set

func (a *ArrayBytes) Set(value string) error

Set implemented flag.Value interface

func (*ArrayBytes) String

func (a *ArrayBytes) String() string

String implements flag.Value interface

type ArrayDuration

type ArrayDuration []time.Duration

ArrayDuration is a flag that holds an array of time.Duration values.

Has the same api as ArrayString.

func NewArrayDuration

func NewArrayDuration(name, description string) *ArrayDuration

NewArrayDuration returns new ArrayDuration with the given name and description.

func (*ArrayDuration) GetOptionalArgOrDefault

func (a *ArrayDuration) GetOptionalArgOrDefault(argIdx int, defaultValue time.Duration) time.Duration

GetOptionalArgOrDefault returns optional arg under the given argIdx, or default value, if argIdx not found.

func (*ArrayDuration) Set

func (a *ArrayDuration) Set(value string) error

Set implements flag.Value interface

func (*ArrayDuration) String

func (a *ArrayDuration) String() string

String implements flag.Value interface

type ArrayInt

type ArrayInt []int

ArrayInt is flag that holds an array of ints.

Has the same api as ArrayString.

func NewArrayInt

func NewArrayInt(name, description string) *ArrayInt

NewArrayInt returns new ArrayInt with the given name and description.

func (*ArrayInt) GetOptionalArgOrDefault

func (a *ArrayInt) GetOptionalArgOrDefault(argIdx, defaultValue int) int

GetOptionalArgOrDefault returns optional arg under the given argIdx.

func (*ArrayInt) Set

func (a *ArrayInt) Set(value string) error

Set implements flag.Value interface

func (*ArrayInt) String

func (a *ArrayInt) String() string

String implements flag.Value interface

type ArrayString

type ArrayString []string

ArrayString is a flag that holds an array of strings.

It may be set either by specifying multiple flags with the given name passed to NewArray or by joining flag values by comma.

The following example sets equivalent flag array with two items (value1, value2):

-foo=value1 -foo=value2
-foo=value1,value2

Each flag value may contain commas inside single quotes, double quotes, [], () or {} braces. For example, -foo=[a,b,c] defines a single command-line flag with `[a,b,c]` value.

Flag values may be quoted. For instance, the following arg creates an array of ("a", "b,c") items:

-foo='a,"b,c"'

func NewArrayString

func NewArrayString(name, description string) *ArrayString

NewArrayString returns new ArrayString with the given name and description.

func (*ArrayString) GetOptionalArg

func (a *ArrayString) GetOptionalArg(argIdx int) string

GetOptionalArg returns optional arg under the given argIdx.

func (*ArrayString) Set

func (a *ArrayString) Set(value string) error

Set implements flag.Value interface

func (*ArrayString) String

func (a *ArrayString) String() string

String implements flag.Value interface

type Bytes

type Bytes struct {
	// N contains parsed value for the given flag.
	N int64
	// contains filtered or unexported fields
}

Bytes is a flag for holding size in bytes.

It supports the following optional suffixes for values: KB, MB, GB, TB, KiB, MiB, GiB, TiB.

func NewBytes

func NewBytes(name string, defaultValue int64, description string) *Bytes

NewBytes returns new `bytes` flag with the given name, defaultValue and description.

func (*Bytes) IntN

func (b *Bytes) IntN() int

IntN returns the stored value capped by int type.

func (*Bytes) Set

func (b *Bytes) Set(value string) error

Set implements flag.Value interface

func (*Bytes) String

func (b *Bytes) String() string

String implements flag.Value interface

type Duration

type Duration struct {
	// Msecs contains parsed duration in milliseconds.
	Msecs int64
	// contains filtered or unexported fields
}

Duration is a flag for holding duration.

func NewDuration

func NewDuration(name string, defaultValue string, description string) *Duration

NewDuration returns new `duration` flag with the given name, defaultValue and description.

DefaultValue is in months.

func (*Duration) Set

func (d *Duration) Set(value string) error

Set implements flag.Value interface

func (*Duration) String

func (d *Duration) String() string

String implements flag.Value interface