#target #triple #json #build

build target_build_utils

DEPRECATED: Use Cargo environment variables CARGO_CFG_TARGET_*

7 releases

0.3.1 May 2, 2017
0.3.0 Feb 10, 2017
0.2.1 Feb 3, 2017
0.2.0 Jan 18, 2017
0.1.1 Jul 29, 2016

#9 in Build Utils

Download history 371/week @ 2018-10-11 505/week @ 2018-10-18 452/week @ 2018-10-25 613/week @ 2018-11-01 583/week @ 2018-11-08 796/week @ 2018-11-15 625/week @ 2018-11-22 580/week @ 2018-11-29 584/week @ 2018-12-06 479/week @ 2018-12-13 525/week @ 2018-12-20 463/week @ 2018-12-27 500/week @ 2019-01-03

2,786 downloads per month
Used in 160 crates (2 directly)

ISC/Apache-2.0

31KB
518 lines

DEPRECATED

Use environment variables set by cargo from 1.14.0 onwards.

They look like this: CARGO_CFG_TARGET_OS, CARGO_CFG_TARGET_ENV


Travis CI Appveyor CI

Utility crate to handle the TARGET environment variable passed into build.rs scripts.

Unlike rust’s #[cfg(target…)] attributes, build.rs-scripts do not expose a convenient way to detect the system the code will be built for in a way which would properly support cross-compilation.

This crate exposes target_arch, target_vendor, target_os and target_abi very much in the same manner as the corresponding cfg attributes in Rust do, thus allowing build.rs script to adjust the output depending on the target the crate is being built for..

Custom target json files are also supported.

Using target_build_utils

This crate is only useful if you’re using a build script (build.rs). Add dependency to this crate to your Cargo.toml via:

[package]
# ...
build = "build.rs"

[build-dependencies]
target_build_utils = "0.1"

Then write your build.rs like this:

extern crate target_build_utils;
use target_build_utils::TargetInfo;

fn main() {
    let target = TargetInfo::new().expect("could not get target info");
    if target.target_os() == "windows" {
        // conditional stuff for windows
    }
}

Now, when running cargo build, your build.rs should be aware of the properties of the target system when your crate is being cross-compiled.

License

llvm_build_utils is distributed under ISC (MIT-like) or Apache (version 2.0) license at your choice.

Dependencies

~1MB
~24K SLoC