123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145 |
- # Distributed under the OSI-approved BSD 3-Clause License. See accompanying
- # file Copyright.txt or https://cmake.org/licensing for details.
- #.rst:
- # CMakePrintHelpers
- # -----------------
- #
- # Convenience macros for printing properties and variables, useful e.g. for debugging.
- #
- # ::
- #
- # CMAKE_PRINT_PROPERTIES([TARGETS target1 .. targetN]
- # [SOURCES source1 .. sourceN]
- # [DIRECTORIES dir1 .. dirN]
- # [TESTS test1 .. testN]
- # [CACHE_ENTRIES entry1 .. entryN]
- # PROPERTIES prop1 .. propN )
- #
- # This macro prints the values of the properties of the given targets,
- # source files, directories, tests or cache entries. Exactly one of the
- # scope keywords must be used. Example::
- #
- # cmake_print_properties(TARGETS foo bar PROPERTIES
- # LOCATION INTERFACE_INCLUDE_DIRS)
- #
- # This will print the LOCATION and INTERFACE_INCLUDE_DIRS properties for
- # both targets foo and bar.
- #
- #
- #
- # CMAKE_PRINT_VARIABLES(var1 var2 .. varN)
- #
- # This macro will print the name of each variable followed by its value.
- # Example::
- #
- # cmake_print_variables(CMAKE_C_COMPILER CMAKE_MAJOR_VERSION DOES_NOT_EXIST)
- #
- # Gives::
- #
- # -- CMAKE_C_COMPILER="/usr/bin/gcc" ; CMAKE_MAJOR_VERSION="2" ; DOES_NOT_EXIST=""
- function(CMAKE_PRINT_VARIABLES)
- set(msg "")
- foreach(var ${ARGN})
- if(msg)
- string(APPEND msg " ; ")
- endif()
- string(APPEND msg "${var}=\"${${var}}\"")
- endforeach()
- message(STATUS "${msg}")
- endfunction()
- function(CMAKE_PRINT_PROPERTIES )
- set(options )
- set(oneValueArgs )
- set(multiValueArgs TARGETS SOURCES TESTS DIRECTORIES CACHE_ENTRIES PROPERTIES )
- cmake_parse_arguments(CPP "${options}" "${oneValueArgs}" "${multiValueArgs}" ${ARGN})
- if(CPP_UNPARSED_ARGUMENTS)
- message(FATAL_ERROR "Unknown keywords given to cmake_print_properties(): \"${CPP_UNPARSED_ARGUMENTS}\"")
- return()
- endif()
- if(NOT CPP_PROPERTIES)
- message(FATAL_ERROR "Required argument PROPERTIES missing in cmake_print_properties() call")
- return()
- endif()
- set(mode)
- set(items)
- set(keyword)
- if(CPP_TARGETS)
- set(items ${CPP_TARGETS})
- set(mode ${mode} TARGETS)
- set(keyword TARGET)
- endif()
- if(CPP_SOURCES)
- set(items ${CPP_SOURCES})
- set(mode ${mode} SOURCES)
- set(keyword SOURCE)
- endif()
- if(CPP_TESTS)
- set(items ${CPP_TESTS})
- set(mode ${mode} TESTS)
- set(keyword TEST)
- endif()
- if(CPP_DIRECTORIES)
- set(items ${CPP_DIRECTORIES})
- set(mode ${mode} DIRECTORIES)
- set(keyword DIRECTORY)
- endif()
- if(CPP_CACHE_ENTRIES)
- set(items ${CPP_CACHE_ENTRIES})
- set(mode ${mode} CACHE_ENTRIES)
- set(keyword CACHE)
- endif()
- if(NOT mode)
- message(FATAL_ERROR "Mode keyword missing in cmake_print_properties() call, must be one of TARGETS SOURCES TESTS DIRECTORIES CACHE_ENTRIES PROPERTIES")
- return()
- endif()
- list(LENGTH mode modeLength)
- if("${modeLength}" GREATER 1)
- message(FATAL_ERROR "Multiple mode keyword used in cmake_print_properties() call, it must be exactly one of TARGETS SOURCES TESTS DIRECTORIES CACHE_ENTRIES PROPERTIES")
- return()
- endif()
- set(msg "\n")
- foreach(item ${items})
- set(itemExists TRUE)
- if(keyword STREQUAL "TARGET")
- if(NOT TARGET ${item})
- set(itemExists FALSE)
- string(APPEND msg "\n No such TARGET \"${item}\" !\n\n")
- endif()
- endif()
- if (itemExists)
- string(APPEND msg " Properties for ${keyword} ${item}:\n")
- foreach(prop ${CPP_PROPERTIES})
- get_property(propertySet ${keyword} ${item} PROPERTY "${prop}" SET)
- if(propertySet)
- get_property(property ${keyword} ${item} PROPERTY "${prop}")
- string(APPEND msg " ${item}.${prop} = \"${property}\"\n")
- else()
- string(APPEND msg " ${item}.${prop} = <NOTFOUND>\n")
- endif()
- endforeach()
- endif()
- endforeach()
- message(STATUS "${msg}")
- endfunction()
|