The Shell Commands Addon allows you to execute commands and scripts while running your tests. It supports all major operating systems: Windows (CMD), Linux (sh) and macOS. By utilizing “Command” parameter, you can execute any system command or a locally stored script.
If you ever need to send system shell commands or run scripts during your tests, this Addon will allow you to do so.
Actions
This Addon contains a single action for sending those commands called: 'Execute'.
The input parameters are:
Command
Expected result
Timeout
Output file path
Output file name
The output parameters are:
The exit code
The output file path
The shell output
**Please note, that the step will be considered passed even if the command itself fails. You will be able to determine the success of the command by checking if your expected result is contained in the output of the shell command.
Examples
Windows:
In this example we’ll run the “ipconfig” command. Since the command itself is endless, let's add a timeout. We’ll place the output of the command in a file in order to review it once we complete our test run:
Execute Shell Command Action in the TestProject Recorder Step Widget
Now, we are able to see the output of the command in our desired file:
Output of the Command
Linux:
In this example, we will create a .bat file on our Linux desktop. We’ll create a new step using the Execute action and type the command “touch path/hello.bat”:
Execute Shell Command Action in the TestProject Recorder Step Widget
Once we complete the test run, we can see the file was created as expected on our desktop:
.bat file on our Linux desktop
macOS:
In this example, we’ll create a new folder within a folder on our macOS desktop. We will use the Execute action with the command “mkdir path folder_name.”:
Execute Shell Command Action in the TestProject Recorder Step Widget
Once we complete our test run, we'll be able to see the new folder at the desired location: