diff --git a/examples/19_auto_authors.rs b/examples/19_auto_authors.rs new file mode 100644 index 00000000000..d616dd53137 --- /dev/null +++ b/examples/19_auto_authors.rs @@ -0,0 +1,23 @@ +#[macro_use] +extern crate clap; + +use clap::App; + +#[cfg(feature = "unstable")] +fn main() { + App::new("myapp") + .about("does awesome things") + // use crate_authors! to pull the author(s) names from the Cargo.toml + .author(crate_authors!()) + .get_matches(); + + // running the this app with the -h will display whatever author(s) are in your + // Cargo.toml +} + +#[cfg(not(feature = "unstable"))] +fn main() { + // if clap is not compiled with the unstable feature, it is disabled. + println!("unstable feature disabled."); + println!("Pass --features unstable to cargo when trying this example."); +} \ No newline at end of file diff --git a/src/app/mod.rs b/src/app/mod.rs index 17ff3d5f544..2ba232c9836 100644 --- a/src/app/mod.rs +++ b/src/app/mod.rs @@ -110,9 +110,15 @@ impl<'a, 'b> App<'a, 'b> { App::from(yaml) } - /// Sets a string of author(s) that will be displayed to the user when they request the help - /// information with `--help` or `-h`. + /// Sets a string of author(s) that will be displayed to the user when they + /// request the help information with `--help` or `-h`. /// + /// **Pro-tip:** If you turn on unstable features you can use `clap`s + /// convienience macro `crate_authors!` to automatically set your + /// application's author to the same thing as your crate at compile time. + /// See the `examples/` + /// directory for more information + /// /// # Examples /// /// ```no_run diff --git a/src/macros.rs b/src/macros.rs index f7d505059e3..781cd5d84c0 100644 --- a/src/macros.rs +++ b/src/macros.rs @@ -350,7 +350,7 @@ macro_rules! arg_enum { }; } -/// Allows you pull the version for an from your Cargo.toml at compile time as +/// Allows you pull the version from your Cargo.toml at compile time as /// MAJOR.MINOR.PATCH_PKGVERSION_PRE /// /// # Examples @@ -372,6 +372,28 @@ macro_rules! crate_version { }; } +/// Allows you pull the authors for the app from your Cargo.toml at compile time as +/// "author1 lastname. ", "author2 lastname. " +/// +/// # Examples +/// +/// ```no_run +/// # #[macro_use] +/// # extern crate clap; +/// # use clap::App; +/// # fn main() { +/// let m = App::new("app") +/// .author(crate_authors!()) +/// .get_matches(); +/// # } +/// ``` +#[cfg_attr(feature = "unstable", macro_export)] +macro_rules! crate_authors { + () => { + env!("CARGO_PKG_AUTHORS") + }; +} + /// App, Arg, SubCommand and Group builder macro (Usage-string like input) must be compiled with /// the `unstable` feature in order to use. #[cfg_attr(feature = "unstable", macro_export)]