README
¶
flags
Golang flags parser with zero dependency.
Usage
See simple.go for a basic usage.
Concept
flags gives a simple way to get flag's value from argument or environment variable.
Argument takes priority over environment variable. Argument and environment variable names are generated from configuration you pass.
The FlagSet name is used to prefix all environment variable, replacing - by _.
The prefix name is used then to specialize your flag name (e.g. if you have want to use the same flags twice, you can change the prefix)
The argument's name is in camelCase format. The environement variable name is in SNAKE_UPPER_CASE format.
Flags can take a default value, that can be overriden programatically, always in the case you reuse the same flags twice (see advanced.go example.)
Security
Be careful when using the arguments values, if someone list the processes on the system, they will appear in plain-text. Pass secrets by environment variables: it's less easily visible.
Documentation
¶
Index ¶
- func Bool(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, ...) *bool
- func Duration(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, ...) *time.Duration
- func Float64(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, ...) *float64
- func Int(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, ...) *int
- func Int64(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, ...) *int64
- func Sha(content string) string
- func SnakeCase(s string) string
- func String(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, ...) *string
- func StringSlice(fs *flag.FlagSet, ...) *[]string
- func Uint(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, ...) *uint
- func Uint64(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, ...) *uint64
- func Usage(fs *flag.FlagSet) func()
- type Builder
- func (b Builder) Bool(fs *flag.FlagSet, value bool, overrides []Override) *bool
- func (b Builder) DocPrefix(docPrefix string) Builder
- func (b Builder) Duration(fs *flag.FlagSet, value time.Duration, overrides []Override) *time.Duration
- func (b Builder) Env(env string) Builder
- func (b Builder) EnvSeparator(envSeparator string) Builder
- func (b Builder) Float64(fs *flag.FlagSet, value float64, overrides []Override) *float64
- func (b Builder) Int(fs *flag.FlagSet, value int, overrides []Override) *int
- func (b Builder) Int64(fs *flag.FlagSet, value int64, overrides []Override) *int64
- func (b Builder) Prefix(prefix string) Builder
- func (b Builder) Shorthand(shorthand string) Builder
- func (b Builder) String(fs *flag.FlagSet, value string, overrides []Override) *string
- func (b Builder) StringSlice(fs *flag.FlagSet, value []string, overrides []Override) *[]string
- func (b Builder) Uint(fs *flag.FlagSet, value uint, overrides []Override) *uint
- func (b Builder) Uint64(fs *flag.FlagSet, value uint64, overrides []Override) *uint64
- type Flag
- type Override
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func Bool ¶ added in v1.0.0
func Bool(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, value bool, overrides []Override) *bool
Bool creates a bool flag
func Duration ¶ added in v1.1.0
func Duration(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, value time.Duration, overrides []Override) *time.Duration
Duration creates a duration flag
func Float64 ¶ added in v1.0.0
func Float64(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, value float64, overrides []Override) *float64
Float64 creates a float64 flag
func Int ¶ added in v1.0.0
func Int(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, value int, overrides []Override) *int
Int creates an int flag
func Int64 ¶ added in v1.0.0
func Int64(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, value int64, overrides []Override) *int64
Int64 creates an int64 flag
func String ¶ added in v1.0.0
func String(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, value string, overrides []Override) *string
String creates a string flag
func StringSlice ¶ added in v1.3.0
func StringSlice(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env, envSeparator string, value []string, overrides []Override) *[]string
StringSlice creates a string slice flag
func Uint ¶ added in v1.0.0
func Uint(fs *flag.FlagSet, prefix, docPrefix, name, shorthand, label, env string, value uint, overrides []Override) *uint
Uint creates an uint flag
Types ¶
type Builder ¶ added in v1.3.1
type Builder struct {
// contains filtered or unexported fields
}
Source Files
Directories