auto-args

Crates.ioauto-args
lib.rsauto-args
version0.3.1
sourcesrc
created_at2019-07-29 13:28:36.515901
updated_at2024-07-27 20:43:45.954348
descriptionParse command line arguments by defining a struct.
homepage
repositoryhttps://github.com/droundy/auto-args
max_upload_size
id152629
size83,682
David Roundy (droundy)

documentation

README

AutoArgs Build Status

Parse command line arguments by defining a struct. It uses a derive to define a set of command-line flags. It does not use clap and its dependencies are rather slimmer.

The basic idea is that you define a type that represents the information you want on the command-line from the person running your program, and derive(AutoArgs) on that type, and then call YourType::from_args() to find out what your user gave you.

Differences from ClapMe

AutoArgs is essentially equivalent to ClapMe. It only differs in implementation, speed of compilation, help messages, and error messages.

Differences from structopt

StructOpt is a tool that serves the same function as auto-args, but with a different philosophy. StructOpt strives to be as expressive as clap, and to enable all features clap does, and with a tightly coupled API. It does this by extensive use of attributes such as #[structopt(long = "long-name")], which define the behavior and property of each flag. This makes it powerful, but also rather verbose to use.

In contrast, AutoArgs does not (yet?) support any attributes, and determines all behavior directly from your type. This means that you don't repeat yourself, but also means that you have less fine-grained control over your interface, and some interfaces may be well-nigh impossible.

You can implement the AutoArgs trait manually, which does make it possible (and not even that painful) to create a different command-line for a given type, but this is not the intended way to use AutoArgs.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Commit count: 72

cargo fmt