id	summary	reporter	owner	description	type	status	priority	milestone	component	resolution	keywords	cc	phab_field
117	add CxxTest	Jan Wassenberg	Jan Wassenberg	"Background: using an existing Unit/self-test framework is deemed helpful (see 2006-05-27 meeting)
Chiefly based on [http://www.gamesfromwithin.com/articles/0412/000061.html evaluation], we choose [http://cxxtest.sourceforge.net/ CxxTest] as unit testing framework. 

Basic usage:
* self-tests are separate Cpp files that contain only the test code. (splitting is necessary so that cxxtestgen doesn't have to parse the entire codebase)
* they are stored in a tests subdir of the source directory (simplifies finding the relevant test file for purposes of editing it)
* a workspace generated by premake enumerates all test files, uses custom build step to generate the actual test code, and then links it all into a separate program that runs all tests.
Note: separating test code from the main PS executable has several advantages as [http://www.wildfiregames.com/forum/index.php?showtopic=10018&pid=171251&st=0&#entry171251 documented]
* only running certain tests will be possible (shortens iteration time when only editing one module).

TODO:
- add CxxTest to SVN
- generate workspace for the test program (via premake)
- move all existing tests over to that
- filtering: modify(/replace/subclass) TestRunner and change its runWorld() so that it filters by the SuiteDescription.testName()."	task	new	Should Have	ASAP	Core engine		test