#compile-time #macro-derive #variables #info #cargo #env-var #applications

macro appinfo

Macro to derive appinfo at compile time using cargo compile-time env vars and clap-rs

3 releases

0.1.2 Aug 22, 2024
0.1.1 Aug 22, 2024
0.1.0 Aug 22, 2024

#599 in Procedural macros

MIT/Apache

405KB
154 lines

AppInfo Logo

Crates.io version

A procedural macro to derive application info at compile time, using cargo compile-time env vars and `clap-rs`.

Usage

#[appinfo::main]
fn main(){
    println!("hello world");
    cli.do_stuff();
    server.listen(3000);
}
Add clap:
cargo add clap
cargo add appinfo

then in a terminal do:

Example:
 ./wonderful-cli -h
wonderful-cli (version: 0.1.0, commit revision: 0.1.0, repository: https://github.com/l-const/wonderful-cli) - A cli app that utilises the appinfo macro.

Details:

Future Enhacements

  • Validation logic that the macro is applied only in main.
  • Override of vars through the macro args.
  • Overridable execution/usage info.
  • Git commit revision using a compile/build time env var.

Dependencies

~1.1–1.7MB
~33K SLoC