flagutil

Documentation

Index

• func IsSecretFlag(s string) bool
• func RegisterSecretFlag(flagName string)
• 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 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 float64, 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.

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 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 float64, 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