#conditional-compilation #syntax #boolean #cfg #attributes #expression #rather

macro efg

Conditional compilation using boolean expression syntax, rather than any(), all(), not()

5 releases

0.1.4 Dec 18, 2022
0.1.3 Dec 18, 2022
0.1.2 Dec 7, 2021
0.1.1 Dec 6, 2021
0.1.0 Dec 6, 2021

#16 in #rather

MIT/Apache

20KB
329 lines

Conditional compilation expressions

github crates.io docs.rs build status

Conditional compilation using boolean expression syntax, rather than any(), all(), not().

[dependencies]
efg = "0.1"

Summary

Rust's cfg and cfg_attr conditional compilation attributes use a restrictive domain-specific language for specifying configuration predicates. The syntax is described in the Conditional compilation page of the Rust reference. The reason for this syntax as opposed to ordinary boolean expressions was to accommodate restrictions that old versions of rustc used to have on the grammar of attributes.

However, all restrictions on the attribute grammar were lifted in Rust 1.18.0 by rust-lang/rust#40346. This crate explores implementing conditional compilation using ordinary boolean expressions instead: &&, ||, ! as usual in Rust syntax.

built into rustcthis crate
#[cfg(any(thing1, thing2, …))]#[efg(thing1 || thing2 || …)]
#[cfg(all(thing1, thing2, …))]#[efg(thing1 && thing2 && …)]
#[cfg(not(thing))]#[efg(!thing)]

Examples

A real-world example from the quote crate:

#[efg(feature "proc-macro" && !(target_arch "wasm32" && target_os "unknown"))]
extern crate proc_macro;

and from the proc-macro2 crate:

#[efg(super_unstable || feature "span-locations")]
pub fn start(&self) -> LineColumn {

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps