# 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`

  Added 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`

  Added 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`

  Added 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 );
       }
    };