16 Environment Variables

zhangly 2021-03-15 19:02:28
Categories: > Tags:

本节列出来rez在某些情况下产生的环境变量,以及你可以设置的影响rez操作的环境变量。

Context环境变量

这些是rez在解析环境中产生的环境变量。

REZ_RXT_FILE : 当前context的文件路径 ( rxt 文件)。
REZ_USED :用于解析这个环境的rez安装路径。
REZ_USED_IMPLICIT_PACKAGES : 用于解析环境的隐含包列表。
REZ_USED_PACKAGES_PATH : 用于解析环境的软件包搜索路径。
REZ_USED_RESOLVE : 已解析的软件包列表,例如 “platform-linux utils-1.2.3”。
REZ_USED_EPH_RESOLVE : 已解析的临时包的列表,例如".foo.cli-1 .debugging-0"。
REZ_USED_REQUEST : 环境的包请求,以字符串表示,例如 “maya-2017 maya_utils-1.3+”。不包括隐含包。
REZ_USED_REQUESTED_TIMESTAMP : 这个已解析环境的时间,由用户使用rez-env -time标志明确设置,否则为零。
REZ_USED_TIMESTAMP :这个环境被解析的时间;或者为REZ_USED_REQUESTED_TIMESTAMP的值,如果不为零。
REZ_USED_VERSION : 用于解析这个环境的rez版本。
REZ_SHELL_INIT_TIMESTAMP : 当前shell被实例化的时间。
REZ_SHELL_INTERACTIVE : 如果shell是交互式的,则为’1’,否则为’0’(即当指定命令时,如rez-env foo -- mycommand)。

每个程序包都会生成以下变量。(PKG代表包的大写名称)

REZ_(PKG)_*BASE:包安装的基本目录,例如 “/packages/utils/1.0.0”。
REZ_PKG)_ROOT:包安装的根目录,例如 “/packages/utils/1.0.0/python-2.7”。
REZ_(PKG)_VERSION:软件包的版本。
REZ_(PKG)_MAJOR_VERSION:*软件包的主要版本,或为空。
REZ_(PKG)_MINOR_VERSION:*软件包的次要版本,或为空。
REZ_(PKG)_PATCH_VERSION:软件包的补丁版本,或为空。

对于每个临时包的请求,都会生成以下变量。

(下面变量中的"PKG)"是大写的包名,其中的点用下划线代替,并去掉最前的点符号。)

REZ_EPH_(PKG)_REQUEST:已解析的临时包请求。

构建时环境变量

REZ_BUILD_ENV:始终存在于编译过程中,值为1。
REZ_BUILD_INSTALL:如果正在进行安装(无论是rez-build -i还是rez-release),其值为1,否则为0。
REZ_BUILD_INSTALL_PATH :如果正在进行安装,则安装路径为1,否则为0。
REZ_BUILD_PATH :构建输出的路径。
REZ_BUILD_PROJECT_DESCRIPTION :正在构建的包描述属性。
REZ_BUILD_PROJECT_FILE :正在构建的软件包的文件路径 (通常是package文件)。
REZ_BUILD_PROJECT_NAME :正在构建的软件包的名称。
REZ_BUILD_PROJECT_VERSION :正在构建的软件包的版本。
REZ_BUILD_REQUIRES:联编需求的空间分隔列表,来自当前包的 requires、build_requires 和 private_build_requires 属性,包括当前变量的需求。
REZ_BUILD_REQUIRES_UNVERSIONED :相当于REZ_BUILD_REQUIRES的未版本列表。
REZ_BUILD_SOURCE_PATH:包含package文件的路径。
REZ_BUILD_THREAD_COUNT: 用于构建的线程数。
REZ_BUILD_TYPE :local或central;之一。如果正在进行发布,则值为central。
REZ_BUILD_VARIANT_INDEX:当前正在构建的变体的索引。对于非变体包,这个值是 “0”。
REZ_BUILD_VARIANT_REQUIRES :当前变体的运行时需求的空间分隔的列表。

(不包括在REZ_BUILD_REQUIRES中找到的通用需求。对于非变体构建,这是一个空字符串。)
REZ_BUILD_VARIANT_SUBPATH :包含当前变体的子目录。对于非变体构建,这是一个空字符串。

运行时环境变量

REZ_(CONFIG_ENTRY) :任何给定的rez config条目 (参见rezconfig.py文件)。为了方便起见,你可以用一个环境变量覆盖这个设置。这里,(CONFIG_ENTRY)是设置名称的大写字母。例如,通常用这种方式覆盖的设置是 packages_path,其对应的变量是 REZ_PACKAGES_PATH。
REZ_(CONFIG_ENTRY)_JSON :和前面的env-var一样,只是格式是JSON字符串。这意味着一些更复杂的设置可以被覆盖,而这些设置在非JSON情况下是不支持的(package_filter就是一个例子)。
EDITOR :在 Linux 和 OSX 系统上,如果 rez 需要使用编辑器,这将设置默认的编辑器(一个例子是在 release 时,如果 prompt_release_message 配置设置为 true)。
REZ_KEEP_TMPDIRS:如果设置为非空字符串,这将防止rez清理任何临时目录。为了调试的目的。
REZ_SIGUSR1_ACTION:如果你把它设置为print_stack,当发送USR1信号时,rez会把当前的stacktrace打印到stdout。这是为调试目的而设置的。