mopt
a minimalistic Go "flag" substitute that parses cmdline in the getopt style
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') bool
tells if '-x' flag is present. Its ok to ask for any type flag presence.cl.OptN('x', def·int) int
returns '-x ±digits' as an int, or the default int.cl.OptF('x', def·float) float64
returns '-x ±digits' as a float64, or the default float.cl.OptS('x', "default string") string
returns text of '-x text', or the default string.cl.OptL() []string
returns 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 "":
case "flip":
default:
println("No help about", htopic, "avaliable!")
}
os.Exit(0)
}
}
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 string
Usage 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) string
Method 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"
.
NLS variable
var HelpLead string = "purpose, usage & options:\n"
Allows -h
to say "propósito, uso y opciones:", or "目的、使用法、オプション"
Exit variable
var Exit func(int) = os.Exit
os.Exit(0) called by -h support can be hijacked here.