23 releases (9 stable)

1.3.1 Jan 8, 2023
1.2.2 Nov 7, 2022
1.2.1 Oct 25, 2022
1.0.2 May 29, 2022
0.1.0 Mar 21, 2020

#80 in Parser implementations

Download history 26426/week @ 2022-11-26 27166/week @ 2022-12-03 29403/week @ 2022-12-10 31368/week @ 2022-12-17 17365/week @ 2022-12-24 17999/week @ 2022-12-31 20895/week @ 2023-01-07 19692/week @ 2023-01-14 23179/week @ 2023-01-21 25592/week @ 2023-01-28 20019/week @ 2023-02-04 21911/week @ 2023-02-11 20204/week @ 2023-02-18 19835/week @ 2023-02-25 21427/week @ 2023-03-04 21474/week @ 2023-03-11

86,647 downloads per month
Used in 34 crates (7 directly)

MIT/Apache

61KB
1K SLoC

target-spec

target-spec on crates.io Documentation (latest release) Documentation (main) Changelog 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.

Optional features

  • summaries: Adds the summaries module to enable serialization of Platform and TargetFeatures.
  • proptest1: Enables support for property-based testing of Platform and TargetFeatures using proptest.

Minimum supported Rust version

The minimum supported Rust version (MSRV) is:

  • For target-spec 1.0.x: Rust 1.54.
  • For target-spec 1.1.x: Rust 1.56.
  • For target-spec 1.2.x: Rust 1.58.
  • For target-spec 1.3.x: Rust 1.62.

Within the 1.x series, MSRV bumps will be accompanied by a minor version update.

To pretty-print target-spec errors, consider using the miette diagnostic library with target-spec-miette.

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–1MB
~21K SLoC