Add ${EXECUTION ID} automatic variable and --executionid option (#2743) - #5757
Open
JonnasFigueiredo wants to merge 2 commits into
Open
JonnasFigueiredo wants to merge 2 commits into
JonnasFigueiredo wants to merge 2 commits into
Conversation
…tframework#2743) Generate a unique ID for each execution and make it available as the `${EXECUTION ID}` automatic variable. The ID is also stored as `Execution ID` metadata of the top level suite so that it is visible in logs and reports and saved in the output file. By default the ID is a random UUID. It can be set explicitly with the new `--executionid` option, for example to share a common ID across parallel executions or to use an application specific scheme. This implements the core of the design outlined in the issue. Exposing the existing test and suite IDs as automatic variables, also proposed there, is left out of scope and can be handled separately.
JonnasFigueiredo
force-pushed
the
feature/execution-id
branch
from
August 18, 2026 12:56
4336f88 to
a5eb126
Compare
Merge master into feature/execution-id
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Implements #2743.
Adds a unique execution ID to each Robot Framework run.
What it does
${EXECUTION ID}automatic variable.Execution IDmetadata on the top level suite, so it is visible in logs and reports and saved inoutput.xml(and carried over torebotgenerated reports).uuid.uuid4()).--executionidoption to set the ID explicitly, e.g. to share a common ID across parallel executions (pabot) or to use an application specific scheme.Design
This follows the design @pekkaklarck outlined in #2743: generate a UUID, allow overriding it from the command line, add it as top level suite metadata, and expose it as a global variable. Exposing the existing internal test/suite IDs as automatic variables — also proposed in that issue — is intentionally left out of scope and can be handled separately.
An explicit
--metadata "Execution ID:..."still takes precedence over the automatically added metadata.Tests & docs
execution_idproperty (utest/conf/test_settings.py).atest/testdata|robot/variables/builtin_variables.robot).${EXECUTION ID}automatic variable; the--executionidoption is documented in--help.Happy to adjust the variable/metadata naming, the default ID scheme, or the scope based on your feedback.