package - Package of tests.

izh_test
Kinds of tests
Aggregate tests

package - Package of tests.

Number of test executing at once as one thing.

Test package is executed successfully if all its component tests are executed successfully.

Also test component from the package can be executed separately using console runner , or using GUI-runner .

Package can be part of other package too.

Full specification of package looks like:
<package> <spec> <sname>short_name_of_test</sname> <fname>full name of test</fname> <descr>description of test</descr> </spec> <test_templates> .. named test templates .. </test_templates> <params> .. named params .. </params> <safe_params> .. named params if undefined .. </safe_params> <include> .. files with declarations .. </include> <on_start_terminal> .. actions to do before terminal .. </on_start_terminal> <on_stop_terminal> .. actions to do after terminal .. </on_stop_terminal> <tests> .. tests of package .. </tests> </package>

Where:

test_templates	Definitions of named test templates for using in test component.
params, safe_params	Definitions of substitution variables for using in test component.
include	List of included files files with declarations .
on_start_terminal	Actions that should be executed before each terminal test in this aggregate test.
on_stop_terminal	Actions that should be executed after each terminal test in this aggregate test.
tests	Specifications for test components.

Identification specification spec is standard for all the tests:

spec	Identification information for the test (names, descriptions)
sname	Short name for test, that is used as test name in GUI-runner and as component of path to the test in console runner . The sname should not contain line breaks. It is better if the sname is short and without white spaces.
fname	Full name of test is used as test name in console runner . The fname should not contain line breaks. The fname is placed in one line/screen. So it would be better if the fname is less than 60 symbols.
descr	Full description of test. It can be as long as you need and contain any number of line breaks. The description can be shown in the console and GUI runner by special command only.

Example:

<package>
  <spec>
    <sname>test short name for package</sname>
    <fname>test full name for package</fname>
    <descr>test descr for package</descr>
  </spec>
  <test_templates>
    <template>
      <name>b</name>
      <test>
        <empty_test>
          <spec>
            <sname>test short name for empty</sname>
            <fname>test full name for empty</fname>
            <descr>test descr for empty</descr>
          </spec>
        </empty_test>
      </test>
    </template>
  </test_templates>
  <params>
    <par>
      <name>test_name1</name>
      <value>test_value1</value>
    </par>
    <par>
      <name>test_name2</name>
      <value>test_value2</value>
    </par>
  </params>
  <safe_params>
    <par>
      <name>test_name3</name>
      <value>test_value3</value>
    </par>
    <par>
      <name>test_name4</name>
      <value>test_value4</value>
    </par>
  </safe_params>
  <tests>

    <empty_test>
      <spec>
        <sname>test short name 1</sname>
        <fname>test full name 1</fname>
        <descr>test descr 1</descr>
      </spec>
    </empty_test>

    <fail>
      <spec>
        <sname>fail short name 1</sname>
        <fname>fail full name 1</fname>
        <descr>fail descr 1</descr>
      </spec>
    </fail>

  </tests>
</package>

top