flags

Documentation

Index

• Constants
• func AutoEnvVars(flags []cli.Flag, prefix string)
• func CheckEnvVars(ctx *cli.Context, flags []cli.Flag, prefix string)
• func FlagString(f cli.Flag) string
• func GlobalBig(ctx *cli.Context, name string) *big.Int
• func HomeDir() string
• func MigrateGlobalFlags(ctx *cli.Context)
• func NewApp(usage string) *cli.App
• type BigFlag
  • func (f *BigFlag) Apply(set *flag.FlagSet) error
  • func (f *BigFlag) GetCategory() string
  • func (f *BigFlag) GetDefaultText() string
  • func (f *BigFlag) GetEnvVars() []string
  • func (f *BigFlag) GetUsage() string
  • func (f *BigFlag) GetValue() string
  • func (f *BigFlag) IsRequired() bool
  • func (f *BigFlag) IsSet() bool
  • func (f *BigFlag) IsVisible() bool
  • func (f *BigFlag) Names() []string
  • func (f *BigFlag) String() string
  • func (f *BigFlag) TakesValue() bool
• type DirectoryFlag
  • func (f *DirectoryFlag) Apply(set *flag.FlagSet) error
  • func (f *DirectoryFlag) GetCategory() string
  • func (f *DirectoryFlag) GetDefaultText() string
  • func (f *DirectoryFlag) GetEnvVars() []string
  • func (f *DirectoryFlag) GetUsage() string
  • func (f *DirectoryFlag) GetValue() string
  • func (f *DirectoryFlag) IsRequired() bool
  • func (f *DirectoryFlag) IsSet() bool
  • func (f *DirectoryFlag) IsVisible() bool
  • func (f *DirectoryFlag) Names() []string
  • func (f *DirectoryFlag) String() string
  • func (f *DirectoryFlag) TakesValue() bool
• type DirectoryString
  • func (s *DirectoryString) Set(value string) error
  • func (s *DirectoryString) String() string

Constants

const (
	EthCategory        = "ETHEREUM"
	BeaconCategory     = "BEACON CHAIN"
	DevCategory        = "DEVELOPER CHAIN"
	StateCategory      = "STATE HISTORY MANAGEMENT"
	TxPoolCategory     = "TRANSACTION POOL (EVM)"
	BlobPoolCategory   = "TRANSACTION POOL (BLOB)"
	PerfCategory       = "PERFORMANCE TUNING"
	AccountCategory    = "ACCOUNT"
	APICategory        = "API AND CONSOLE"
	NetworkingCategory = "NETWORKING"
	MinerCategory      = "MINER"
	GasPriceCategory   = "GAS PRICE ORACLE"
	VMCategory         = "VIRTUAL MACHINE"
	LoggingCategory    = "LOGGING AND DEBUGGING"
	MetricsCategory    = "METRICS AND STATS"
	MiscCategory       = "MISC"
	TestingCategory    = "TESTING"
	DeprecatedCategory = "ALIASED (deprecated)"
)

Functions

func AutoEnvVars

func AutoEnvVars(flags []cli.Flag, prefix string)

AutoEnvVars extends all the specific CLI flags with automatically generated env vars by capitalizing the flag, replacing . with _ and prefixing it with the specified string.

Note, the prefix should *not* contain the separator underscore, that will be added automatically.

func CheckEnvVars

func CheckEnvVars(ctx *cli.Context, flags []cli.Flag, prefix string)

CheckEnvVars iterates over all the environment variables and checks if any of them look like a CLI flag but is not consumed. This can be used to detect old or mistyped names.

func FlagString

func FlagString(f cli.Flag) string

FlagString prints a single flag in help.

func GlobalBig

func GlobalBig(ctx *cli.Context, name string) *big.Int

GlobalBig returns the value of a BigFlag from the global flag set.

func HomeDir

func HomeDir() string

func MigrateGlobalFlags

func MigrateGlobalFlags(ctx *cli.Context)

