1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93
|
# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
# SPDX-License-Identifier: Apache-2.0.
# This cmake logic verifies that each of our headers is complete, in that it
# #includes any necessary dependencies, and that it builds under C++ as well.
#
# To do so, we generate a single-line C or C++ source file that includes each
# header, and link all of these stub source files into a test executable.
option(PERFORM_HEADER_CHECK "Performs compile-time checks that each header can be included independently. Requires a C++ compiler.")
if (PERFORM_HEADER_CHECK)
enable_language(CXX)
endif()
# Call as: aws_check_headers(${target} HEADERS TO CHECK LIST)
function(aws_check_headers target)
if (NOT PERFORM_HEADER_CHECK)
return()
endif()
# parse function arguments
set(options IS_CXX)
cmake_parse_arguments(ARG "${options}" "" "" ${ARGN})
aws_check_headers_internal(${target} 11 ${ARG_IS_CXX} ${ARG_UNPARSED_ARGUMENTS})
aws_check_headers_internal(${target} 14 ${ARG_IS_CXX} ${ARG_UNPARSED_ARGUMENTS})
aws_check_headers_internal(${target} 17 ${ARG_IS_CXX} ${ARG_UNPARSED_ARGUMENTS})
aws_check_headers_internal(${target} 20 ${ARG_IS_CXX} ${ARG_UNPARSED_ARGUMENTS})
aws_check_headers_internal(${target} 23 ${ARG_IS_CXX} ${ARG_UNPARSED_ARGUMENTS})
endfunction()
function(aws_check_headers_internal target std is_cxx)
# Check that compiler supports this std
list (FIND CMAKE_CXX_COMPILE_FEATURES "cxx_std_${std}" feature_idx)
if (${feature_idx} LESS 0)
return()
endif()
set(HEADER_CHECKER_ROOT "${CMAKE_CURRENT_BINARY_DIR}/header-checker-cxx${std}")
# Write stub main file
set(HEADER_CHECKER_MAIN "${HEADER_CHECKER_ROOT}/headerchecker_main.c")
set(HEADER_CHECKER_LIB ${target}-header-check-cxx${std})
file(WRITE ${HEADER_CHECKER_MAIN} "
int main(int argc, char **argv) {
(void)argc;
(void)argv;
return 0;
}\n")
add_executable(${HEADER_CHECKER_LIB} ${HEADER_CHECKER_MAIN})
target_link_libraries(${HEADER_CHECKER_LIB} ${target})
target_compile_definitions(${HEADER_CHECKER_LIB} PRIVATE AWS_UNSTABLE_TESTING_API=1 AWS_HEADER_CHECKER=1)
# We want to be able to verify that the proper C++ header guards are in place, so
# build this target as a C++ application
set_target_properties(${HEADER_CHECKER_LIB} PROPERTIES
LINKER_LANGUAGE CXX
CXX_STANDARD ${std}
CXX_STANDARD_REQUIRED 0
C_STANDARD 99
)
# Ensure our headers can be included by an application with its warnings set very high
if(MSVC)
# MSVC complains about windows' own header files. Use /W4 instead of /Wall
target_compile_options(${HEADER_CHECKER_LIB} PRIVATE /W4 /WX)
else()
target_compile_options(${HEADER_CHECKER_LIB} PRIVATE -Wall -Wextra -Wpedantic -Werror)
endif()
foreach(header IN LISTS ARGN)
if (NOT ${header} MATCHES "\\.inl$")
# create unique token for this file, e.g.:
# "${CMAKE_CURRENT_SOURCE_DIR}/include/aws/common/byte_buf.h" -> "aws_common_byte_buf_h"
file(RELATIVE_PATH include_path "${CMAKE_CURRENT_SOURCE_DIR}/include" ${header})
# replace non-alphanumeric characters with underscores
string(REGEX REPLACE "[^a-zA-Z0-9]" "_" unique_token ${include_path})
set(c_file "${HEADER_CHECKER_ROOT}/headerchecker_${unique_token}.c")
set(cpp_file "${HEADER_CHECKER_ROOT}/headerchecker_${unique_token}.cpp")
# include header twice to check for include-guards
# define a unique int or compiler complains that there's nothing in the file
file(WRITE "${cpp_file}" "#include <${include_path}>\n#include <${include_path}>\nint ${unique_token}_cpp;")
target_sources(${HEADER_CHECKER_LIB} PUBLIC "${cpp_file}")
if (NOT is_cxx)
file(WRITE "${c_file}" "#include <${include_path}>\n#include <${include_path}>\nint ${unique_token}_c;\n")
target_sources(${HEADER_CHECKER_LIB} PUBLIC "${c_file}")
endif()
endif()
endforeach(header)
endfunction()
|