VDT Test Harness

The README File:

./runTests [-g] testFile

will run the tests listed in 'testFile' and give a summary
of success vs. failure vs. errors along with the output from
all failed tests.


Test files located in test/


To run the certification tests, do

   cd $VDT_LOCATION/vdt/tests/test_harness
   ./runTests.py ${VDT_LOCATION}/vdt/tests/certification_tests/configFile


-g is "gaudy" mode.  This will write out an HTML vesion of the output.
The HTML in this file uses CSS and may not work on all browsers.
(Isn't there a better word than 'gaudy'?  -h for HTML looks like 'help')



NOTE:   The globus tests currently don't work with this test harness
        as they use the perl test harness interface and support for
        that is currently broken.  That should be fixed soon.

NOTE:   Capturing output of tests which time out is broken due to
        a python quirk.  This also needs to be fixed.


Syntax of test configuration files is as follows.  Testers shouldn't
need this as test configuration files already exist.

   dir 

        Change to directory .   may contain
        references to environment variables.
        (e.g. ${GLOBUS_LOCATION/test/whatever)

   env  

        Set environment variable  to value  for all following
        test program environments.

   test [-p] [-n name] [-t timeout] 

        Run test program . Test program conforms to simple test
        interface. (ie. returns 0 if successfull, not-zero otherwise)
        All output to stdout/stderr is saved in failure cases.

        -p test conforms to perl test harness api.  NOTE: this is
        currently broken.

   group name

        Start a group of related tests.  Can include other groups.
        Ends with 'end' directive.

   end

        End a test group

   desc Some Descriptive String

        Annotate a test or test group with a description.
        Multiple desc directives append annotations to previous
        annotations.  Applies to most recent 'test' or 'group'
        in file.

   import filename

        Import another test file.