Fork of spf13/pflag aimed to provide support for non-posix variants in carapace standalone mode (e.g. carapace-bin).
Support shorthand-only flags (e.g. -h without --help) using S suffix for flag functions:
pflag.BoolS("help", "h", false, "show help") // -hSupport 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, -helpSupport 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 = " "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)Change the flag prefix character (e.g. & for elvish) on a FlagSet:
rootCmd.Flags().SetPrefix('&') // &flag, &&flag, && terminatesSupport for flags consuming multiple arguments.
Use with
SliceandArrayflag 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