Copyright 2009 Sun Microsystems, Inc. All rights reserved.

Use is subject to license terms.

1. Summary

The global test target, i.e. "make test", should be executed prior to

requesting code review and prior to integration. That target invokes

run.py in this directory.

run.py drives the execution of our api and cli test suites, and

compares the results to a baseline file stored in baseline.txt.

run.py can also be run standalone with a variety of options:

Usage: run.py [-ghpv] [-b filename] [-o regexp]

-g Generate result baseline

-h This help message

-p Parseable output format

-v Verbose output

-b <filename> Baseline filename

-o <regexp> Run only tests that match regexp

-c Collect code coverage data

When adding, removing, or changing the results of test cases, make

sure to update baseline.txt and check it in. This can be done with the

-g option to run.py.

The code coverage collection is done with Ned Batchelder's "coverage.py"

tool [1].

2. Pending work.

The special dependency scenarios in "old" should be recoded as part of

the cli test suite.

3. References

[1] N. Batchelder, coverage module, 2009.

http://nedbatchelder.com/code/coverage/