Passing arguments to test scripts

Overview¶

To pass arguments to test scripts there are two basic approaches:

Pass information via environment variables to the squishrunner process (which executes the test scripts, and let the test scripts get the environment variable values).
Pass information via plain files which are read by the test scripts (using script language file I/O functionality ( How to Read Data from an External File ), or by using Squish' Test Data Functions ( Reading test data, data-driven testing )).

Examples¶

Setting environment variable and starting squishrunner¶

export TEST_CASE_MESSAGE=Hello world!
squishrunner --testsuite suite_my_test_suite

In Unix shells (Linux, OS X, etc.)

set TEST_CASE_MESSAGE=Hello world!
squishrunner --testsuite suite_my_test_suite

On Windows (in cmd.exe)

Reading environment variable in JavaScript test scripts¶

function main() {
    // Read our environment variable:
    var msg = OS.getenv("TEST_CASE_MESSAGE");
    test.log("Test case message: " + msg);
}

test.js

Reading environment variable in Python test scripts¶

import os

def main():
    # Read our environment variable:
    msg = os.environ["TEST_CASE_MESSAGE"]
    test.log("Test case message: " + msg)

test.py

Passing data between test cases only possible via files¶

To pass data from one test case to another environment variables cannot be used (because each test case is executed by a new squishrunner instance which does not see any of the environment variables which have been set in a previous squishrunner instance).

So typically one would write the data to files in one test script and read them in the next test case's script.

testInteraction Functions
How to Read Data from an External File
Test Data Functions
Reading test data, data-driven testing (Test Data Functions)