ENH: Add script GetPrerequisites.cmake to help analyze what shared libraries executable files depend on. Primary uses are to determine what shared libraries should be copied into Mac OSX bundle applications to create standalone bundles apps and to determine what shared library files need to be installed for an executable to run on any platform. Requires native platform tools dumpbin, otool and ldd to generate results.

2 files changed, 159 insertions, 2 deletions

diff --git a/Tests/CMakeTests/CMakeLists.txt b/Tests/CMakeTests/CMakeLists.txt
index 411855f..b2b29e6 100644
--- a/Tests/CMakeTests/CMakeLists.txt
+++ b/Tests/CMakeTests/CMakeLists.txt
@@ -1,14 +1,25 @@
 SET(CMAKE_EXECUTABLE "${EXECUTABLE_OUTPUT_PATH}/cmake")
 
 
-MACRO(AddCMakeTest TestName Arguments)
+MACRO(AddCMakeTest TestName PreArgs)
   CONFIGURE_FILE("${CMAKE_CURRENT_SOURCE_DIR}/${TestName}Test.cmake.in"
     "${CMAKE_CURRENT_BINARY_DIR}/${TestName}Test.cmake" @ONLY IMMEDIATE)
-  ADD_TEST(CMake.${TestName} ${CMAKE_EXECUTABLE} -P "${CMAKE_CURRENT_BINARY_DIR}/${TestName}Test.cmake" ${Arguments})
+  ADD_TEST(CMake.${TestName} ${CMAKE_EXECUTABLE} ${PreArgs}
+    -P "${CMAKE_CURRENT_BINARY_DIR}/${TestName}Test.cmake" ${ARGN})
 ENDMACRO(AddCMakeTest)
 
+
 AddCMakeTest(List "")
 AddCMakeTest(VariableWatch "")
 AddCMakeTest(Include "")
 AddCMakeTest(FindBase "")
 AddCMakeTest(Toolchain "")
