[[TableOfContents]] 

= Goal =

Implements the vision described in the following document:

http://cppunit.sourceforge.net/cppunit2/features.html

= Getting the sources =

CppUnit2 sources are finally available on CVS. You can obtain them as follows:
{{{
cvs -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/cppunit login
cvs -z3 -d:pserver:anonymous@cvs.sourceforge.net:/cvsroot/cppunit co cppunit2
}}}

= Building =

CppUnit2 uses ["Scons"] as /BuildSystem. Python 1.5.2 or above is required to run ["Scons"]. Python is available at http://www.python.org. 

Download and unpack the scons-local package (http://sourceforge.net/project/showfiles.php?group_id=30337&package_id=67375) into the CppUnit2 top directory. {{{scons.py}}} should be at the same level as {{{sconstruct}}}.

Run the build from the CppUnit2 top directory with
{{{
python scons.py platform=XYZ
}}}

where XYZ is one of the following:

 * mingw : Win32 MinGW
 * suncc : Sun CC for Solaris 
 * vacpp : Visual Age C++
 * msvc6 : Microsoft Visual C++ 6 service pack 5
 * msvc70: Microsoft Visual Studio .NET 2002 (VC++ 7.0)
 * msvc71: Microsoft Visual Studio .NET 2003 (VC++ 7.1)
 * linux-gcc: GCC

The examples and unit test executables can be found in the {{{bin/}}} directory.

It is possible to build and run all the unit tests using the 'check' target. For example:
{{{
python scons.py platform=msvc71 check
}}}

= Features =

 * ["/Assertions"]
 * /NonAbortingAssertions a.k.a. checking assertions
 * ["/Log"]
 * /DescriptiveData
 * /ConvertToString
 * /EqualityTesting
 * /ParametrizedTestCase
 * /TestPlugIn
 * /SharedFixtureTestCase
 * /ThreadedTestCase
 * /InputBasedTestCase

= Other documentations =

 * /RoadMap
 * /CompilerRequirements
 * /BuildSystem
 * /MemoryManagement
 * /ThreadSafety
 * /UsingWithCppUnit1
 * /ImplementationOverview
 * IntegrationWithTestDrivingEnvironments

= Libraries provided with CppUnit2 =

CppUnit2 depends on the following libraries which are developed for this project:

 * OpenTest: test driver and ouput generator
 * CppToolLibrary: tool library
