# This adds ctest support to the project enable_testing() # By default, ctest runs tests serially if(NOT CTEST_PARALLEL_LEVEL) include(ProcessorCount) ProcessorCount(CORES) set(CTEST_PARALLEL_LEVEL ${CORES}) endif() # Put in a tests folder to reduce the top level targets in IDEs. set(CMAKE_FOLDER tests) # We will use 125 as a reserved exit code to indicate that a test has been skipped, i.e. it did not # pass but it should not be considered a failed test run, either. set(SKIP_RETURN_CODE 125) # Even though we are using CMake's ctest for testing, we still define our own `make test` target # rather than use its default for many reasons: # * CMake doesn't run tests in-proc or even add each tests as an individual node in the ninja # dependency tree, instead it just bundles all tests into a target called `test` that always just # shells out to `ctest`, so there are no build-related benefits to not doing that ourselves. # * CMake devs insist that it is appropriate for `make test` to never depend on `make all`, i.e. # running `make test` does not require any of the binaries to be built before testing. # * The only way to have a test depend on a binary is to add a fake test with a name like # "build_fish" that executes CMake recursively to build the `fish` target. # * It is not possible to set top-level CTest options/settings such as CTEST_PARALLEL_LEVEL from # within the CMake configuration file. # * Circling back to the point about individual tests not being actual Makefile targets, CMake does # not offer any way to execute a named test via the `make`/`ninja`/whatever interface; the only # way to manually invoke test `foo` is to to manually run `ctest` and specify a regex matching # `foo` as an argument, e.g. `ctest -R ^foo$`... which is really crazy. # Set a policy so CMake stops complaining when we use the target name "test" cmake_policy(PUSH) if(POLICY CMP0037) cmake_policy(SET CMP0037 OLD) endif() add_custom_target(test COMMAND env CTEST_PARALLEL_LEVEL=${CTEST_PARALLEL_LEVEL} FISH_FORCE_COLOR=1 FISH_SOURCE_DIR=${CMAKE_SOURCE_DIR} ${CMAKE_CTEST_COMMAND} --force-new-ctest-process # --verbose --output-on-failure --progress DEPENDS fish_tests tests_buildroot_target USES_TERMINAL ) cmake_policy(POP) # Build the low-level tests code add_executable(fish_tests EXCLUDE_FROM_ALL src/fish_tests.cpp) fish_link_deps_and_sign(fish_tests) # The "test" directory. set(TEST_DIR ${CMAKE_CURRENT_BINARY_DIR}/test) # CMake doesn't really support dynamic test discovery where a test harness is executed to list the # tests it contains, making fish_tests.cpp's tests opaque to CMake (whereas littlecheck tests can be # enumerated from the filesystem). We used to compile fish_tests.cpp without linking against # anything (-Wl,-undefined,dynamic_lookup,--unresolved-symbols=ignore-all) to get it to print its # tests at configuration time, but that's a little too much dark CMake magic. # # We now identify tests by checking against a magic regex that's #define'd as a no-op C-side. file(READ "${CMAKE_SOURCE_DIR}/src/fish_tests.cpp" FISH_TESTS_CPP) string(REGEX MATCHALL "TEST_GROUP\\( *\"([^\"]+)\"" "LOW_LEVEL_TESTS" "${FISH_TESTS_CPP}") string(REGEX REPLACE "TEST_GROUP\\( *\"([^\"]+)\"" "\\1" "LOW_LEVEL_TESTS" "${LOW_LEVEL_TESTS}") list(REMOVE_DUPLICATES LOW_LEVEL_TESTS) # The directory into which fish is installed. set(TEST_INSTALL_DIR ${TEST_DIR}/buildroot) # The directory where the tests expect to find the fish root (./bin, etc) set(TEST_ROOT_DIR ${TEST_DIR}/root) # Copy needed directories for out-of-tree builds if(NOT FISH_IN_TREE_BUILD) add_custom_target(funcs_dir) add_custom_command(TARGET funcs_dir COMMAND mkdir -p ${CMAKE_BINARY_DIR}/share # Don't run ln twice or it will create a new link in the link. COMMAND test -e ${CMAKE_BINARY_DIR}/share/functions || ln -sf ${CMAKE_SOURCE_DIR}/share/functions/ ${CMAKE_BINARY_DIR}/share/functions COMMENT "Symlinking fish functions to binary dir" VERBATIM) add_custom_target(tests_dir DEPENDS tests) add_custom_command(TARGET tests_dir COMMAND ${CMAKE_COMMAND} -E copy_directory ${CMAKE_SOURCE_DIR}/tests/ ${CMAKE_BINARY_DIR}/tests/ COMMENT "Copying test files to binary dir" VERBATIM) add_dependencies(fish_tests tests_dir funcs_dir) endif() # Copy littlecheck.py configure_file(build_tools/littlecheck.py littlecheck.py COPYONLY) # Copy pexpect_helper.py configure_file(build_tools/pexpect_helper.py pexpect_helper.py COPYONLY) # Suppress generating Xcode schemes for all tests, there's too many. set(CMAKE_XCODE_GENERATE_SCHEME 0) # CMake being CMake, you can't just add a DEPENDS argument to add_test to make it depend on any of # your binaries actually being built before `make test` is executed (requiring `make all` first), # and the only dependency a test can have is on another test. So we make building fish and # `fish_tests` prerequisites to our entire top-level `test` target. function(add_test_target NAME) add_custom_target("test_${NAME}" COMMAND ${CMAKE_CTEST_COMMAND} --output-on-failure -R "^${NAME}$$" DEPENDS fish_tests tests_buildroot_target USES_TERMINAL ) endfunction() add_custom_target(tests_buildroot_target # Make the directory in which to run tests: COMMAND ${CMAKE_COMMAND} -E make_directory ${TEST_INSTALL_DIR} COMMAND env DESTDIR=${TEST_INSTALL_DIR} ${CMAKE_COMMAND} --build ${CMAKE_CURRENT_BINARY_DIR} --target install # Put fish_test_helper there too: COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_BINARY_DIR}/fish_test_helper ${TEST_INSTALL_DIR}/${CMAKE_INSTALL_PREFIX}/bin # Also symlink fish to where the tests expect it to be: COMMAND ${CMAKE_COMMAND} -E create_symlink ${TEST_INSTALL_DIR}/${CMAKE_INSTALL_PREFIX} ${TEST_ROOT_DIR} DEPENDS fish fish_test_helper) # CMake less than 3.9.0 "fully supports" setting an exit code to denote a skipped test, but then # it just goes ahead and reports it as failed. Really? if(${CMAKE_VERSION} VERSION_LESS "3.9.0") set(CMAKE_SKIPPED_HACK "env" "CMAKE_SKIPPED_HACK=1") else() set(CMAKE_SKIPPED_HACK) endif() foreach(LTEST ${LOW_LEVEL_TESTS}) add_test( NAME ${LTEST} COMMAND sh ${CMAKE_CURRENT_BINARY_DIR}/tests/test_env.sh ${CMAKE_BINARY_DIR}/fish_tests ${LTEST} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR} ) set_tests_properties(${LTEST} PROPERTIES SKIP_RETURN_CODE ${SKIP_RETURN_CODE}) add_test_target("${LTEST}") endforeach(LTEST) FILE(GLOB FISH_CHECKS CONFIGURE_DEPENDS ${CMAKE_SOURCE_DIR}/tests/checks/*.fish) foreach(CHECK ${FISH_CHECKS}) get_filename_component(CHECK_NAME ${CHECK} NAME) get_filename_component(CHECK ${CHECK} NAME_WE) add_test(NAME ${CHECK_NAME} COMMAND ${CMAKE_SKIPPED_HACK} sh ${CMAKE_CURRENT_BINARY_DIR}/tests/test_driver.sh ${CMAKE_CURRENT_BINARY_DIR}/tests/test.fish ${CHECK} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/tests ) set_tests_properties(${CHECK_NAME} PROPERTIES SKIP_RETURN_CODE ${SKIP_RETURN_CODE}) add_test_target("${CHECK_NAME}") endforeach(CHECK) FILE(GLOB PEXPECTS CONFIGURE_DEPENDS ${CMAKE_SOURCE_DIR}/tests/pexpects/*.py) foreach(PEXPECT ${PEXPECTS}) get_filename_component(PEXPECT ${PEXPECT} NAME) add_test(NAME ${PEXPECT} COMMAND ${CMAKE_SKIPPED_HACK} sh ${CMAKE_CURRENT_BINARY_DIR}/tests/test_driver.sh ${CMAKE_CURRENT_BINARY_DIR}/tests/interactive.fish ${PEXPECT} WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}/tests ) set_tests_properties(${PEXPECT} PROPERTIES SKIP_RETURN_CODE ${SKIP_RETURN_CODE}) add_test_target("${PEXPECT}") endforeach(PEXPECT)