How to install svUnitTest

Basic compilation using cmake

To compile the project :

$ mkdir build
$ cd build
$ cmake ..
$ make
$ make test
$ make install

Basic compilation using cmake wrapper

If you are more familiar with autotools configure script, svUnitTest provide a wrapper on top of cmake to get equivalent installation process. In place of cmake you can use :

$ ../configure

Custom prefix

You can change the prefix path for installation with the command :

$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr/local/myprefix

$ ../configure --prefix=/usr/local/myprefix

Avoid compilation of unit tests

By default the test suite will be build if cppunit is present on your system, to disable it, you can use :

$ cmake .. -DDISABLE_UNIT_TESTS=yes

$ ../configure --disable-unit-tests

Disable usage of cppunit

If you encouter some issues with the test suite and cppunit, you can replace cppunit by a light implementation with :

$ cmake .. -DDISABLE_CPPUNIT=yes

$ ../configure --disable-cppunit

This is more to pass the test suite on non unix platform like Windows as cppunit installation is not friendly.

Run the internal test suite

You can run the internal unit test before installing :

$ make test

Generate code coverage of internal test suite :

To geneate test coverage, we need to setup CFLAGS for gcc+gcov :

-DCMAKE_CXX_FLAGS="-O0 -fprofile-arcs -ftest-coverage"
-DCMAKE_C_FLAGS="-O0 -fprofile-arcs -ftest-coverage"
-DCMAKE_EXE_LINKER_FLAGS="-O0 -fprofile-arcs -ftest-coverage

You can do it simply by using :

$ cmake .. -DTEST_COVERAGE=yes

$ ../configure --enable-gcc-coverage

Now build, run the tests and call lcov and genhtml :

$ make
$ ./src/test/all_tests
$ lcov -o out.info -c -d .
$ genhtml -o html out.info

Using self-test mode

If you want to develop in the library with KDevelop, you may want to use the kdev-xtest plugin to get the svUnitTest suite results directly in kdevelop interface. This can be done by enable the self testing mode. So the svUnitTest test suite will be build with svUnitTest itself with kdevelop integration support :

$ cmake .. -DENABLE_SELF_TEST=yes

$ ../configure --enable-self-test

Integration into jenkins

To validate svUnitTest project in Jenkins, you may be interested by using :

$ cmake .. -DENABLE_DEBUG -DENABLE_SELF_TEST=yes -DENABLE_VALGRIND=yes \
           -DENABLE_JUNIT_OUTPUT=yes

$ ../configure --enable-debug --enable-self-test --enable-valgrind  \
           --enable-junit-output

It will generates report files while doing "make test" or using ctest :

**/*.junit.xml for detailed unit test reports.
**/*.memcheck.xml for valgrind reports.

svalat/svUnitTest