Testing - Revision history

Timo 6: Update categories

2012-09-01T10:56:48Z

Update categories

Timo 6: Formatting style updates

2012-08-27T16:37:21Z

Formatting style updates

Timo 6: 2 revisions: Import from old wiki (on 15 May 2012)

2012-08-26T17:28:36Z

2 revisions: Import from old wiki (on 15 May 2012)

New page

VDrift includes a very simple unit testing framework for C++ code. It is derived from [http://quicktest.sourceforge.net/ QuickTest].

==Running the Tests==
To run unit tests, the test executable must first be built.
===Building===
In the VDrift source root, run:
scons test
===Executing===
The executable is called '''vdrift-test''' and is compiled to the '''build/''' directory in the root of the VDrift source tree. To run it, simply do:
build/vdrift-test
===Results===
The results are written to STDOUT. An example:

[-------------- RUNNING UNIT TESTS --------------]
src/matrix4.cpp(26): 'matrix4_test' FAILED: value1 (1) should be close to value2 (0)
src/matrix4.cpp(27): 'matrix4_test' FAILED: value1 (10) should be close to value2 (20)
src/matrix4.cpp(28): 'matrix4_test' FAILED: value1 (-1.19209e-07) should be close to value2 (-1)
src/matrix4.cpp(33): 'matrix4_test' FAILED: value1 (1) should be close to value2 (0)
src/matrix4.cpp(34): 'matrix4_test' FAILED: value1 (10) should be close to value2 (0)
src/matrix4.cpp(35): 'matrix4_test' FAILED: value1 (-1.19209e-07) should be close to value2 (1)
Results: 29 succeeded, 1 failed
[-------------- UNIT TESTS FINISHED -------------]

==Writing New Tests==
Consult the [http://quicktest.sourceforge.net/usage.html QuickTest How to Use It] and the [http://quicktest.sourceforge.net/api.html QuickTest API Reference] for details on how to write unit tests using QuickTest.

===Example Tests===
To look at some example test code already in VDrift, look at '''src/*.cpp''' files which contain the macro <code>QT_TEST</code>.

[[Category:Development]]
[[Category:Expand]]

← Older revision		Revision as of 10:56, 1 September 2012
Line 31:		Line 31:

	[[Category:Development]]		[[Category:Development]]
−	~~[[Category:Expand]]~~

@@ Line 3: / Line 3: @@
 ==Running the Tests==
 To run unit tests, the test executable must first be built.
 ===Building===
 In the VDrift source root, run:
   scons test
 ===Executing===
 The executable is called '''vdrift-test''' and is compiled to the '''build/''' directory in the root of the VDrift source tree. To run it, simply do:
   build/vdrift-test
 ===Results===
 The results are written to STDOUT. An example:
   [-------------- RUNNING UNIT TESTS --------------]
   src/matrix4.cpp(26): 'matrix4_test' FAILED: value1 (1) should be close to value2 (0)