Module dinghy_build::build_env

Target-aware environment manipulations.

cc-rs and pkg-config-rs use a similar convention where some environment variables (like CC, CFLAGS or PKG_CONFIG_PATH) can be tagged with the current rustc target to distinguish a native build environment and one or several cross-compilation ones.

For instance, while compiling for Android arm, cc-rs looks first at CC_arm-linux-androideabi, then CC_arm_linux_androideabi, the TARGET_CC and finally CC.

This crates implements some of the same logic and also helps generating these variables names. It also notify all environment lookup “back” to cargo using cargo:rerun-if-env-changed markup.

Functions

• append_path_to_env
  Append a value to a PATH-like (:-separated) environment variable.
• append_path_to_target_env
  Append a value to a PATH-like (:-separated) environment variable taking target scoping rules into consideration.
• build_env
  Build-context aware environment variable access.
• envify
  Capitalize and replace - by _.
• set_all_env
  Set a bunch of environment variables.
• set_env
  Set one environment variable.
• set_env_ifndef
  Set one environment variable if not set yet.
• set_target_env
  Set one environment variable with target-scoping rules.
• sysroot_path
  Access a required TARGET_SYSROOT variable, suggesting to define it or use Dinghy.
• target_env
  Access var_base directly, or use targetting rules depending on the build being native or cross.
• target_env_from_triple
  Access var_base directly, using targetting rules.