annotate CSP2/CSP2_env/env-d9b9114564458d9d-741b3de822f2aaca6c6caa4325c4afce/lib/cmake/CapnProto/CapnProtoTargets.cmake @ 69:33d812a61356

planemo upload commit 2e9511a184a1ca667c7be0c6321a36dc4e3d116d
author jpayne
date Tue, 18 Mar 2025 17:55:14 -0400
parents
children
rev   line source
jpayne@69 1 # This CMake script adds imported targets for each shared library and executable distributed by
jpayne@69 2 # Cap'n Proto's autotools build.
jpayne@69 3 #
jpayne@69 4 # This file IS NOT USED by the CMake build! The CMake build generates its own version of this script
jpayne@69 5 # from its set of exported targets. I used such a generated script as a reference when writing this
jpayne@69 6 # one.
jpayne@69 7 #
jpayne@69 8 # The set of library targets provided by this script is automatically generated from the list of .pc
jpayne@69 9 # files maintained in configure.ac. The set of executable targets is hard-coded in this file.
jpayne@69 10 #
jpayne@69 11 # You can request that this script print debugging information by invoking cmake with:
jpayne@69 12 #
jpayne@69 13 # -DCapnProto_DEBUG=ON
jpayne@69 14 #
jpayne@69 15 # TODO(someday): Distinguish between debug and release builds. I.e., set IMPORTED_LOCATION_RELEASE
jpayne@69 16 # rather than IMPORTED_LOCATION, etc., if this installation was configured as a release build. But
jpayne@69 17 # how do we tell? grep for -g in CXXFLAGS?
jpayne@69 18
jpayne@69 19 if(CMAKE_VERSION VERSION_LESS 3.1)
jpayne@69 20 message(FATAL_ERROR "CMake >= 3.1 required")
jpayne@69 21 endif()
jpayne@69 22
jpayne@69 23 set(forwarded_config_flags)
jpayne@69 24 if(CapnProto_FIND_QUIETLY)
jpayne@69 25 list(APPEND forwarded_config_flags QUIET)
jpayne@69 26 endif()
jpayne@69 27 if(CapnProto_FIND_REQUIRED)
jpayne@69 28 list(APPEND forwarded_config_flags REQUIRED)
jpayne@69 29 endif()
jpayne@69 30 # If the consuming project called find_package(CapnProto) with the QUIET or REQUIRED flags, forward
jpayne@69 31 # them to calls to find_package(PkgConfig) and pkg_check_modules(). Note that find_dependency()
jpayne@69 32 # would do this for us in the former case, but there is no such forwarding wrapper for
jpayne@69 33 # pkg_check_modules().
jpayne@69 34
jpayne@69 35 find_package(PkgConfig ${forwarded_config_flags})
jpayne@69 36 if(NOT ${PkgConfig_FOUND})
jpayne@69 37 # If we're here, the REQUIRED flag must not have been passed, else we would have had a fatal
jpayne@69 38 # error. Nevertheless, a diagnostic for this case is probably nice.
jpayne@69 39 if(NOT CapnProto_FIND_QUIETLY)
jpayne@69 40 message(WARNING "pkg-config cannot be found")
jpayne@69 41 endif()
jpayne@69 42 set(CapnProto_FOUND OFF)
jpayne@69 43 return()
jpayne@69 44 endif()
jpayne@69 45
jpayne@69 46 function(_capnp_import_pkg_config_target target)
jpayne@69 47 # Add an imported library target named CapnProto::${target}, using the output of various
jpayne@69 48 # invocations of `pkg-config ${target}`. The generated imported library target tries to mimic the
jpayne@69 49 # behavior of a real CMake-generated imported target as closely as possible.
jpayne@69 50 #
jpayne@69 51 # Usage: _capnp_import_pkg_config_target(target <all Cap'n Proto targets>)
jpayne@69 52
jpayne@69 53 set(all_targets ${ARGN})
jpayne@69 54
jpayne@69 55 pkg_check_modules(${target} ${forwarded_config_flags} ${target})
jpayne@69 56
jpayne@69 57 if(NOT ${${target}_FOUND})
jpayne@69 58 if(NOT CapnProto_FIND_QUIETLY)
jpayne@69 59 message(WARNING "CapnProtoConfig.cmake was configured to search for ${target}.pc, but pkg-config cannot find it. Ignoring this target.")
jpayne@69 60 endif()
jpayne@69 61 return()
jpayne@69 62 endif()
jpayne@69 63
jpayne@69 64 if(CapnProto_DEBUG)
jpayne@69 65 # Dump the information pkg-config discovered.
jpayne@69 66 foreach(var VERSION LIBRARY_DIRS LIBRARIES LDFLAGS_OTHER INCLUDE_DIRS CFLAGS_OTHER)
jpayne@69 67 message(STATUS "${target}_${var} = ${${target}_${var}}")
jpayne@69 68 endforeach()
jpayne@69 69 endif()
jpayne@69 70
jpayne@69 71 if(NOT ${${target}_VERSION} VERSION_EQUAL ${CapnProto_VERSION})
jpayne@69 72 if(NOT CapnProto_FIND_QUIETLY)
jpayne@69 73 message(WARNING "CapnProtoConfig.cmake was configured to search for version ${CapnProto_VERSION}, but ${target} version ${${target}_VERSION} was found. Ignoring this target.")
jpayne@69 74 endif()
jpayne@69 75 return()
jpayne@69 76 endif()
jpayne@69 77
jpayne@69 78 # Make an educated guess as to what the target's .so and .a filenames must be.
jpayne@69 79 set(target_name_shared
jpayne@69 80 ${CMAKE_SHARED_LIBRARY_PREFIX}${target}-${CapnProto_VERSION}${CMAKE_SHARED_LIBRARY_SUFFIX})
jpayne@69 81 set(target_name_static
jpayne@69 82 ${CMAKE_STATIC_LIBRARY_PREFIX}${target}${CMAKE_STATIC_LIBRARY_SUFFIX})
jpayne@69 83
jpayne@69 84 # Find the actual target's file. find_library() sets a cache variable, so I made the variable name
jpayne@69 85 # unique-ish.
jpayne@69 86 find_library(CapnProto_${target}_IMPORTED_LOCATION
jpayne@69 87 NAMES ${target_name_shared} ${target_name_static} # prefer libfoo-version.so over libfoo.a
jpayne@69 88 PATHS ${${target}_LIBRARY_DIRS}
jpayne@69 89 NO_DEFAULT_PATH
jpayne@69 90 )
jpayne@69 91 # If the installed version of Cap'n Proto is in a system location, pkg-config will not have filled
jpayne@69 92 # in ${target}_LIBRARY_DIRS. To account for this, fall back to a regular search.
jpayne@69 93 find_library(CapnProto_${target}_IMPORTED_LOCATION
jpayne@69 94 NAMES ${target_name_shared} ${target_name_static} # prefer libfoo-version.so over libfoo.a
jpayne@69 95 )
jpayne@69 96
jpayne@69 97 if(NOT CapnProto_${target}_IMPORTED_LOCATION)
jpayne@69 98 # Not an error if the library doesn't exist -- we may have found a lite mode installation.
jpayne@69 99 if(CapnProto_DEBUG)
jpayne@69 100 message(STATUS "${target} library does not exist")
jpayne@69 101 endif()
jpayne@69 102 return()
jpayne@69 103 endif()
jpayne@69 104
jpayne@69 105 # Record some information about this target -- shared versus static, location and soname -- which
jpayne@69 106 # we'll use to build our imported target later.
jpayne@69 107
jpayne@69 108 set(target_location ${CapnProto_${target}_IMPORTED_LOCATION})
jpayne@69 109 get_filename_component(target_name "${target_location}" NAME)
jpayne@69 110
jpayne@69 111 set(target_type STATIC)
jpayne@69 112 set(imported_soname_property)
jpayne@69 113 if(target_name STREQUAL ${target_name_shared})
jpayne@69 114 set(target_type SHARED)
jpayne@69 115 set(imported_soname_property IMPORTED_SONAME ${target_name})
jpayne@69 116 endif()
jpayne@69 117
jpayne@69 118 # Each library dependency of the target is either the target itself, a sibling Cap'n Proto
jpayne@69 119 # library, or a system library. We ignore the first case by removing this target from the
jpayne@69 120 # dependencies. The remaining dependencies are either passed through or, if they are a sibling
jpayne@69 121 # Cap'n Proto library, prefixed with `CapnProto::`.
jpayne@69 122 set(dependencies ${${target}_LIBRARIES})
jpayne@69 123 list(REMOVE_ITEM dependencies ${target})
jpayne@69 124 set(target_interface_libs)
jpayne@69 125 foreach(dependency ${dependencies})
jpayne@69 126 list(FIND all_targets ${dependency} target_index)
jpayne@69 127 # TODO(cleanup): CMake >= 3.3 lets us write: `if(NOT ${dependency} IN_LIST all_targets)`
jpayne@69 128 if(target_index EQUAL -1)
jpayne@69 129 list(APPEND target_interface_libs ${dependency})
jpayne@69 130 else()
jpayne@69 131 list(APPEND target_interface_libs CapnProto::${dependency})
jpayne@69 132 endif()
jpayne@69 133 endforeach()
jpayne@69 134
jpayne@69 135 add_library(CapnProto::${target} ${target_type} IMPORTED)
jpayne@69 136 set_target_properties(CapnProto::${target} PROPERTIES
jpayne@69 137 ${imported_soname_property}
jpayne@69 138 IMPORTED_LOCATION "${target_location}"
jpayne@69 139 # TODO(cleanup): Use cxx_std_14 once it's safe to require cmake 3.8.
jpayne@69 140 INTERFACE_COMPILE_FEATURES "cxx_generic_lambdas"
jpayne@69 141 INTERFACE_COMPILE_OPTIONS "${${target}_CFLAGS_OTHER}"
jpayne@69 142 INTERFACE_INCLUDE_DIRECTORIES "${${target}_INCLUDE_DIRS}"
jpayne@69 143
jpayne@69 144 # I'm dumping LDFLAGS_OTHER in with the libraries because there exists no
jpayne@69 145 # INTERFACE_LINK_OPTIONS. See https://gitlab.kitware.com/cmake/cmake/issues/16543.
jpayne@69 146 INTERFACE_LINK_LIBRARIES "${target_interface_libs};${${target}_LDFLAGS_OTHER}"
jpayne@69 147 )
jpayne@69 148
jpayne@69 149 if(CapnProto_DEBUG)
jpayne@69 150 # Dump all the properties we generated for the imported target.
jpayne@69 151 foreach(prop
jpayne@69 152 IMPORTED_LOCATION
jpayne@69 153 IMPORTED_SONAME
jpayne@69 154 INTERFACE_COMPILE_FEATURES
jpayne@69 155 INTERFACE_COMPILE_OPTIONS
jpayne@69 156 INTERFACE_INCLUDE_DIRECTORIES
jpayne@69 157 INTERFACE_LINK_LIBRARIES)
jpayne@69 158 get_target_property(value CapnProto::${target} ${prop})
jpayne@69 159 message(STATUS "CapnProto::${target} ${prop} = ${value}")
jpayne@69 160 endforeach()
jpayne@69 161 endif()
jpayne@69 162 endfunction()
jpayne@69 163
jpayne@69 164 # ========================================================================================
jpayne@69 165 # Imported library targets
jpayne@69 166
jpayne@69 167 # Build a list of targets to search for from the list of .pc files.
jpayne@69 168 # I.e. [somewhere/foo.pc, somewhere/bar.pc] -> [foo, bar]
jpayne@69 169 set(library_targets)
jpayne@69 170 foreach(filename ${CAPNP_PKG_CONFIG_FILES})
jpayne@69 171 get_filename_component(target ${filename} NAME_WE)
jpayne@69 172 list(APPEND library_targets ${target})
jpayne@69 173 endforeach()
jpayne@69 174
jpayne@69 175 # Try to add an imported library target CapnProto::foo for each foo.pc distributed with Cap'n Proto.
jpayne@69 176 foreach(target ${library_targets})
jpayne@69 177 _capnp_import_pkg_config_target(${target} ${library_targets})
jpayne@69 178 endforeach()
jpayne@69 179
jpayne@69 180 # Handle lite-mode and no libraries found cases. It is tempting to set a CapnProto_LITE variable
jpayne@69 181 # here, but the real CMake-generated implementation does no such thing -- we'd need to set it in
jpayne@69 182 # CapnProtoConfig.cmake.in itself.
jpayne@69 183 if(TARGET CapnProto::capnp AND TARGET CapnProto::kj)
jpayne@69 184 if(NOT TARGET CapnProto::capnp-rpc)
jpayne@69 185 if(NOT CapnProto_FIND_QUIETLY)
jpayne@69 186 message(STATUS "Found an installation of Cap'n Proto lite. Executable and library targets beyond libkj and libcapnp will be unavailable.")
jpayne@69 187 endif()
jpayne@69 188 # Lite mode doesn't include the executables, so return here.
jpayne@69 189 return()
jpayne@69 190 endif()
jpayne@69 191 else()
jpayne@69 192 # If we didn't even find capnp or kj, then we didn't find anything usable.
jpayne@69 193 set(CapnProto_FOUND OFF)
jpayne@69 194 return()
jpayne@69 195 endif()
jpayne@69 196
jpayne@69 197 # ========================================================================================
jpayne@69 198 # Imported executable targets
jpayne@69 199
jpayne@69 200 get_filename_component(_IMPORT_PREFIX "${CMAKE_CURRENT_LIST_FILE}" PATH)
jpayne@69 201 get_filename_component(_IMPORT_PREFIX "${_IMPORT_PREFIX}" PATH)
jpayne@69 202 get_filename_component(_IMPORT_PREFIX "${_IMPORT_PREFIX}" PATH)
jpayne@69 203 get_filename_component(_IMPORT_PREFIX "${_IMPORT_PREFIX}" PATH)
jpayne@69 204
jpayne@69 205 # Add executable targets for the capnp compiler and plugins. This list must be kept manually in sync
jpayne@69 206 # with the rest of the project.
jpayne@69 207
jpayne@69 208 add_executable(CapnProto::capnp_tool IMPORTED)
jpayne@69 209 set_target_properties(CapnProto::capnp_tool PROPERTIES
jpayne@69 210 IMPORTED_LOCATION "${_IMPORT_PREFIX}/bin/capnp${CMAKE_EXECUTABLE_SUFFIX}"
jpayne@69 211 )
jpayne@69 212
jpayne@69 213 add_executable(CapnProto::capnpc_cpp IMPORTED)
jpayne@69 214 set_target_properties(CapnProto::capnpc_cpp PROPERTIES
jpayne@69 215 IMPORTED_LOCATION "${_IMPORT_PREFIX}/bin/capnpc-c++${CMAKE_EXECUTABLE_SUFFIX}"
jpayne@69 216 )
jpayne@69 217
jpayne@69 218 add_executable(CapnProto::capnpc_capnp IMPORTED)
jpayne@69 219 set_target_properties(CapnProto::capnpc_capnp PROPERTIES
jpayne@69 220 IMPORTED_LOCATION "${_IMPORT_PREFIX}/bin/capnpc-capnp${CMAKE_EXECUTABLE_SUFFIX}"
jpayne@69 221 )