4.2 (2026-08-29)

Changes to path registration helpers

This release now provides helpers for both environment and Python path registration. Originally, releng-tool provided a releng_register_path helper to register paths into the Python system paths. This helper has now been renamed to releng_register_python_path to be more explicit on where the path is being registered on.

For registering paths in the environment (i.e. PATH), the helper releng_register_env_path has been added.

Both helpers support appending to respective path configurations. Both options also support a prepend argument if a path priority is required.

Build identifier argument

releng-tool's command line now accepts a --build-id argument. This is a helper for projects who which to easily pass in an identifier for a run (e.g. a CI pipeline/job identifier) which can be used to tailor either specific packages or used in a post-build stage. Setting this argument will populate an environment/script variable RELENG_BUILD_ID which can be used at any stage of a run.

Platform type variables

New environment/script variables have been added to help identify a platform type. Supported variables include:

• RELENG_HOST_OS_LINUX

• RELENG_HOST_OS_MACOS

• RELENG_HOST_OS_WINDOWS

This is aimed to be a simple/quick alternative for project's supporting multiple platform types if not looking to rely on Python's platform, sys or other modules.