feature-probe

Crates.iofeature-probe
lib.rsfeature-probe
version0.1.1
sourcesrc
created_at2018-06-07 03:33:30.139377
updated_at2018-06-07 03:38:37.677492
descriptionProbe for rustc features from build.rs
homepage
repositoryhttps://github.com/tov/feature-probe-rs
max_upload_size
id68996
size21,028
Jesse A. Tov (tov)

documentation

README

feature-probe-rs: probe for rustc features from build.rs

Build Status Crates.io License: MIT License: Apache 2.0

To support multiple versions of Rust, it's often necessary to conditionally compile parts of our libraries or programs. It's possible to allow users to specify what features to enable, but detection is better, because users get all the features that their version of Rust supports. And while we could check the rustc version, it's better to probe for individual features. That way, code will work both on nightly, and on stable releases after particular features stabilize, without changes.

Usage

It’s on crates.io, so you can add

[build-dependencies]
feature-probe = "0.1.1"

Then add to your build.rs:

extern crate feature_probe;

use feature_probe::Probe;

Then you can probe for features such as types or expressions. For example:

fn main () {
    let probe = Probe::new();
    
    if probe.probe_type("i128") {
        println!("cargo:rustc-cfg=int_128");
    }
    
    if probe.probe_type("::std::ops::RangeInclusive<u64>") {
        println!("cargo:rustc-cfg=inclusive_range");
    }
}

This crate supports Rust version 1.16.0 and later.

Commit count: 18

cargo fmt