Cargo Emit

Talk to Cargo easily at build time, brought to you by [Nikolai Vazquez]. This library provides: - Convenience macros for communicating with Cargo during the [`build.rs`] phrase. Cargo listens to certain [build script outputs] that dictate how it should behave. - An accessible location for seeing what script build outputs are available to emit. - Protection against typos that can be made when printing these formatted outputs directly yourself. Mistyping macro names will result in a compile failure. [Nikolai Vazquez]: https://twitter.com/NikolaiVazquez [`build.rs`]: https://doc.rust-lang.org/cargo/reference/build-scripts.html [build script outputs]: https://doc.rust-lang.org/cargo/reference/build-scripts.html#outputs-of-the-build-script ## Usage This crate exposes the following macros: | Macro | Output | |----------------------------------------|---------------------------------------| | [`pair!($key, $value)`] | `cargo:$key=$value` | | [`rerun_if_changed!($path)`] | `cargo:rerun-if-changed=$path` | | [`rerun_if_env_changed!($key)`] | `cargo:rerun-if-env-changed=$key` | | [`rustc_cdylib_link_arg!($flag)`] | `cargo:rustc-cdylib-link-arg=$flag` | | [`rustc_cfg!($feature)`] | `cargo:rustc-cfg=$feature` | | [`rustc_env!($key, $value)`] | `cargo:rustc-env=$key=$value` | | [`rustc_flags!($flags)`] | `cargo:rustc-flags=$flags` | | [`rustc_link_arg!($arg)`] | `cargo:rustc-link-arg=$arg` | | [`rustc_link_arg_bin!($bin => $arg)`] | `cargo:rustc-link-arg-bin=$bin=$arg` | | [`rustc_link_arg_bins!($arg)`] | `cargo:rustc-link-arg-bins=$arg` | | [`rustc_link_lib!($name => $kind)`] | `cargo:rustc-link-lib=$kind=$name` | | [`rustc_link_search!($path => $kind)`] | `cargo:rustc-link-search=$kind=$path` | | [`warning!($message)`] | `cargo:warning=$message` | [`pair!($key, $value)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.pair.html [`rerun_if_changed!($path)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rerun_if_changed.html [`rerun_if_env_changed!($key)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rerun_if_env_changed.html [`rustc_cdylib_link_arg!($flag)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rustc_cdylib_link_arg.html [`rustc_cfg!($feature)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rustc_cfg.html [`rustc_env!($key, $value)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rustc_env.html [`rustc_flags!($flags)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rustc_flags.html [`rustc_link_arg!($arg)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rustc_link_arg.html [`rustc_link_arg_bin!($bin => $arg)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rustc_link_arg_bin.html [`rustc_link_arg_bins!($arg)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rustc_link_arg_bins.html [`rustc_link_lib!($name => $kind)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rustc_link_lib.html [`rustc_link_search!($path => $kind)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.rustc_link_search.html [`warning!($message)`]: https://docs.rs/cargo-emit/latest/cargo_emit/macro.warning.html ## License This project is released under either: - [MIT License](https://github.com/nvzqz/cargo-emit/blob/master/LICENSE-MIT) - [Apache License (Version 2.0)](https://github.com/nvzqz/cargo-emit/blob/master/LICENSE-APACHE)