Struct blarg_builder::GeneralParser

pub struct GeneralParser<'a> { /* private fields */ }

The configured command line parser. Built via CommandLineParser::build or SubCommandParser::build.

Implementations

impl<'a> GeneralParser<'a>

pub fn parse_tokens(self, tokens: &[&str]) -> Result<(), i32>

Run the command line parser against the input tokens. Help messages are printed on stdout, while error messages are printed on stderr.

The parser will process the input tokens based off the CommandLineParser/SubCommandParser configuration. Parsing happens in two phases:

1. Token matching aligns the tokens to arguments and options. All tokens must be matched successfully in order to proceed to the next phase.
2. Token capturing parses the tokens by their respective types T. This phase will actually mutate your program variables.

If at any point the parser encounters an error (ex: un-matched token, un-capturable token, etc), it will return with Err(1).

If the help switch (-h or --help) is encountered, the parser will display the help message and return with Err(0). This skips the phase #2 capturing.

In the case of a sub-command based command line parser, this process is repeated twice. Once for the root command line parser, and a second time for the matched sub-command. The input tokens are partitioned based off the Condition parameter.

pub fn parse(self)

Run the command line parser against the Cli env::args. Help messages are printed on stdout, while error messages are printed on stderr.

The parser will process the input tokens based off the CommandLineParser/SubCommandParser configuration. Parsing happens in two phases:

1. Token matching aligns the tokens to arguments and options. All tokens must be matched successfully in order to proceed to the next phase.
2. Token capturing parses the tokens by their respective types T. This phase will actually mutate your program variables.

If at any point the parser encounters an error (ex: un-matched token, un-capturable token, etc), it will exit with error code 1 (via std::process::exit).

If the help switch (-h or --help) is encountered, the parser will display the help message and exit with error code 0. This skips the phase #2 capturing.

In the case of a sub-command based command line parser, this process is repeated twice. Once for the root command line parser, and a second time for the matched sub-command. The input tokens are partitioned based off the Condition parameter.

Trait Implementations

impl<'a> Debug for GeneralParser<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.