import "github.com/ohir/mopt"
Package mopt provides command arguments parsing in 90 lines of Go.
It is ready to use right after declaring a single mopt.Usage type variable optionally containing usage text to be printed with an '-h' flag. For just a single option a single line with Usage literal is all you need:
niter := mopt.Usage("-n iterations, default: 9").OptN('n', 9)For more options declare Usage string variable, eg:
var cl mopt.Usage = "\t-n iterations\n\t-v verbose\n ..."then you may use its five option read methods:
cl.OptB('x') booltells if '-x' flag is present. Its ok to ask for any type flag presence.cl.OptN('x', def·int) intreturns '-x ±digits' as an int, or the default int.cl.OptF('x', def·float) float64returns '-x ±digits' as a float64, or the default float.cl.OptS('x', "default string") stringreturns text of '-x text', or the default string.cl.OptL() []stringreturns slice of arguments following the last option or terminating '--'.
Spaces between flag letter and value are unimportant: ie. -a bc, and -abc are equivalent. Same for numbers: -n-3 and -n -3 both provide -3 number. For this elasticity a leading dash of string value, if needed, must be given after a backslash: eg. -s\-dashed or -s "\- started with a dash". Flag grouping is not supported, too. Ie. -a -b -c are three boolean flags, but -abc would be an -a flag introducing a string value of "bc".
Flag -h is predefined to print a short "ProgName purpose, usage & options:\n" lead, then content of the mopt.Usage variable; then program exits. Lead is kept in a package variable, so it can be changed from the user's code.
Automatic help behaviour can be extended simply by asking about a help topic early on: eg.
var cl mopt.Usage = "\t-v verbose\n ..."
func main(){
if htopic := cl.OptS('h',"-"); htopic != "-" {
switch htopic {
case "": // bare -h
case "flip": // -h flip
// ...
default:
println("No help about", htopic, "avaliable!")
}
os.Exit(0) // exit after
}
//...
}Mopt package is meant to be used in the PoC code and ad-hoc cli tools. It parses two leading bytes of each os.Args entry anew on every OptX call. Also, there is no user feedback of "unknown/wrong option", nor developer is guarded against opt-letter reuse. Caveat emptor!
type Usage stringUsage type string provides help message to be printed if program user will pass the '-h' flag. Mopt package whole api is hooked on an Usage type variable.
func (u Usage) OptB(flag rune) (r bool)Method OptB returns true if flag was given, otherwise it returns false. It need not to take a default: flag either is present, or not.
func (u Usage) OptF(flag rune, def float64) (r float64)Method OptF returns float64 read as f32 from string following the flag. If flag was not given, or it could not be parsed to the float, OptF returns the def value.
func (u Usage) OptL() (r []string)Method OptL returns a slice of strings filled with commandline arguments after the last option, or arguments after the options terminator '--', if given. Or all arguments if no dash-letter was spotted.
func (u Usage) OptN(flag rune, def int) (r int)Method OptN returns an int. If flag was not given, or string that followed could not be parsed to an int, OptN returns the def value. Negative values need no special attention: -x-2 and -y -2 both convey -2.
func (u Usage) OptS(flag rune, def string) stringMethod OptS returns following string. If flag was not given, OptS returns the def value. If string after option needs to begin with a dash character, leading dash must be escaped: eg. -s"\-begins with a dash".
var HelpLead string = "purpose, usage & options:\n"Allows -h to say "propósito, uso y opciones:", or "目的、使用法、オプション"
var Exit func(int) = os.Exitos.Exit(0) called by -h support can be hijacked here.