rez.rezconfig

Rez configuration settings. Do not change this file.

Settings are determined in the following way (higher number means higher precedence):

  1. The setting is first read from this file;

  2. The setting is then overridden if it is present in another settings file(s) pointed at by the $REZ_CONFIG_FILE environment variable. Note that multiple files are supported, separated by os.pathsep;

  3. The setting is further overriden if it is present in $HOME/.rezconfig,

UNLESS $REZ_DISABLE_HOME_CONFIG is 1;

  1. The setting is overridden again if the environment variable $REZ_XXX is present, where XXX is the uppercase version of the setting key. For example, “image_viewer” will be overriden by $REZ_IMAGE_VIEWER. List values can be separated either with “,” or blank space. Dict values are in the form “k1:v1,k2:v2,kn:vn”;

  2. The setting can also be overriden by the environment variable $REZ_XXX_JSON, and in this case the string is expected to be a JSON-encoded value;

  3. This is a special case applied only during a package build or release. In this case, if the package definition file contains a “config” section, settings in this section will override all others.

Note that in the case of plugin settings (anything under the “plugins” section of the config), (4) and (5) do not apply.

Variable expansion can be used in configuration settings. The following expansions are supported: - Any property of the system object: Eg “{system.platform}” (see system.py) - Any environment variable: Eg “${HOME}”

The following variables are provided if you are using rezconfig.py files: - ‘rez_version’: The current version of rez.

Paths should use the path separator appropriate for the operating system (based on Python’s os.path.sep). So for Linux paths, / should be used. On Windows (unescaped) should be used.

Note: The comments in this file are extracted and turned into Wiki content. Pay attention to the comment formatting and follow the existing style closely.