2023-11-01 06:11:15 +08:00
|
|
|
# Distributed under the OSI-approved BSD 3-Clause License. See accompanying
|
|
|
|
# file Copyright.txt or https://cmake.org/licensing for details.
|
|
|
|
|
|
|
|
#[=======================================================================[.rst:
|
|
|
|
FindCxxTest
|
|
|
|
-----------
|
|
|
|
|
2023-11-01 06:20:22 +08:00
|
|
|
Find CxxTest unit testing framework.
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
Find the `CxxTest`_ suite and declare a helper macro for creating
|
|
|
|
unit tests and integrating them with CTest.
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
.. _`CxxTest`: https://github.com/CxxTest/cxxtest#readme
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
Input Variables
|
|
|
|
^^^^^^^^^^^^^^^
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``CXXTEST_USE_PYTHON``
|
|
|
|
.. deprecated:: 1.3
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
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.
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
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.
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``CXXTEST_TESTGEN_ARGS``
|
|
|
|
.. versionadded:: 2.8.3
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
Specify a list of options to pass to the CxxTest code
|
|
|
|
generator. If not defined, ``--error-printer`` is passed.
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
Result Variables
|
|
|
|
^^^^^^^^^^^^^^^^
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``CXXTEST_FOUND``
|
|
|
|
True if the CxxTest framework was found
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``CXXTEST_INCLUDE_DIRS``
|
|
|
|
Where to find the CxxTest include directory
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``CXXTEST_PERL_TESTGEN_EXECUTABLE``
|
|
|
|
The perl-based test generator
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``CXXTEST_PYTHON_TESTGEN_EXECUTABLE``
|
|
|
|
The python-based test generator
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``CXXTEST_TESTGEN_EXECUTABLE``
|
|
|
|
.. versionadded:: 2.8.3
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
The test generator that is actually used (chosen using user preferences
|
|
|
|
and interpreters found in the system)
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``CXXTEST_TESTGEN_INTERPRETER``
|
|
|
|
.. versionadded:: 2.8.3
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
The full path to the Perl or Python executable on the system, on
|
|
|
|
platforms where the script cannot be executed using its shebang line.
|
2023-11-01 06:11:15 +08:00
|
|
|
|
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
Module Commands
|
|
|
|
^^^^^^^^^^^^^^^
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
.. command:: cxxtest_add_test
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
Create a CxxTest runner and adds it to the CTest testing suite::
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
CXXTEST_ADD_TEST(<test_name> <gen_source_file>
|
|
|
|
<input_files_to_testgen>...)
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
Parameters:
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``test_name``
|
|
|
|
The name of the test
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``gen_source_file``
|
|
|
|
The generated source filename to be generated by CxxTest
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``input_files_to_testgen``
|
|
|
|
The list of header files containing the CxxTest::TestSuite's
|
|
|
|
to be included in this runner
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
Example Usage
|
|
|
|
^^^^^^^^^^^^^
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
The following example, if CxxTest is found, will:
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
* 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.
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
.. code-block:: cmake
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
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()
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
``foo_test.h`` contains:
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
.. code-block:: c++
|
2023-11-01 06:11:15 +08:00
|
|
|
|
2023-11-01 08:44:24 +08:00
|
|
|
#include <cxxtest/TestSuite.h>
|
|
|
|
class MyTestSuite : public CxxTest::TestSuite
|
|
|
|
{
|
|
|
|
public:
|
|
|
|
void testAddition( void )
|
|
|
|
{
|
|
|
|
TS_ASSERT( 1 + 1 > 1 );
|
|
|
|
TS_ASSERT_EQUALS( 1 + 1, 2 );
|
|
|
|
}
|
|
|
|
};
|
2023-11-01 06:11:15 +08:00
|
|
|
|
|
|
|
#]=======================================================================]
|
|
|
|
|
|
|
|
# Version 1.4 (11/18/10) (CMake 2.8.4)
|
|
|
|
# Issue 11384: Added support to the CXX_ADD_TEST macro so header
|
|
|
|
# files (containing the tests themselves) show up in
|
|
|
|
# Visual Studio and other IDEs.
|
|
|
|
#
|
|
|
|
# Version 1.3 (8/19/10) (CMake 2.8.3)
|
|
|
|
# Included patch by Simone Rossetto to check if either Python or Perl
|
|
|
|
# are present in the system. Whichever interpreter that is detected
|
|
|
|
# is now used to run the test generator program. If both interpreters
|
|
|
|
# are detected, the CXXTEST_USE_PYTHON variable is obeyed.
|
|
|
|
#
|
|
|
|
# Also added support for CXXTEST_TESTGEN_ARGS, for manually specifying
|
|
|
|
# options to the CxxTest code generator.
|
|
|
|
# Version 1.2 (3/2/08)
|
|
|
|
# Included patch from Tyler Roscoe to have the perl & python binaries
|
|
|
|
# detected based on CXXTEST_INCLUDE_DIR
|
|
|
|
# Version 1.1 (2/9/08)
|
|
|
|
# Clarified example to illustrate need to call target_link_libraries()
|
|
|
|
# Changed commands to lowercase
|
|
|
|
# Added licensing info
|
|
|
|
# Version 1.0 (1/8/08)
|
|
|
|
# Fixed CXXTEST_INCLUDE_DIRS so it will work properly
|
|
|
|
# Eliminated superfluous CXXTEST_FOUND assignment
|
|
|
|
# Cleaned up and added more documentation
|
|
|
|
|
|
|
|
#=============================================================
|
|
|
|
# CXXTEST_ADD_TEST (public macro)
|
|
|
|
#=============================================================
|
|
|
|
macro(CXXTEST_ADD_TEST _cxxtest_testname _cxxtest_outfname)
|
|
|
|
set(_cxxtest_real_outfname ${CMAKE_CURRENT_BINARY_DIR}/${_cxxtest_outfname})
|
|
|
|
|
|
|
|
add_custom_command(
|
|
|
|
OUTPUT ${_cxxtest_real_outfname}
|
|
|
|
DEPENDS ${ARGN}
|
|
|
|
COMMAND ${CXXTEST_TESTGEN_INTERPRETER}
|
|
|
|
${CXXTEST_TESTGEN_EXECUTABLE} ${CXXTEST_TESTGEN_ARGS} -o ${_cxxtest_real_outfname} ${ARGN}
|
|
|
|
)
|
|
|
|
|
|
|
|
set_source_files_properties(${_cxxtest_real_outfname} PROPERTIES GENERATED true)
|
|
|
|
add_executable(${_cxxtest_testname} ${_cxxtest_real_outfname} ${ARGN})
|
|
|
|
|
|
|
|
if(CMAKE_RUNTIME_OUTPUT_DIRECTORY)
|
|
|
|
add_test(${_cxxtest_testname} ${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/${_cxxtest_testname})
|
|
|
|
elseif(EXECUTABLE_OUTPUT_PATH)
|
|
|
|
add_test(${_cxxtest_testname} ${EXECUTABLE_OUTPUT_PATH}/${_cxxtest_testname})
|
|
|
|
else()
|
|
|
|
add_test(${_cxxtest_testname} ${CMAKE_CURRENT_BINARY_DIR}/${_cxxtest_testname})
|
|
|
|
endif()
|
|
|
|
|
|
|
|
endmacro()
|
|
|
|
|
|
|
|
#=============================================================
|
|
|
|
# main()
|
|
|
|
#=============================================================
|
|
|
|
if(NOT DEFINED CXXTEST_TESTGEN_ARGS)
|
2023-11-01 06:20:22 +08:00
|
|
|
set(CXXTEST_TESTGEN_ARGS --error-printer)
|
2023-11-01 06:11:15 +08:00
|
|
|
endif()
|
|
|
|
|
|
|
|
find_package(Python QUIET)
|
|
|
|
find_package(Perl QUIET)
|
|
|
|
|
|
|
|
find_path(CXXTEST_INCLUDE_DIR cxxtest/TestSuite.h)
|
|
|
|
find_program(CXXTEST_PYTHON_TESTGEN_EXECUTABLE
|
|
|
|
NAMES cxxtestgen cxxtestgen.py
|
|
|
|
PATHS ${CXXTEST_INCLUDE_DIR})
|
|
|
|
find_program(CXXTEST_PERL_TESTGEN_EXECUTABLE cxxtestgen.pl
|
|
|
|
PATHS ${CXXTEST_INCLUDE_DIR})
|
|
|
|
|
|
|
|
if(PYTHON_FOUND OR PERL_FOUND)
|
2023-11-01 06:20:22 +08:00
|
|
|
include(${CMAKE_CURRENT_LIST_DIR}/FindPackageHandleStandardArgs.cmake)
|
|
|
|
|
|
|
|
if(PYTHON_FOUND AND (CXXTEST_USE_PYTHON OR NOT PERL_FOUND OR NOT DEFINED CXXTEST_USE_PYTHON))
|
|
|
|
set(CXXTEST_TESTGEN_EXECUTABLE ${CXXTEST_PYTHON_TESTGEN_EXECUTABLE})
|
|
|
|
execute_process(COMMAND ${CXXTEST_PYTHON_TESTGEN_EXECUTABLE} --version
|
|
|
|
OUTPUT_VARIABLE _CXXTEST_OUT ERROR_VARIABLE _CXXTEST_OUT RESULT_VARIABLE _CXXTEST_RESULT)
|
|
|
|
if(_CXXTEST_RESULT EQUAL 0)
|
|
|
|
set(CXXTEST_TESTGEN_INTERPRETER "")
|
|
|
|
else()
|
|
|
|
set(CXXTEST_TESTGEN_INTERPRETER ${Python_EXECUTABLE})
|
|
|
|
endif()
|
|
|
|
FIND_PACKAGE_HANDLE_STANDARD_ARGS(CxxTest DEFAULT_MSG
|
|
|
|
CXXTEST_INCLUDE_DIR CXXTEST_PYTHON_TESTGEN_EXECUTABLE)
|
|
|
|
|
|
|
|
elseif(PERL_FOUND)
|
|
|
|
set(CXXTEST_TESTGEN_EXECUTABLE ${CXXTEST_PERL_TESTGEN_EXECUTABLE})
|
|
|
|
set(CXXTEST_TESTGEN_INTERPRETER ${PERL_EXECUTABLE})
|
|
|
|
FIND_PACKAGE_HANDLE_STANDARD_ARGS(CxxTest DEFAULT_MSG
|
|
|
|
CXXTEST_INCLUDE_DIR CXXTEST_PERL_TESTGEN_EXECUTABLE)
|
|
|
|
endif()
|
|
|
|
|
|
|
|
if(CXXTEST_FOUND)
|
|
|
|
set(CXXTEST_INCLUDE_DIRS ${CXXTEST_INCLUDE_DIR})
|
|
|
|
endif()
|
2023-11-01 06:11:15 +08:00
|
|
|
|
|
|
|
else()
|
|
|
|
|
2023-11-01 06:20:22 +08:00
|
|
|
set(CXXTEST_FOUND false)
|
|
|
|
if(NOT CxxTest_FIND_QUIETLY)
|
|
|
|
if(CxxTest_FIND_REQUIRED)
|
|
|
|
message(FATAL_ERROR "Neither Python nor Perl found, cannot use CxxTest, aborting!")
|
|
|
|
else()
|
|
|
|
message(STATUS "Neither Python nor Perl found, CxxTest will not be used.")
|
|
|
|
endif()
|
|
|
|
endif()
|
2023-11-01 06:11:15 +08:00
|
|
|
|
|
|
|
endif()
|