smartcli

nimony/lib/std/smartcli.nim

Typed command-line parser generation from a help-text specification.

Use cliapp with a specification containing Commands:, Arguments:, and Options: sections. The accompanying compiler plugin generates a parser and a typed options object at the call site.

A trailing positional name ending in ..., such as install ITEM..., accepts zero or more values and generates a seq[string] field named item. Other positional fields are strings. A repeated field name across commands must have the same cardinality. Options can occur between values. Usage: is descriptive; the Commands: and Arguments: sections define the parser. Inline command arguments take precedence over Arguments:.

proc cliExitHelp(spec: string)
proc cliExitVersion(spec: string)
proc cliFail(spec: string; message: string)
proc cliUnknownLongOption(spec: string; key: string)
proc cliUnknownShortOption(spec: string; key: string)
proc cliUnexpectedArgument(spec: string; arg: string)
proc cliMissingArguments(spec: string)
proc cliAddArgument(values: var seq[string]; value: string)
proc cliInvalidValue(spec: string; optionName: string; value: string)
template cliapp(spec: string): untyped
template cliapp(spec: string; args: seq[string]): untyped
Parses args instead of the process command line. args holds the arguments only — no program name — exactly like the sequence overload of parseopt.initOptParser, which is what the generated parser calls.