FindCxxTest

Find CxxTest unit testing framework.

Find the CxxTest suite and declare a helper macro for creating unit tests and integrating them with CTest.

Input Variables

CXXTEST_USE_PYTHON

Deprecated since version 1.3.

Only used in the case both Python & Perl are detected on the system to control which CxxTest code generator is used. Valid only for CxxTest version 3.

In older versions of this Find Module, this variable controlled if the Python test generator was used instead of the Perl one, regardless of which scripting language the user had installed.

CXXTEST_TESTGEN_ARGS

New in version 2.8.3.

Specify a list of options to pass to the CxxTest code generator. If not defined, --error-printer is passed.

Result Variables

CXXTEST_FOUND

True if the CxxTest framework was found

CXXTEST_INCLUDE_DIRS

Where to find the CxxTest include directory

CXXTEST_PERL_TESTGEN_EXECUTABLE

The perl-based test generator

CXXTEST_PYTHON_TESTGEN_EXECUTABLE

The python-based test generator

CXXTEST_TESTGEN_EXECUTABLE

New in version 2.8.3.

The test generator that is actually used (chosen using user preferences and interpreters found in the system)

CXXTEST_TESTGEN_INTERPRETER

New in version 2.8.3.

The full path to the Perl or Python executable on the system, on platforms where the script cannot be executed using its shebang line.

Module Commands

cxxtest_add_test

Create a CxxTest runner and adds it to the CTest testing suite:

CXXTEST_ADD_TEST(<test_name> <gen_source_file>
                 <input_files_to_testgen>...)

Parameters:

test_name

The name of the test

gen_source_file

The generated source filename to be generated by CxxTest

input_files_to_testgen

The list of header files containing the CxxTest::TestSuite's to be included in this runner

Example Usage

The following example, if CxxTest is found, will:

  • Invoke the testgen executable to autogenerate foo_test.cc in the binary tree from "foo_test.h" in the current source directory.

  • Create an executable and test called unittest_foo.

find_package(CxxTest)
if(CXXTEST_FOUND)
  include_directories(${CXXTEST_INCLUDE_DIR})
  enable_testing()
  CXXTEST_ADD_TEST(unittest_foo foo_test.cc
                   ${CMAKE_CURRENT_SOURCE_DIR}/foo_test.h)
  target_link_libraries(unittest_foo foo) # as needed
endif()

foo_test.h contains:

#include <cxxtest/TestSuite.h>
class MyTestSuite : public CxxTest::TestSuite
{
public:
   void testAddition( void )
   {
      TS_ASSERT( 1 + 1 > 1 );
      TS_ASSERT_EQUALS( 1 + 1, 2 );
   }
};