MigrateGlobalFlags makes all global flag values available in the context. This should be called as early as possible in app.Before.

Example:

geth account new --keystore /tmp/mykeystore --lightkdf

is equivalent after calling this method with:

geth --keystore /tmp/mykeystore --lightkdf account new

i.e. in the subcommand Action function of 'account new', ctx.Bool("lightkdf) will return true even if --lightkdf is set as a global option.

This function may become unnecessary when https://github.com/urfave/cli/pull/1245 is merged.

func NewApp

func NewApp(usage string) *cli.App

NewApp creates an app with sane defaults.

Types

type BigFlag

type BigFlag struct {
	Name string

	Category    string
	DefaultText string
	Usage       string

	Required   bool
	Hidden     bool
	HasBeenSet bool

	Value *big.Int

	Aliases []string
	EnvVars []string
	// contains filtered or unexported fields
}

BigFlag is a command line flag that accepts 256 bit big integers in decimal or hexadecimal syntax.

func (*BigFlag) Apply

func (f *BigFlag) Apply(set *flag.FlagSet) error

func (*BigFlag) GetCategory

func (f *BigFlag) GetCategory() string

func (*BigFlag) GetDefaultText

func (f *BigFlag) GetDefaultText() string

func (*BigFlag) GetEnvVars

func (f *BigFlag) GetEnvVars() []string

func (*BigFlag) GetUsage

func (f *BigFlag) GetUsage() string

func (*BigFlag) GetValue

func (f *BigFlag) GetValue() string

func (*BigFlag) IsRequired

func (f *BigFlag) IsRequired() bool

func (*BigFlag) IsSet

func (f *BigFlag) IsSet() bool

func (*BigFlag) IsVisible

func (f *BigFlag) IsVisible() bool

func (*BigFlag) Names

func (f *BigFlag) Names() []string

func (*BigFlag) String

func (f *BigFlag) String() string

func (*BigFlag) TakesValue

func (f *BigFlag) TakesValue() bool

type DirectoryFlag

type DirectoryFlag struct {
	Name string

	Category    string
	DefaultText string
	Usage       string

	Required   bool
	Hidden     bool
	HasBeenSet bool

	Value DirectoryString

	Aliases []string
	EnvVars []string
}

DirectoryFlag is custom cli.Flag type which expand the received string to an absolute path. e.g. ~/.ethereum -> /home/username/.ethereum

func (*DirectoryFlag) Apply

func (f *DirectoryFlag) Apply(set *flag.FlagSet) error

Apply called by cli library, grabs variable from environment (if in env) and adds variable to flag set for parsing.

func (*DirectoryFlag) GetCategory

func (f *DirectoryFlag) GetCategory() string

func (*DirectoryFlag) GetDefaultText

func (f *DirectoryFlag) GetDefaultText() string

func (*DirectoryFlag) GetEnvVars

func (f *DirectoryFlag) GetEnvVars() []string

func (*DirectoryFlag) GetUsage

func (f *DirectoryFlag) GetUsage() string

func (*DirectoryFlag) GetValue

func (f *DirectoryFlag) GetValue() string

func (*DirectoryFlag) IsRequired

func (f *DirectoryFlag) IsRequired() bool

func (*DirectoryFlag) IsSet

func (f *DirectoryFlag) IsSet() bool

func (*DirectoryFlag) IsVisible

func (f *DirectoryFlag) IsVisible() bool

func (*DirectoryFlag) Names

func (f *DirectoryFlag) Names() []string

func (*DirectoryFlag) String

func (f *DirectoryFlag) String() string

func (*DirectoryFlag) TakesValue

func (f *DirectoryFlag) TakesValue() bool

type DirectoryString

type DirectoryString string

DirectoryString is custom type which is registered in the flags library which cli uses for argument parsing. This allows us to expand Value to an absolute path when the argument is parsed

func (*DirectoryString) Set

func (s *DirectoryString) Set(value string) error

func (*DirectoryString) String

func (s *DirectoryString) String() string