arg_parse for rust

Disclaimer

The interface for developer is work in progress. So expect minor and major changes when updating until v1.0

Description

arg_parse is a tool to simplify the processing of command line arguments. It doesn't have any dependencies and the initialization is done at compile time.

Features & Goals

[x] Parsing of flags (Values set with -- which default is false and set to true by being used.)
[x] Parsing of parameters (Values mentioned after - which have their value(as a string) followed)
[ ] Parsing of sub commands (which only one can be used and all following arguments are related to)
[x] Returning results instead of throwing unfinished error messages
[ ] Simple creation of parser
[x] Ability to create parser as constant or static variable (at compile time)
[x] Ability to give a list of arguments (not using args from std::env::args())
[ ] Ability to provide default values
[ ] Ability to make Argument or subcommand required
[ ] Cache the result of parsing the cli arguments to improve performance slightly
[ ] Easy macro or function to configure the parser
[ ] fulfill common patters, like described in this specification

Installation

Add arg_parse = "0.1.1" to your cargo dependencies (cargo.toml). toml [dependencies] arg_parse = "0.1.1"

# Example Prints if the flag --a is provided and the parameter provided under -b ```rust use argparse::ArgParser; use argparse::config; // Define all Arguments of the program itself/root command (compile time) const ARGS: &'static [config::Arg] = &[config::Arg::Flag("a"), config::Arg::Parameter("b")]; // Define the Root Command, without any possible sub commands (compile time) const PARSERROOTCMD: config::Cmd = config::Cmd::from(ARGS, &[]); // Create the Parser in static memory, available everywhere (Created at compile time) static PARSER: ArgParser = ArgParser::from(PARSERROOTCMD);

fn main() { //Parse the by the user provided Arguments let rootcmd = PARSER.parse(); match rootcmd { Ok(result) => println!("Result: {:?}", result), Err(error) => println!("ERROR: {:?}", error) } } ```

Links:

Github Repo
Crates.io
Rust Docs