Pysys

--------------
- This release introduces optional fail fast semantics at a macro and micro
level. At a macro level this is either through the "defaultAbortOnError"
project property, or through the "-b|--abort" option to the pysys launcher
run task. See the sample pysysproject.xml, and the run task
help usage respectively for more details. At a micro level, all assert and
process related methods now take an optional "abortOnError" parameter to
override any macro setting. When enabled any error will cause the test to
immediately fail, reporting the failure reason.
- Outcomes which are considered a fail now log information as to the cause
of the failure. Additionally a call record is reported, giving a comma
separated list of "module:lineno" entries detailing the call stack up to
the test class instance. This is to aid diagnosing test failure causes.
- The test title is now output to console when running the test.
- The BaseRunner class now contains an isPurgableFile() method. This method
can be overridden by any extensions to denote if a zero length file should
be purged from the output subdirectory after running of the test.
- It is now possible to register cleanup functions in the BaseTest to negate
the need to override the cleanup() action where a call to
BaseTest.cleanup(self) must specifically be made. See the epydoc for the
addCleanupFunction() in the ProcessUser module.

--------------
- Added Darwin as a supported platform.
- Added the maker tag to the pysysproject file to allow specifying a
custom test maker class, e.g. to create specific run templates etc.
See the pysysproject.xml file in pysys-examples for more information.
- The make option to pysys.py now accepts the testcase directory to be
specified to a value other than the current working directory.

--------------
- The method getNextAvailableTCPPort has been added to the
pysys.basetest.BaseTest class to allow users to allocate server TCP ports
in a robust manner.
- The unix and windows process helpers have been updated to fix handle leaks
(defect 11 "ProcessMonitor leaks file handles"), and to delete the stdin
queue when processes go away.

--------------
- Fixed issue with the determination of the overall test outcome due to the
incorrect use of the inbuilt sorted() function. The issue meant the test
outcome list was not correctly sorted based on precedent, leading to the
incorrect determination of the overall test outcome.
- Fixed issue in the pysys.basetest on handling FileNotFoundExceptions in
the assert* methods. The exception was not being caught, leading to
subsequent asserts in the test class not being performed.

--------------
- The PySys framework has been updated to be compliant with conversion to
Python 3.x with the 2to3.py conversion script. Installation on Python 3.x
is now supported via the source distribution bundle, where the 2to3.py
script is run automatically at install time. See details below for
installing the source distribution. A binary distribution installer for
windows will be included in a later release.
- There are now separate 32 and 64 bit binary distribution installers for
windows.
- On failure of the assertLineCount method, the log output now contains the
returned number and requested condition (tracker 3045931)
- Each assert method now takes an "assertMessage" parameter to be written
to the log output on execution (tracker 3045924). See test
PySys_internal_053 in the example testcases for example usage.
- Added the JUnitXMLResultsWriter to log test results in Apache Ant JUnit
XML format (one output file per test per cycle). This is useful for
integration into Continuous Integration build systems, e.g. TeamCity. The
TextResultsWriter and XMLResultsWriter now support the outputDir property
to specify the location to write the output files. See the pysys-examples
pysysproject.xml file for more details.
- Added the ability to run suites of pyunit tests wrapped up as a single
PySys test. This capability is exposed through the PyUnitTest class
contained in the pysys.unit.pyunit module. See the pysys-examples pyunit
tests for example usage.
- Fix to the unix process helper to correctly set the working directory of
child processes in the fork and exec.
- When running tests in parallel, a value of zero given for the
-n|--threads option to the run task of the pysys.py launcher, will set
the number of threads to the number of available CPUs.

--------------
- Updated the pysys.process.plat-win32.helper.ProcessWrapper module to
eliminate the use of threads to collect the stdout and stderr from the
process via pipes. The module now directly uses win32file.CreateFile to
create file objects to pass to the call to win32process.CreateProcess.
- Added the <formatters/> element to the pysysproject file. This allows
setting the format of the test output to stdout and the runlog in
accordance to the format specifiers in the python logging and time
modules. For examples of the use of this element, see the pysysproject
file included in the PySys examples.
- Logging of exceptions and failed asserts has been changed from info to
warn level (tracker 2784251).
- Added extra debug logging in pysys.utils.filegrep, and pysys.basetest
for when performing asserts against a line count in an input file
(tracker 2824758).
- The testcase output summary is now printed on termination of the test
run via a keyboard interrupt (tracker 2816212).
- The PySys project file now allows assignment of the project root
location to a variable which can then be used for later expansion within
the file. This allows the definition of project variables to include the
full path where this is required, e.g. XSL stylesheets which must use
the full path to the file rather than a relative path etc. Note that
modules within PySys can reference the project root location directly
using PROJECT.root (tracker 2795316).
- The pysys.baserunner class now passes the -X arguments into the test
summary writer setup action to allow logging of the user supplied extra
arguments(tracker 2814499). The pysys-log.xsl stylesheet used by the
XMLResultsWriter
has been updated to display this information in the test summary display.
- Fixed an issue where when the pysysproject file was missing, defaults
for the runner module and the test output summary writer were not being
set.