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

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