Crate rsconf 

The rsconf crate contains build.rs helper utilities and funcitionality to assist with managing complicated build scripts, interacting with the native/system headers and libraries, exposing rust constants based off of system headers, and conditionally compiling rust code based off the presence or absence of certain functionality in the system headers and libraries.

This crate can be used standalone or in conjunction with the cc crate when introspecting the build system’s environment.

In addition to facilitating easier ffi and other native system interop, rsconf also exposes a strongly typed API for interacting with cargo at build-time and influencing its behavior, including more user-friendly alternatives to the low-level println!("cargo:xxx") “api” used to enable features, enable #[cfg(...)] conditional compilation blocks or define cfg values, and more.

Macros

warn

Emit a compile-time warning.

Structs

Target

Exposes an interface for testing whether the target system supports a particular feature or provides certain functionality. This is the bulk of the rsconf api.

Enums

Endian

LinkType

Specifies how a dependency library is linked.

Functions

add_library_search_path

Add a path to the list of directories rust will search when attempting to find a library to link against.

debug

Whether or not debug assertions are enabled.

declare_cfg

Informs the compiler of a cfg with the name name, possibly enabled.

declare_cfg_values

Inform the compiler of a cfg with name name and all its known valid values.

declare_feature

Informs the compiler of a feature with the name name, possibly enabled.

enable_cfg

Enables Cargo/rustc feature with the name name.

enable_feature

Enables a feature flag that compiles code annotated with #[cfg(feature = "name")].

host_triple

The rustc/llvm triple of the host hardware/os/toolchain.

link_libraries

Instruct Cargo to link the target object against libraries in the order provided.

link_library

Instruct Cargo to link the target object against library.

num_jobs

The specified degree of build parallelism, defaulting to the host’s thread count.

opt_level

The optimization level specified for the build profile specified/being compiled.

out_dir

The output directory in which all output and intermediate artifacts should be placed.

profile

The selected build profile, e.g. release, debug, or a custom profile as defined in Cargo.toml.

rebuild_if_env_changed

Instruct Cargo to rerun the build script if the named environment variable changes.

rebuild_if_envs_changed

Instruct Cargo to rerun the build script if any of the named environment variables change.

rebuild_if_path_changed

Instruct Cargo to rerun the build script if the provided path changes.

rebuild_if_paths_changed

Instruct Cargo to rerun the build script if any of the provided paths change.

rustc

The path to the rustc compiler being used.

rustc_linker

The path to the linker cargo has been configured to use for the current target, if any.

rustc_workspace_wrapper

The rustc wrapper used for the workspace, if any.

rustc_wrapper

The rustc wrapper configured with the RUSTC_WRAPPER environment variable, if any.

rustdoc

The path to the rustdoc compiler being used.

rustflags

All the extra flags rustc will ultimately be invoked with.

set_cfg_value

Activates conditional compilation for code behind #[cfg(name = "value")] or with if cfg!(name = "value").

set_env_value

Makes an environment variable available to your code at build time, letting you use the value as a compile-time constant with env!(NAME).

target_triple

The rustc/llvm triple of the target hardware/os/toolchain.