CMake/Tests/RunCMake
Brad King be5215c4ba Merge topic 'ninja-compiler-change'
6120fca8 Ninja: Prevent compilers to be silently modified
2014-09-24 09:21:44 -04:00
..
add_dependencies
alias_targets
build_command
CheckModules
cmake_minimum_required
CMP0004
CMP0019
CMP0022
CMP0026 cmTarget: Evaluate CMP0026 and CMP0051 in calling context 2014-05-09 11:24:15 -04:00
CMP0027
CMP0028
CMP0037
CMP0038
CMP0039
CMP0040
CMP0041
CMP0042
CMP0043
CMP0045
CMP0046
CMP0049
CMP0050
CMP0051 cmTarget: Evaluate CMP0026 and CMP0051 in calling context 2014-05-09 11:24:15 -04:00
CMP0053 tests: test CMP0053 in WARN mode when watching variables 2014-05-22 11:13:29 -04:00
CMP0054 If: Introduce policy CMP0054 - don't dereference quoted variables in if() 2014-09-11 21:23:17 +02:00
CommandLine cmake: Add '-E env' command-line tool 2014-06-23 16:47:49 -04:00
CompatibleInterface cmTarget: Simplify INTERFACE_INCLUDE_DIRECTORIES usage requirement lookup 2014-07-07 08:52:42 -04:00
CompileFeatures Features: Enable compiler extensions by default. 2014-05-31 12:16:12 +02:00
CompilerChange
CompilerNotFound
Configure cmTarget: Do not mistake a preceding error for a CMP0049 failure 2014-07-30 13:48:33 -04:00
configure_file
CPackInstallProperties Add an "installed file" property scope 2014-05-28 12:28:18 -04:00
CTest
DisallowedCommands
export
ExportWithoutLanguage
ExternalData ExternalData: Warn on missing file instead of failing 2014-04-17 09:45:09 -04:00
FeatureSummary
file file(INSTALL): Add undocumented options to control output verbosity 2014-06-24 13:11:45 -04:00
File_Generate Tests: Activate tests accidentally excluded from Xcode 2014-07-17 09:31:53 -04:00
find_dependency
find_package
FindPkgConfig Tests: Fix CMP0054 warnings 2014-09-16 09:06:29 -04:00
FPHSA
GeneratorExpression Genex: Implement generator expressions for target PDB files. 2014-07-31 09:17:53 -04:00
GeneratorPlatform Tests: Test setting a generator platform in a toolchain file 2014-09-15 10:27:00 -04:00
GeneratorToolset VS14: Add Visual Studio 14 generator (#14982) 2014-06-25 14:51:19 -04:00
get_filename_component
if
include
include_directories Tests: Speed up RunCMake.include_directories test 2014-06-30 14:37:38 -04:00
include_external_msproject Tests: Add generator platform support 2014-09-10 11:21:50 -04:00
IncompatibleQt
install install(DIRECTORY): Add MESSAGE_NEVER option to avoid output (#13761) 2014-06-24 13:18:20 -04:00
interface_library
Languages cmTarget: Simplify INTERFACE_SOURCES usage requirement lookup 2014-07-07 08:52:40 -04:00
list
message
no_install_prefix
ObjectLibrary add_library: Allow arbitrary non-linked sources in OBJECT libraries 2014-07-09 09:43:42 -04:00
ObsoleteQtMacros
PositionIndependentCode
project
set RunCMake: Allow specifying the source dir and file to test. 2014-04-06 23:58:35 +02:00
SolutionGlobalSections
string StringUuid: Implement new string(UUID) sub-command. 2014-08-28 15:13:54 +02:00
Syntax Merge topic 'fix-lexer-open-square' 2014-08-19 09:48:36 -04:00
target_compile_features Features: Extend concept to C language. 2014-05-15 00:15:18 +02:00
target_link_libraries
TargetObjects Allow INTERFACE_SOURCES to specify $<TARGET_OBJECTS> (#14970) 2014-07-14 09:09:32 -04:00
TargetPolicies Export: Disallow exported interface includes in src/build tree (#14592). 2014-04-09 10:38:49 +02:00
TargetPropertyGeneratorExpressions Genex: Fix stack overflow in transitive property evaluation. 2014-07-02 00:09:38 +02:00
TargetSources Tests: Fix RunCMake.TargetSources on Xcode 1.5 2014-06-06 10:28:32 -04:00
try_compile
variable_watch
VisibilityPreset
WriteCompilerDetectionHeader WCDH: Ensure that the prefix argument to the macro is valid. 2014-07-02 19:37:04 +02:00
XcodeProject Xcode: Add source file property to control file type (#14854) 2014-05-15 14:34:52 -04:00
CMakeLists.txt Ninja: Prevent compilers to be silently modified 2014-09-22 08:44:39 -04:00
README.rst
RunCMake.cmake cmake: Add -A option to specify a generator platform 2014-09-15 10:26:59 -04:00

This directory contains tests that run CMake to configure a project
but do not actually build anything.  To add a test:

1. Add a subdirectory named for the test, say ``<Test>/``.

2. In ``./CMakeLists.txt`` call ``add_RunCMake_test`` and pass the
   test directory name ``<Test>``.

3. Create script ``<Test>/RunCMakeTest.cmake`` in the directory containing::

    include(RunCMake)
    run_cmake(SubTest1)
    ...
    run_cmake(SubTestN)

   where ``SubTest1`` through ``SubTestN`` are sub-test names each
   corresponding to an independent CMake run and project configuration.

   One may also add calls of the form::

    run_cmake_command(SubTestI ${CMAKE_COMMAND} ...)

   to fully customize the test case command-line.

4. Create file ``<Test>/CMakeLists.txt`` in the directory containing::

    cmake_minimum_required(...)
    project(${RunCMake_TEST} NONE) # or languages needed
    include(${RunCMake_TEST}.cmake)

   where ``${RunCMake_TEST}`` is literal.  A value for ``RunCMake_TEST``
   will be passed to CMake by the ``run_cmake`` macro when running each
   sub-test.

5. Create a ``<Test>/<SubTest>.cmake`` file for each sub-test named
   above containing the actual test code.  Optionally create files
   containing expected test results:

   ``<SubTest>-result.txt``
    Process result expected if not "0"
   ``<SubTest>-stdout.txt``
    Regex matching expected stdout content
   ``<SubTest>-stderr.txt``
    Regex matching expected stderr content
   ``<SubTest>-check.cmake``
    Custom result check.

   Note that trailing newlines will be stripped from actual and expected
   test output before matching against the stdout and stderr expressions.
   The code in ``<SubTest>-check.cmake`` may use variables

   ``RunCMake_TEST_SOURCE_DIR``
    Top of test source tree
   ``RunCMake_TEST_BINARY_DIR``
    Top of test binary tree

   and an failure must store a message in ``RunCMake_TEST_FAILED``.