Skip to content
forked from spf13/pflag

About

Drop-in replacement for spf13/pflag with support for non-posix variants

Resources

Stars

3 stars

Watchers

1 watching

Forks

 
 

Latest commit

 

History

423 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

carapace-pflag

PkgGoDev GoReportCard Coverage Status

Fork of spf13/pflag aimed to provide support for non-posix variants in carapace standalone mode (e.g. carapace-bin).

Customizations

Shorthand-Only

Support shorthand-only flags (e.g. -h without --help) using S suffix for flag functions:

pflag.BoolS("help", "h", false, "show help") // -h

Long Shorthand

Support shorthand flags that are more than one character long (e.g. pkill -<sig>).

This implicitly disables posix shorthand chaining (e.g. ls -lha):

pflag.BoolS("STOP", "STOP", false, "Stop process, unblockable") // -STOP
pflag.BoolN("help", "h", false, "show help") // -h, -help

Custom Optarg Delimiter

Support custom optarg delimiter (e.g. java -agentlib:jdwp).

rootCmd.Flags().StringS("agentlib", "agentlib", "", "load native agent library")
rootCmd.Flag("agentlib").NoOptDefVal = " "
rootCmd.Flag("agentlib").OptargDelimiter = ':'

Set OptargDelimiter to pflag.DelimiterDisabled to disable delimiter-based parsing and accept directly-attached values (e.g. -rvalue → flag r, value value):

rootCmd.Flag("agentlib").OptargDelimiter = pflag.DelimiterDisabled
rootCmd.Flag("agentlib").NoOptDefVal = " "

Argument Style

Control which argument forms a flag accepts using the ArgumentStyle bitmask. The zero value accepts all forms (backward compatible).

rootCmd.Flag("verbose").ArgumentStyle = pflag.AcceptDelimited | pflag.AcceptNext
// accepts: --verbose=val, --verbose val
// rejects: --verboseval (attached)

Custom Flag Prefix

Change the flag prefix character (e.g. & for elvish) on a FlagSet:

rootCmd.Flags().SetPrefix('&') // &flag, &&flag, && terminates

Nargs

Support for flags consuming multiple arguments.

Use with Slice and Array flag types.

rootCmd.Flags().StringSlice("nargs-any", []string{}, "Nargs")
rootCmd.Flags().StringSlice("nargs-two", []string{}, "Nargs")

rootCmd.Flag("nargs-any").Nargs = -1 // consumes at least one argument until one starts with `-`
rootCmd.Flag("nargs-two").Nargs = 2 // consumes exactly 2 arguments

About

Drop-in replacement for spf13/pflag with support for non-posix variants

Resources

Stars

3 stars

Watchers

1 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages