#features #exclusive #mutually #macro #mutually-exclusive

no-std mutually_exclusive_features

Macros to check that only none or one of a set of features is enabled at a time, as known as mutually exclusive features

2 unstable releases

0.1.0 Feb 5, 2024
0.0.3 Nov 9, 2023
0.0.2 Nov 9, 2023
0.0.1 Nov 9, 2023

#626 in Rust patterns

Download history 45400/week @ 2024-12-08 41095/week @ 2024-12-15 16455/week @ 2024-12-22 17563/week @ 2024-12-29 42755/week @ 2025-01-05 41384/week @ 2025-01-12 45089/week @ 2025-01-19 46116/week @ 2025-01-26 52410/week @ 2025-02-02 57245/week @ 2025-02-09 46608/week @ 2025-02-16 46065/week @ 2025-02-23 46494/week @ 2025-03-02 46701/week @ 2025-03-09 49210/week @ 2025-03-16 50688/week @ 2025-03-23

195,555 downloads per month
Used in 67 crates (5 directly)

MIT/Apache

8KB

Mutually Exclusive Features

crates.io Build Status docs

Macros to check mutually exclusive features in Rust


It contains none_or_one_of and exactly_one_of macros.

Both check mutually exclusive features in Rust, but none_or_one_of allows for no features to be enabled, while exactly_one_of requires exactly one feature to be enabled.

Usage


none_or_one_of


Call it with the list of features you want to be mutually exclusive:

use mutually_exclusive_features::none_or_one_of;
none_or_one_of!("feature1", "feature2", "feature3");

Which will generate the following code:

#[cfg(all(feature="feature1", feature="feature2"))]
compile_error!("The `feature1` and `feature2` features are mutually exclusive and cannot be enabled at the same time!");

#[cfg(all(feature="feature1", feature="feature3"))]
compile_error!("The `feature1` and `feature3` features are mutually exclusive and cannot be enabled at the same time!");

#[cfg(all(feature="feature2", feature="feature3"))]
compile_error!("The `feature2` and `feature3` features are mutually exclusive and cannot be enabled at the same time!");

exactly_one_of


It's the same, but requires exactly one feature to be enabled:

use mutually_exclusive_features::exactly_one_of;
exactly_one_of!("feature1", "feature2", "feature3");

Which will generate the following code:

#[cfg(all(feature="feature1", feature="feature2"))]
compile_error!("The `feature1` and `feature2` features are mutually exclusive and cannot be enabled at the same time!");

#[cfg(all(feature="feature1", feature="feature3"))]
compile_error!("The `feature1` and `feature3` features are mutually exclusive and cannot be enabled at the same time!");

#[cfg(all(feature="feature2", feature="feature3"))]
compile_error!("The `feature2` and `feature3` features are mutually exclusive and cannot be enabled at the same time!");

#[cfg(not(any(feature="feature1", feature="feature2", feature="feature3")))]
compile_error!("You must enable exactly one of `feature1`, `feature2`, `feature3` features!");

No runtime deps