Next Previous Contents

5. Utility Script Reference

5.1 tessrun

The tessrun script is intended to simplify the invocation of a suite of regression tests, and has a command line usage synopsis of: 

        tessrun [-v] [application_name]
Specifying the -v (verbose) flag inhibits the redirection of stderr to /dev/null, while specifying an application_name overrides the default use of slsh as the test application.

The chief benefits of tessrun are that it yields simpler Makefiles which require fewer modifications. For example, rather than having the make test rule within your regression test Makefile explicitly loop over all .t files within its directory, the rule can simply invoke tessrun, perhaps as: 

        test:
                tessrun $(TESS_APP) > test.out 2>&1
                diff test.ref test.out
Since zero tests are explicitly referenced by name the Makefile need not change as new tests are added to the regression suite. Nor need need it be modified simply to execute the test suite within other applications (again, the default test application is slsh), since that can be achieved here simply by overriding the definition of $(TEST_APP) during the invocation of make: 
        unix%  make -e TEST_APP=isis
The only constraint upon the test application is that it offers the S-Lang provide and require package management functions.

Next Previous Contents