Module clap

Re-export of clap

Macros

_clap_count_exprs

Counts the number of comma-delimited expressions passed to it. The result is a compile-time evaluable expression, suitable for use as a static array size, or the value of a const.

app_from_crate

Allows you to build the App instance from your Cargo.toml at compile time.

arg_enum

Convenience macro to generate more complete enums with variants to be used as a type when parsing arguments. This enum also provides a variants() function which can be used to retrieve a Vec<&'static str> of the variant names, as well as implementing FromStr and Display automatically.

clap_app

Build App, Args, SubCommands and Groups with Usage-string like input but without the associated parsing runtime cost.

crate_authors

Allows you to pull the authors for the app from your Cargo.toml at compile time in the form: "author1 lastname <author1@example.com>:author2 lastname <author2@example.com>"

crate_description

Allows you to pull the description from your Cargo.toml at compile time.

crate_name

Allows you to pull the name from your Cargo.toml at compile time.

crate_version

Allows you to pull the version from your Cargo.toml at compile time as MAJOR.MINOR.PATCH_PKGVERSION_PRE

value_t

Convenience macro getting a typed value T where T implements std::str::FromStr from an argument value. This macro returns a Result<T,String> which allows you as the developer to decide what you’d like to do on a failed parse. There are two types of errors, parse failures and those where the argument wasn’t present (such as a non-required argument). You can use it to get a single value, or a iterator as with the ArgMatches::values_of

value_t_or_exit

Convenience macro getting a typed value T where T implements std::str::FromStr or exiting upon error, instead of returning a Result type.

values_t

Convenience macro getting a typed value Vec<T> where T implements std::str::FromStr This macro returns a clap::Result<Vec<T>> which allows you as the developer to decide what you’d like to do on a failed parse.

values_t_or_exit

Convenience macro getting a typed value Vec<T> where T implements std::str::FromStr or exiting upon error.

Structs

App

Used to create a representation of a command line program and all possible command line arguments. Application settings are set using the “builder pattern” with the App::get_matches family of methods being the terminal methods that starts the runtime-parsing process. These methods then return information about the user supplied arguments (or lack there of).

Arg

The abstract representation of a command line argument. Used to set all the options and relationships that define a valid argument for the program.

ArgGroup

ArgGroups are a family of related arguments and way for you to express, “Any of these arguments”. By placing arguments in a logical group, you can create easier requirement and exclusion rules instead of having to list each argument individually, or when you want a rule to apply “any but not all” arguments.

ArgMatches

Used to get information about the arguments that were supplied to the program at runtime by the user. New instances of this struct are obtained by using the App::get_matches family of methods.

Error

Command Line Argument Parser Error

OsValues

An iterator for getting multiple values out of an argument via the ArgMatches::values_of_os method. Usage of this iterator allows values which contain invalid UTF-8 code points unlike Values.

SubCommand

The abstract representation of a command line subcommand.

Values

An iterator for getting multiple values out of an argument via the ArgMatches::values_of method.

Enums

AppSettings

Application level settings, which affect how App operates

ArgSettings

Various settings that apply to arguments and may be set, unset, and checked via getter/setter methods Arg::set, Arg::unset, and Arg::is_set

ErrorKind

Command line argument parser kind of error

Shell

Describes which shell to produce a completions file for

Type Aliases

Result

Short hand for Result type