​
Description

The run command is used to embed and execute another file within the current script. This is useful for reusing common sequences of commands or modularizing your scripts for better organization and maintainability.

​
Arguments

ArgumentTypeDescription
filestringThe path to the file to embed and run. Should be relative to the root of your git repository.

​
Example usage

command: run
file: relative/path/to/another-script.yaml

​
Protips

  • Use the run command to centralize reusable logic, such as login flows or setup steps, into separate files.
  • Ensure the file path is relative to the current test file’s directory. For example, if the test file is at testdriver/homepage/chat-functionalities.yaml and say the login snippet is present at the conventional testdriver/snippets/login.yaml it should be referrenced as :
command: run
file: ../snippets/login.yaml

​
Gotchas

  • If the specified file doesn’t exist or contains errors, the command will fail.
  • Ensure the embedded file is compatible with the current script’s context, such as variable dependencies or session requirements.

​
Notes

  • The run command is ideal for creating modular and maintainable test scripts by reusing common workflows.
  • This command supports nesting, allowing you to call scripts that themselves use the run command.