flagutil

Documentation

Index

• func IsSecretFlag(s string) bool
• func RegisterSecretFlag(flagName string)
• func Usage(s string)
• func WriteFlags(w io.Writer)
• type Array
  • func NewArray(name, description string) *Array
  • func (a *Array) GetOptionalArg(argIdx int) string
  • func (a *Array) Set(value string) error
  • func (a *Array) String() string
• 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 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 string, description string) *ArrayInt
  • func (a *ArrayInt) GetOptionalArgOrDefault(argIdx int, defaultValue int) int
  • func (a *ArrayInt) Set(value string) error
  • func (a *ArrayInt) String() string
• type Bytes
  • func NewBytes(name string, defaultValue int, description string) *Bytes
  • 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 Array

type Array []string

Array is a flag that holds an array of values.

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

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

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

func NewArray

func NewArray(name, description string) *Array

NewArray returns new Array with the given name and description.

func (*Array) GetOptionalArg

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

GetOptionalArg returns optional arg under the given argIdx.

func (*Array) Set

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

Set implements flag.Value interface

func (*Array) String

func (a *Array) String() string

String implements flag.Value interface

type ArrayBool

type ArrayBool []bool

ArrayBool is a flag that holds an array of booleans values. have the same api as Array.

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 ArrayDuration

type ArrayDuration []time.Duration

ArrayDuration is a flag that holds an array of time.Duration values. have the same api as Array.

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.

func NewArrayInt

func NewArrayInt(name string, description string) *ArrayInt

NewArrayInt returns new ArrayInt with the given name and description.

func (*ArrayInt) GetOptionalArgOrDefault

func (a *ArrayInt) GetOptionalArgOrDefault(argIdx int, 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 Bytes

type Bytes struct {
	// N contains parsed value for the given flag.
	N int
	// 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, KiB, MiB, GiB.

func NewBytes

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

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

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