12 releases

0.3.1 Jul 27, 2024
0.3.0 Nov 28, 2023
0.2.9 Jul 9, 2021
0.2.7 Jun 11, 2020
0.1.0 Jul 29, 2019

#197 in Command-line interface

Download history 505/week @ 2024-07-23 45/week @ 2024-07-30 177/week @ 2024-08-06 595/week @ 2024-08-13 363/week @ 2024-08-20 1094/week @ 2024-08-27 112/week @ 2024-09-03 27/week @ 2024-09-10 407/week @ 2024-09-17 1180/week @ 2024-09-24 53/week @ 2024-10-01 1739/week @ 2024-10-08 600/week @ 2024-10-15 274/week @ 2024-10-22 105/week @ 2024-10-29 593/week @ 2024-11-05

1,598 downloads per month
Used in 2 crates

Apache-2.0/MIT

41KB
703 lines

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.

Dependencies

~2MB
~50K SLoC