This directory contains our end-to-end SCons tests.
They are all meant to be run essentially standalone, with the exception
-of the TestSCons.py module (and the TestCmd.py module it imports) that
-is imported by each test. These modules are in the etc/ subdirectory,
-and PYTHONPATH needs to be set up correctly so that the test script can
-find them, and so that the SCons script itself can find the build engine
+of the TestSCons.py module and the other modules imported by the various
+tests. These modules are in the QMTest/ subdirectory, and PYTHONPATH
+needs to be set up correctly so that the test scripts can find them,
+and so that the SCons script itself can find the build engine modules.
There is a wrapper script, runtest.py, that takes care of this for you,
so the canonical invocation of a test is:
There is also a "runtest.py -a" option that will search the tree for
all tests, and execute them.
-Many of these tests have code for features that are not yet supported,
-but which will be part of SCons IN THE CURRENT PLANNED RELEASE. These
+Some of these tests have code for features that are not yet supported.
commented out with a "#XXX" at the beginning of the line;
early call to test.pass_test(), which has a "#XXX" comment
-The upshot is that you should be able to:
- egrep -l '#XXX' test/*.py
-and see a list of the tests we still have to make work in order to get
-the next release out the door.
If you're trying to implement one of these features, DO NOT BLINDLY
ASSUME THAT THE NEW CODE IN THE TEST IS CORRECT. It may have problems
that have gone undiscovered due to the fact that the code testing the
keep this description reasonably
- Feature-01.py additional tests of specified
Feature-x.py test of specified feature using
- Feature-x-01.py additional tests of specified
- Feature-x-02.py feature using option x
-- Command line option tests take the form:
option-x.py lower-case single-letter option