cargo-feature-combinations

build status test status benchmarks crates.io docs.rs

Plugin for cargo to run commands against selected combinations of features.

Installation

bash cargo install cargo-feature-combinations

Usage

In most cases, just use the command as if it was cargo. However, there are a few optional flags and the matrix subcommand.

bash cargo feature-combinations check cargo feature-combinations test cargo feature-combinations --fail-fast test cargo feature-combinations build cargo feature-combinations --silent build cargo feature-combinations matrix

For details, please refer to --help: ```bash $ cargo feature-combinations --help

USAGE: cargo [+toolchain] [SUBCOMMAND] cargo [+toolchain] [OPTIONS] [CARGOOPTIONS] [CARGOSUBCOMMAND]

SUBCOMMAND: matrix Print JSON feature combination matrix to stdout

OPTIONS: --silent Hide cargo output and only show summary --fail-fast Fail fast on the first bad feature combination --help Print help information ```

Configuration

In your Cargo.toml, you can configure the feature combination matrix: ```toml [package.metadata.cargo-feature-combinations]

Exclude groupings of features that are incompatible or do not make sense

skipfeaturesets = [ ["foo", "bar"], ]

Exclude features from the feature combination matrix

denylist = ["default", "full"] ```

Usage with github-actions

The github-actions matrix feature allows more efficient testing of all feature set combinations in CI.

The following workflow file uses cargo-feature-combinations to automatically generate a feature matrix and runs up to 256 feature combinations in a matrix job.

Linting

bash cargo clippy --tests --benches --examples -- -Dclippy::all -Dclippy::pedantic

Acknowledgements

The [cargo-all-features](https://crates.io/crates/cargo-all-features) crate is similar yet offers more complex configuration and is lacking a summary.

TODO