32 releases (18 stable)
3.2.2 | Sep 11, 2024 |
---|---|
3.2.1 | Jul 31, 2024 |
3.1.0 | Feb 4, 2024 |
3.0.1 | Jul 29, 2023 |
0.1.0 | Mar 21, 2020 |
#472 in Parser implementations
200,723 downloads per month
Used in 62 crates
(8 directly)
96KB
1.5K
SLoC
target-spec
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 viaPlatform::new_custom
.summaries
: Adds thesummaries
module to enable serialization ofPlatform
andTargetFeatures
.proptest1
: Enables support for property-based testing ofPlatform
andTargetFeatures
usingproptest
.
Minimum supported Rust version
The minimum supported Rust version (MSRV) 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.
Within the 3.x series, MSRV bumps will be accompanied by a minor version update.
Related crates
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.2MB
~25K SLoC