13 releases (7 breaking)

0.8.0 Sep 14, 2021
0.7.0 Feb 24, 2021
0.6.1 Feb 14, 2021
0.5.0 Dec 2, 2020
0.1.0 Mar 21, 2020

#65 in Development tools

Download history 1812/week @ 2021-06-07 2372/week @ 2021-06-14 2345/week @ 2021-06-21 2191/week @ 2021-06-28 2627/week @ 2021-07-05 2187/week @ 2021-07-12 3206/week @ 2021-07-19 2794/week @ 2021-07-26 2882/week @ 2021-08-02 2671/week @ 2021-08-09 2245/week @ 2021-08-16 2111/week @ 2021-08-23 2238/week @ 2021-08-30 2525/week @ 2021-09-06 3665/week @ 2021-09-13 3280/week @ 2021-09-20

10,634 downloads per month
Used in 14 crates (2 directly)

MIT/Apache

46KB
832 lines

target-spec

target-spec on crates.io Documentation (latest release) Documentation (main) License License

Evaluate Cargo.toml target specifications against platform triples.

Cargo supports platform-specific dependencies. These dependencies can be specified in one of two ways:

# 1. As Rust-like `#[cfg]` syntax.
[target.'cfg(all(unix, target_arch = "x86_64"))'.dependencies]
native = { path = "native/x86_64" }

# 2. Listing out the full target triple.
[target.x86_64-pc-windows-gnu.dependencies]
winhttp = "0.4.0"

target-spec provides the eval API which can be used to figure out whether such a dependency will be included on a particular platform.

use target_spec::eval;

// Evaluate Rust-like `#[cfg]` syntax.
let cfg_target = "cfg(all(unix, target_arch = \"x86_64\"))";
assert_eq!(eval(cfg_target, "x86_64-unknown-linux-gnu"), Ok(Some(true)));
assert_eq!(eval(cfg_target, "i686-unknown-linux-gnu"), Ok(Some(false)));
assert_eq!(eval(cfg_target, "x86_64-pc-windows-msvc"), Ok(Some(false)));

// Evaluate a full target-triple.
assert_eq!(eval("x86_64-unknown-linux-gnu", "x86_64-unknown-linux-gnu"), Ok(Some(true)));
assert_eq!(eval("x86_64-unknown-linux-gnu", "x86_64-pc-windows-msvc"), Ok(Some(false)));

For more advanced usage, see [Platform] and [TargetSpec].

Contributing

See the CONTRIBUTING file for how to help out.

License

This project is available under the terms of either the Apache 2.0 license or the MIT license.

Dependencies

~0.3–0.8MB
~18K SLoC