2023-05-27 04:29:02 +08:00
#
# Copyright by The HDF Group.
# All rights reserved.
#
# This file is part of HDF5. The full HDF5 copyright notice, including
# terms governing use, modification, and redistribution, is contained in
# the COPYING file, which can be found at the root of the source code
# distribution tree, or in https://www.hdfgroup.org/licenses.
# If you do not have access to either file, you may request a copy from
# help@hdfgroup.org.
#
include ( FetchContent )
# Function to retrieve all of the CMake targets generated
# in a directory and all its subdirectories
function ( get_generated_cmake_targets out_var dir )
get_directory_property ( dir_targets DIRECTORY "${dir}" BUILDSYSTEM_TARGETS )
get_directory_property ( dir_subdirs DIRECTORY "${dir}" SUBDIRECTORIES )
foreach ( subdir ${ dir_subdirs } )
get_generated_cmake_targets ( subdir_targets "${subdir}" )
list ( APPEND dir_targets "${subdir_targets}" )
endforeach ( )
set ( ${ out_var } "${dir_targets}" PARENT_SCOPE )
endfunction ( )
# For now, only support building of external VOL connectors with FetchContent
2023-09-02 05:01:37 +08:00
option ( HDF5_VOL_ALLOW_EXTERNAL "Allow building of external HDF5 VOL connectors with FetchContent" "NO" )
2023-05-27 04:29:02 +08:00
mark_as_advanced ( HDF5_VOL_ALLOW_EXTERNAL )
if ( HDF5_VOL_ALLOW_EXTERNAL )
2023-09-02 05:01:37 +08:00
if ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "NO" OR ( NOT HDF5_VOL_ALLOW_EXTERNAL MATCHES "GIT" AND NOT HDF5_VOL_ALLOW_EXTERNAL MATCHES "LOCAL_DIR" ) )
message ( FATAL_ERROR "HDF5_VOL_ALLOW_EXTERNAL must be set to 'GIT' or 'LOCAL_DIR' to allow building of external HDF5 VOL connectors" )
endif ( )
2023-05-27 04:29:02 +08:00
# For compatibility, set some variables that projects would
# typically look for after calling find_package(HDF5)
set ( HDF5_FOUND 1 )
set ( HDF5_LIBRARIES "${HDF5_LIBSH_TARGET};${LINK_LIBS};${LINK_COMP_LIBS};$<$<BOOL:${HDF5_ENABLE_PARALLEL}>:MPI::MPI_C>" )
set ( HDF5_INCLUDE_DIRS "${HDF5_SRC_INCLUDE_DIRS};${HDF5_SRC_BINARY_DIR};$<$<BOOL:${HDF5_ENABLE_PARALLEL}>:${MPI_C_INCLUDE_DIRS}>" )
2023-08-31 11:23:59 +08:00
set ( HDF5_C_LIBRARIES "${HDF5_LIBRARIES}" )
if ( HDF5_BUILD_HL_LIB )
set ( HDF5_C_HL_LIBRARIES "${HDF5_HL_LIBSH_TARGET}" )
endif ( )
2023-05-27 04:29:02 +08:00
set ( HDF5_MAX_EXTERNAL_VOLS 10 )
set ( HDF5_EXTERNAL_VOL_TARGETS "" )
foreach ( vol_idx RANGE 1 ${ HDF5_MAX_EXTERNAL_VOLS } )
# Generate fixed-width index number prepended with 0s
2023-09-02 05:01:37 +08:00
# so VOL sources come in order from 1 - HDF5_MAX_EXTERNAL_VOLS
2023-05-27 04:29:02 +08:00
set ( vol_idx_num_digits 2 ) # Based on HDF5_MAX_EXTERNAL_VOLS
set ( vol_idx_fixed "${vol_idx}" )
string ( LENGTH "${vol_idx_fixed}" vol_idx_len )
while ( vol_idx_len LESS vol_idx_num_digits )
string ( PREPEND vol_idx_fixed "0" )
math ( EXPR vol_idx_len "${vol_idx_len}+1" )
endwhile ( )
2023-09-02 05:01:37 +08:00
if ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "GIT" )
set ( HDF5_VOL_URL ${ vol_idx_fixed } "" CACHE STRING "Git repository URL of an external HDF5 VOL connector to build" )
mark_as_advanced ( HDF5_VOL_URL ${ vol_idx_fixed } )
set ( HDF5_VOL_SOURCE "${HDF5_VOL_URL${vol_idx_fixed}}" )
elseif ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "LOCAL_DIR" )
set ( HDF5_VOL_PATH ${ vol_idx_fixed } "" CACHE STRING "Path to the source directory of an external HDF5 VOL connector to build" )
mark_as_advanced ( HDF5_VOL_PATH ${ vol_idx_fixed } )
set ( HDF5_VOL_SOURCE "${HDF5_VOL_PATH${vol_idx_fixed}}" )
endif ( )
if ( NOT "${HDF5_VOL_SOURCE}" STREQUAL "" )
# Deal with trailing slash in path for LOCAL_DIR case
if ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "LOCAL_DIR" )
# Erase trailing slash
string ( REGEX REPLACE "/$" "" HDF5_VOL_SOURCE ${ HDF5_VOL_SOURCE } )
endif ( )
2023-05-27 04:29:02 +08:00
# Extract the name of the VOL connector
2023-09-02 05:01:37 +08:00
string ( FIND "${HDF5_VOL_SOURCE}" "/" hdf5_vol_name_pos REVERSE )
2023-05-27 04:29:02 +08:00
if ( hdf5_vol_name_pos EQUAL -1 )
2023-09-02 05:01:37 +08:00
if ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "GIT" )
message ( SEND_ERROR "Invalid URL '${HDF5_VOL_SOURCE}' specified for HDF5_VOL_URL${vol_idx_fixed}" )
elseif ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "LOCAL_DIR" )
message ( SEND_ERROR "Invalid source path '${HDF5_VOL_SOURCE}' specified for HDF5_VOL_PATH${vol_idx_fixed}" )
endif ( )
2023-05-27 04:29:02 +08:00
endif ( )
math ( EXPR hdf5_vol_name_pos "${hdf5_vol_name_pos}+1" )
2023-09-02 05:01:37 +08:00
string ( SUBSTRING "${HDF5_VOL_SOURCE}" ${ hdf5_vol_name_pos } -1 hdf5_vol_name )
2023-05-27 04:29:02 +08:00
string ( REPLACE ".git" "" hdf5_vol_name "${hdf5_vol_name}" )
string ( STRIP "${hdf5_vol_name}" hdf5_vol_name )
string ( TOUPPER "${hdf5_vol_name}" hdf5_vol_name_upper )
string ( TOLOWER "${hdf5_vol_name}" hdf5_vol_name_lower )
2023-09-02 05:01:37 +08:00
message ( VERBOSE "Building VOL connector '${hdf5_vol_name}' with FetchContent from source ${HDF5_VOL_SOURCE}" )
2023-05-27 04:29:02 +08:00
# Set some cache variables that can be set by users when building
2023-09-02 05:01:37 +08:00
if ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "GIT" )
set ( "HDF5_VOL_${hdf5_vol_name_upper}_BRANCH" "main" CACHE STRING "Git branch (or tag) to use when building VOL connector '${hdf5_vol_name}'" )
mark_as_advanced ( "HDF5_VOL_${hdf5_vol_name_upper}_BRANCH" )
endif ( )
2023-05-27 04:29:02 +08:00
set ( "HDF5_VOL_${hdf5_vol_name_upper}_NAME" "" CACHE STRING "Name of VOL connector to set for the HDF5_VOL_CONNECTOR environment variable" )
option ( "HDF5_VOL_${hdf5_vol_name_upper}_TEST_PARALLEL" "Whether to test VOL connector '${hdf5_vol_name}' against the parallel API tests" OFF )
mark_as_advanced ( "HDF5_VOL_${hdf5_vol_name_upper}_NAME" )
mark_as_advanced ( "HDF5_VOL_${hdf5_vol_name_upper}_TEST_PARALLEL" )
if ( HDF5_TEST_API )
if ( "${HDF5_VOL_${hdf5_vol_name_upper}_NAME}" STREQUAL "" )
message ( SEND_ERROR "HDF5_VOL_${hdf5_vol_name_upper}_NAME must be set to a valid connector name to use VOL connector '${hdf5_vol_name}' for testing" )
endif ( )
endif ( )
2023-09-02 05:01:37 +08:00
if ( ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "GIT" ) AND ( "${HDF5_VOL_${hdf5_vol_name_upper}_BRANCH}" STREQUAL "" ) )
2023-05-27 04:29:02 +08:00
message ( SEND_ERROR "HDF5_VOL_${hdf5_vol_name_upper}_BRANCH must be set to a valid git branch name (or git tag) to build VOL connector '${hdf5_vol_name}'" )
endif ( )
2023-09-02 05:01:37 +08:00
if ( ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "LOCAL_DIR" )
A N D NOT ( EXISTS ${ HDF5_VOL_SOURCE } AND IS_DIRECTORY ${ HDF5_VOL_SOURCE } ) )
message ( FATAL_ERROR "HDF5_VOL_PATH${vol_idx_fixed} must be an absolute path to a valid directory" )
endif ( )
if ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "GIT" )
FetchContent_Declare ( HDF5_VOL_ ${ hdf5_vol_name_lower }
G I T _ R E P O S I T O R Y " $ { H D F 5 _ V O L _ S O U R C E } "
2023-05-27 04:29:02 +08:00
G I T _ T A G " $ { H D F 5 _ V O L _ $ { h d f 5 _ v o l _ n a m e _ u p p e r } _ B R A N C H } "
2023-09-02 05:01:37 +08:00
)
elseif ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "LOCAL_DIR" )
FetchContent_Declare ( HDF5_VOL_ ${ hdf5_vol_name_lower }
S O U R C E _ D I R " $ { H D F 5 _ V O L _ S O U R C E } "
)
endif ( )
2023-05-27 04:29:02 +08:00
FetchContent_GetProperties ( HDF5_VOL_ ${ hdf5_vol_name_lower } )
if ( NOT hdf5_vol_ ${ hdf5_vol_name_lower } _POPULATED )
FetchContent_Populate ( HDF5_VOL_ ${ hdf5_vol_name_lower } )
if ( NOT EXISTS "${hdf5_vol_${hdf5_vol_name_lower}_SOURCE_DIR}/CMakeLists.txt" )
2023-09-02 05:01:37 +08:00
if ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "GIT" )
message ( SEND_ERROR "The git repository branch '${HDF5_VOL_${hdf5_vol_name_upper}_BRANCH}' for VOL connector '${hdf5_vol_name}' does not appear to contain a CMakeLists.txt file" )
elseif ( HDF5_VOL_ALLOW_EXTERNAL MATCHES "LOCAL_DIR" )
message ( SEND_ERROR "The local directory '${HDF5_VOL_SOURCE}' for VOL connector '${hdf5_vol_name}' does not appear to contain a CMakeLists.txt file" )
endif ( )
2023-05-27 04:29:02 +08:00
endif ( )
# If there are any calls to find_package(HDF5) in the connector's
# CMakeLists.txt files, remove those since any found HDF5 targets
# will conflict with targets being generated by this build of HDF5
if ( EXISTS "${hdf5_vol_${hdf5_vol_name_lower}_SOURCE_DIR}/CMakeLists.txt" )
file ( READ "${hdf5_vol_${hdf5_vol_name_lower}_SOURCE_DIR}/CMakeLists.txt" vol_cmake_contents )
string ( REGEX REPLACE "[ \t]*find_package[ \t]*\\([ \t]*HDF5[^\r\n\\)]*\\)[ \t]*[\r\n]+" "" vol_cmake_contents "${vol_cmake_contents}" )
file ( WRITE "${hdf5_vol_${hdf5_vol_name_lower}_SOURCE_DIR}/CMakeLists.txt" "${vol_cmake_contents}" )
endif ( )
if ( EXISTS "${hdf5_vol_${hdf5_vol_name_lower}_SOURCE_DIR}/src/CMakeLists.txt" )
file ( READ "${hdf5_vol_${hdf5_vol_name_lower}_SOURCE_DIR}/src/CMakeLists.txt" vol_cmake_contents )
string ( REGEX REPLACE "[ \t]*find_package[ \t]*\\([ \t]*HDF5[^\r\n\\)]*\\)[ \t]*[\r\n]+" "" vol_cmake_contents "${vol_cmake_contents}" )
file ( WRITE "${hdf5_vol_${hdf5_vol_name_lower}_SOURCE_DIR}/src/CMakeLists.txt" "${vol_cmake_contents}" )
endif ( )
add_subdirectory ( ${ hdf5_vol_${hdf5_vol_name_lower } _SOURCE_DIR} ${ hdf5_vol_${hdf5_vol_name_lower } _BINARY_DIR} )
# Get list of targets generated by build of connector
get_generated_cmake_targets ( connector_targets ${ hdf5_vol_${hdf5_vol_name_lower } _SOURCE_DIR} )
# Create a custom target for the connector to encompass all its
# targets and other custom properties set by us for later use
add_custom_target ( "HDF5_VOL_${hdf5_vol_name_lower}" )
# Define and set a custom property on the VOL connector target to
# capture all of the connector's generated targets
define_property (
T A R G E T
P R O P E R T Y H D F 5 _ V O L _ T A R G E T S
2023-08-31 11:23:59 +08:00
B R I E F _ D O C S " G e n e r a t e d t a r g e t s o f t h i s c o n n e c t o r "
F U L L _ D O C S " G e n e r a t e d t a r g e t s o f t h i s c o n n e c t o r "
2023-05-27 04:29:02 +08:00
)
set_target_properties (
" H D F 5 _ V O L _ $ { h d f 5 _ v o l _ n a m e _ l o w e r } "
P R O P E R T I E S
H D F 5 _ V O L _ T A R G E T S " $ { c o n n e c t o r _ t a r g e t s } "
)
# Define and set a custom property on the VOL connector target to
# capture the connector's name to set for the HDF5_VOL_CONNECTOR
# environment variable for testing
define_property (
T A R G E T
P R O P E R T Y H D F 5 _ V O L _ N A M E
B R I E F _ D O C S " V O L c o n n e c t o r n a m e t o u s e f o r t h e H D F 5 _ V O L _ C O N N E C T O R e n v i r o n m e n t v a r i a b l e w h e n t e s t i n g "
2023-08-31 11:23:59 +08:00
F U L L _ D O C S " V O L c o n n e c t o r n a m e t o u s e f o r t h e H D F 5 _ V O L _ C O N N E C T O R e n v i r o n m e n t v a r i a b l e w h e n t e s t i n g "
2023-05-27 04:29:02 +08:00
)
set_target_properties (
" H D F 5 _ V O L _ $ { h d f 5 _ v o l _ n a m e _ l o w e r } "
P R O P E R T I E S
H D F 5 _ V O L _ N A M E " $ { H D F 5 _ V O L _ $ { h d f 5 _ v o l _ n a m e _ u p p e r } _ N A M E } "
)
# Define and set a custom property on the VOL connector target to
# capture whether the connector should be tested with the parallel
# API tests
define_property (
T A R G E T
P R O P E R T Y H D F 5 _ V O L _ T E S T _ P A R A L L E L
B R I E F _ D O C S " W h e t h e r t h e V O L c o n n e c t o r s h o u l d b e t e s t e d w i t h t h e p a r a l l e l A P I t e s t s "
2023-08-31 11:23:59 +08:00
F U L L _ D O C S " W h e t h e r t h e V O L c o n n e c t o r s h o u l d b e t e s t e d w i t h t h e p a r a l l e l A P I t e s t s "
2023-05-27 04:29:02 +08:00
)
set_target_properties (
" H D F 5 _ V O L _ $ { h d f 5 _ v o l _ n a m e _ l o w e r } "
P R O P E R T I E S
H D F 5 _ V O L _ T E S T _ P A R A L L E L $ { H D F 5 _ V O L _ $ { h d f 5 _ v o l _ n a m e _ u p p e r } _ T E S T _ P A R A L L E L }
)
# Add this connector's target to the list of external connector targets
list ( APPEND HDF5_EXTERNAL_VOL_TARGETS "HDF5_VOL_${hdf5_vol_name_lower}" )
endif ( )
endif ( )
endforeach ( )
endif ( )
