# Test Data File for Scripted Tests.
#
# Each test is a one-line entry of the form:
#
# <TestGroup>|<TestScript>|<ExitCode>|[<Host>:]<TestLog>|<ExpectedStringRegex>|<Comments>
#
# Where:
# <TestGroup> is an arbitrary name used to apply to a group of tests, allowing that group
# of tests to be executed independently of other configured tests. By default, all
# tests are executed; call run_scripted_tests.sh with '-g <TestGroup>' to indicate that the
# specified group of tests are to be run. This is intended to speed up interactive testing
# for a focused group of tests.
#
# <TestScript> is a script to call. It can setup arbitrarily sophisticated
# tests. The script should accept no parameters. It should display some
# indication of the scenario being setup to test.
# The value of TestScript should be of the form:
#
# test_script-<TestDesc>.sh
#
# where <TestDesc> should contain letters, numbers, and underscores, but not
# dash or other special characters. For example, it could be:
# test_script-recover_correct_ckp_1.sh. The _1 numeric suffix can be used
# to group together a family of related tests with TestDesc values that
# vary only by the suffix. Scripts must exist in the test directory in a
# Battle School Lab Environment, i.e. /p4/sdp/test/bsw.
#
# The <TestScript> value can also be the special value 'no_script', meaning that no
# test script is executed. This allows additional checks of logs to be done based
# on the execution of the most recent executed test.
#
# <ExitCode> is the expected exit code, which must be a whole number (integer 0 or
# greater). If the actual test exist code is not match, the test is deemed to have
# failed. A special value of 'U' meaning Undefined can be given rather than a
# whole number to indicate that any exit code is accepted. (The test may still fail
# depending on the <Output>). A special value of 'N' can be given to indicate that
# any non-zero exit code is accepted.
#
# If <TestScript> is set to 'no_script', the exit code is ignored, so fill a '-'
# in for the <ExitCode> field.
#
# <TestLog> Specify the absolute path to the log containing the expected string,
# or the special value 'output' to scan the output of the command rather than
# a log file. The <TestLost> can also be of the form <Host>:<Log> to indicate
# the expected string should be checked on the specified host. For example,
# a value of syd-helix-04:/p4/1/logs/recreate_offline_db.og will check that
# log on the syd-helix-04 host.
#
# The special value 'output' cannot be used if TestScript is set to 'no_script'.
#
# <ExpectedStringRegex> is a string of text expected of the executed command in
# either the output or a given logfile. The string can be a regular expression.
#
# <Comments> are short comments for the human reviewer of the test, describing what
# is expected in the output, what is being tested, etc.
# <TestGroup>|<TestScript>|<ExitCode>|[<Host>:]<TestLog>|<ExpectedStringRegex>|<Comments>
#------------------------------------------------------------------------------
ScriptedTestGroup-1|test_script-1.sh|N|/tmp/test_script-1.log|Hello|Hello Script.