VDrift includes a very simple unit testing framework for C++ code. It is derived from QuickTest.
To run unit tests, the test executable must first be built.
In the VDrift source root, run:
scons test
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
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 -------------]
Consult the QuickTest How to Use It and the QuickTest API Reference for details on how to write unit tests using QuickTest.
To look at some example test code already in VDrift, look at src/*.cpp files which contain the macro QT_TEST.
Category:Development