+
+# Not ready for Unix testing yet. Coming "soon"...
+#
+IF(WIN32 OR APPLE)
+  SET(GetPrerequisites_PreArgs
+    "-DCTEST_CONFIGURATION_TYPE:STRING=\\\${CTEST_CONFIGURATION_TYPE}"
+    )
+  AddCMakeTest(GetPrerequisites "${GetPrerequisites_PreArgs}")
+ENDIF(WIN32 OR APPLE)
diff --git a/Tests/CMakeTests/GetPrerequisitesTest.cmake.in b/Tests/CMakeTests/GetPrerequisitesTest.cmake.in
new file mode 100644
index 0000000..4363a42
--- /dev/null
+++ b/Tests/CMakeTests/GetPrerequisitesTest.cmake.in
@@ -0,0 +1,146 @@
+# Test of the functions in the CMake Modules file:
+#
+include(GetPrerequisites)
+
+
+set(CMAKE_BUILD_TYPE "@CMAKE_BUILD_TYPE@")
+set(CMAKE_CONFIGURATION_TYPES "@CMAKE_CONFIGURATION_TYPES@")
+set(CMAKE_EXECUTABLE_SUFFIX "@CMAKE_EXECUTABLE_SUFFIX@")
+
+
+message(STATUS "=============================================================================")
+message(STATUS "CTEST_FULL_OUTPUT (Avoid ctest truncation of output)")
+message(STATUS "")
+message(STATUS "CMAKE_BUILD_TYPE='${CMAKE_BUILD_TYPE}'")
+message(STATUS "CMAKE_CONFIGURATION_TYPES='${CMAKE_CONFIGURATION_TYPES}'")
+message(STATUS "CMAKE_EXECUTABLE_SUFFIX='${CMAKE_EXECUTABLE_SUFFIX}'")
+message(STATUS "CTEST_CONFIGURATION_TYPE='${CTEST_CONFIGURATION_TYPE}'")
+message(STATUS "")
+
+
+function(stresstest_list_prerequisites file)
+  message(STATUS "=============================================================================")
+  message(STATUS "stresstest_list_prerequisites file='${file}'")
+  message(STATUS "")
+
+  get_filename_component(file_full "${file}" ABSOLUTE)
+
+  message(STATUS "list_prerequisites '${file_full}' 0 0 0")
+  list_prerequisites("${file_full}" 0 0 0)
+  message(STATUS "")
+
+  message(STATUS "list_prerequisites '${file_full}' 0 0 1")
+  list_prerequisites("${file_full}" 0 0 1)
+  message(STATUS "")
+
+  message(STATUS "list_prerequisites '${file_full}' 0 1 0")
+  list_prerequisites("${file_full}" 0 1 0)
+  message(STATUS "")
+
+  message(STATUS "list_prerequisites '${file_full}' 0 1 1")
+  list_prerequisites("${file_full}" 0 1 1)
+  message(STATUS "")
+
+  message(STATUS "list_prerequisites '${file_full}' 1 0 0")
+  list_prerequisites("${file_full}" 1 0 0)
+  message(STATUS "")
+
+  message(STATUS "list_prerequisites '${file_full}' 1 0 1")
+  list_prerequisites("${file_full}" 1 0 1)
+  message(STATUS "")
+
+  message(STATUS "list_prerequisites '${file_full}' 1 1 0")
+  list_prerequisites("${file_full}" 1 1 0)
+  message(STATUS "")
+
+  message(STATUS "list_prerequisites '${file_full}' 1 1 1")
+  list_prerequisites("${file_full}" 1 1 1)
+  message(STATUS "")
+
+  message(STATUS "=============================================================================")
+  message(STATUS "")
+endfunction(stresstest_list_prerequisites)
+
+
+function(test_cmake_executables)
+  message(STATUS "=============================================================================")
+  message(STATUS "Loop over all executable files in the same directory with CMake")
+  message(STATUS "")
+
+  get_filename_component(cmake_bin_dir "${CMAKE_COMMAND}" PATH)
+  list_prerequisites_by_glob(GLOB "${cmake_bin_dir}/*" 0 0 1)
+endfunction(test_cmake_executables)
+
+
+message(STATUS "=============================================================================")
+message(STATUS "Simplest test - list all the direct prerequisites of CMake itself")
+message(STATUS "")
+list_prerequisites("${CMAKE_COMMAND}" 0 0 1)
+message(STATUS "")
+
+
+# Leave the code for these tests in here, but turn them off by default... they
+# take longer than they're worth during development...
+#
+set(do_testdefaults 0)
+if(do_testdefaults)
+  message(STATUS "=============================================================================")
+  message(STATUS "Test default argument values to list_prerequisites function...")
+  message(STATUS "")
+  list_prerequisites("${CMAKE_COMMAND}")
+  message(STATUS "")
+endif(do_testdefaults)
+
+
+set(do_stresstest 0)
+if(do_stresstest)
+  message(STATUS "=============================================================================")
+  message(STATUS "stresstest_list_prerequisites with CMake itself...")
+  message(STATUS "")
+  stresstest_list_prerequisites("${CMAKE_COMMAND}")
+  message(STATUS "")
+endif(do_stresstest)
+
+
+test_cmake_executables()
+
+
+message(STATUS "=============================================================================")
+message(STATUS "Test overriding 'gp_tool' with bogus value")
+message(STATUS "")
+set(gp_tool "bogus")
+list_prerequisites("${CMAKE_COMMAND}" 0 0 0)
+set(gp_tool)
+message(STATUS "")
+
+
+message(STATUS "=============================================================================")
+message(STATUS "Test overriding 'gp_tool' with value unlikely to be found")
+message(STATUS "")
+if(WIN32 OR APPLE)
+  set(gp_tool "ldd")
+else(WIN32 OR APPLE)
+  set(gp_tool "otool")
+endif(WIN32 OR APPLE)
+set(gp_cmd "gp_cmd-NOTFOUND")
+list_prerequisites("${CMAKE_COMMAND}" 0 0 0)
+set(gp_cmd)
+set(gp_tool)
+message(STATUS "")
+
+
+message(STATUS "=============================================================================")
+message(STATUS "All variables: (Make sure functions/macros are not leaving stuff around...")
+message(STATUS "                Only variables predefined by CMake and defined in this")
+message(STATUS "                test script file should be listed here...)")
+message(STATUS "")
+get_cmake_property(vs VARIABLES)
+foreach(v ${vs})
+  message(STATUS "${v}='${${v}}'")
+endforeach(v)
+message(STATUS "")
+
+
+message(STATUS "=============================================================================")
+message(STATUS "End of test")
+message(STATUS "")