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