36 releases (22 stable)

new 3.4.1 Feb 15, 2025
3.3.1 Dec 24, 2024
3.2.2 Sep 11, 2024
3.2.1 Jul 31, 2024
0.1.0 Mar 21, 2020

#377 in Parser implementations

Download history 61735/week @ 2024-10-27 58522/week @ 2024-11-03 63437/week @ 2024-11-10 46298/week @ 2024-11-17 34298/week @ 2024-11-24 45957/week @ 2024-12-01 47565/week @ 2024-12-08 43583/week @ 2024-12-15 24174/week @ 2024-12-22 28476/week @ 2024-12-29 44639/week @ 2025-01-05 49548/week @ 2025-01-12 41730/week @ 2025-01-19 42166/week @ 2025-01-26 48246/week @ 2025-02-02 53082/week @ 2025-02-09

187,423 downloads per month
Used in 64 crates (8 directly)

MIT/Apache

105KB
2K 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").unwrap(), Some(true));
assert_eq!(eval(cfg_target, "i686-unknown-linux-gnu").unwrap(), Some(false));
assert_eq!(eval(cfg_target, "x86_64-pc-windows-msvc").unwrap(), Some(false));

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

For more advanced usage, see Platform and TargetSpec.

Optional features

  • custom: Adds support for custom targets via Platform::new_custom.
  • 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 Rust 1.78. The MSRV history is:

  • For target-spec 3.0.x: Rust 1.66.
  • For target-spec 3.1.x: Rust 1.73.
  • For target-spec 3.2.x: Rust 1.75.
  • For target-spec 3.3.x and 3.4.x: Rust 1.78.

Within the 3.x series, MSRV bumps will be accompanied by a minor version update. The last 6 months of stable Rust releases will be supported.

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–1.1MB
~23K SLoC