## # vcpkg_from_gitlab ## ## Download and extract a project from Gitlab instances. Enables support for `install --head`. ## ## ## Usage: ## ```cmake ## vcpkg_from_gitlab( ## GITLAB_URL ## OUT_SOURCE_PATH ## REPO ## [REF ] ## [SHA512 <45d0d7f8cc350...>] ## [HEAD_REF ] ## ) ## ``` ## ## ## Parameters: ## ## ### GITLAB_URL ## The URL of the Gitlab instance to use. ## ## ### OUT_SOURCE_PATH ## Specifies the out-variable that will contain the extracted location. ## ## This should be set to `SOURCE_PATH` by convention. ## ## ### REPO ## The organization or user plus the repository name on the Gitlab instance. ## ## ### REF ## A stable git commit-ish (ideally a tag) that will not change contents. **This should not be a branch.** ## ## For repositories without official releases, this can be set to the full commit id of the current latest master. ## ## If `REF` is specified, `SHA512` must also be specified. ## ## ### SHA512 ## The SHA512 hash that should match the archive (${GITLAB_URL}/${REPO}/-/archive/${REF}/${REPO_NAME}-${REF}.tar.gz). ## The REPO_NAME variable is parsed from the value of REPO. ## ## This is most easily determined by first setting it to `1`, then trying to build the port. The error message will contain the full hash, which can be copied back into the portfile. ## ## ### HEAD_REF ## The unstable git commit-ish (ideally a branch) to pull for `--head` builds. ## ## For most projects, this should be `master`. The chosen branch should be one that is expected to be always buildable on all supported platforms. ## ## ## Notes: ## At least one of `REF` and `HEAD_REF` must be specified, however it is preferable for both to be present. ## ## This exports the `VCPKG_HEAD_VERSION` variable during head builds. ## function(vcpkg_from_gitlab) set(oneValueArgs OUT_SOURCE_PATH GITLAB_URL USER REPO REF SHA512 HEAD_REF) set(multipleValuesArgs PATCHES) cmake_parse_arguments(_vdud "" "${oneValueArgs}" "${multipleValuesArgs}" ${ARGN}) if(NOT DEFINED _vdud_GITLAB_URL) message(FATAL_ERROR "GITLAB_URL must be specified.") endif() if(NOT DEFINED _vdud_OUT_SOURCE_PATH) message(FATAL_ERROR "OUT_SOURCE_PATH must be specified.") endif() if((DEFINED _vdud_REF AND NOT DEFINED _vdud_SHA512) OR (NOT DEFINED _vdud_REF AND DEFINED _vdud_SHA512)) message(FATAL_ERROR "SHA512 must be specified if REF is specified.") endif() if(NOT DEFINED _vdud_REPO) message(FATAL_ERROR "REPO must be specified.") endif() if(NOT DEFINED _vdud_REF AND NOT DEFINED _vdud_HEAD_REF) message(FATAL_ERROR "At least one of REF and HEAD_REF must be specified.") endif() string(REGEX REPLACE ".*/" "" REPO_NAME ${_vdud_REPO}) string(REGEX REPLACE "/.*" "" ORG_NAME ${_vdud_REPO}) macro(set_TEMP_SOURCE_PATH BASE) file(GLOB _ARCHIVE_FILES "${BASE}/${REPO_NAME}*") foreach(dir ${_ARCHIVE_FILES}) if (IS_DIRECTORY ${dir}) list(APPEND _ARCHIVE_DIRS "${dir}") endif() endforeach() list(LENGTH _ARCHIVE_DIRS _NUM_ARCHIVE_DIRS) if(NOT 1 EQUAL ${_NUM_ARCHIVE_DIRS}) message(FATAL_ERROR "Could not determine source path: There were ${_NUM_ARCHIVE_DIRS} directories extracted from the archive that start with the repo name.") endif() list(GET _ARCHIVE_DIRS 0 TEMP_SOURCE_PATH) endmacro() if(VCPKG_USE_HEAD_VERSION AND NOT DEFINED _vdud_HEAD_REF) message(STATUS "Package does not specify HEAD_REF. Falling back to non-HEAD version.") set(VCPKG_USE_HEAD_VERSION OFF) endif() # Handle --no-head scenarios if(NOT VCPKG_USE_HEAD_VERSION) if(NOT _vdud_REF) message(FATAL_ERROR "Package does not specify REF. It must built using --head.") endif() string(REPLACE "/" "-" SANITIZED_REF "${_vdud_REF}") vcpkg_download_distfile(ARCHIVE URLS "${_vdud_GITLAB_URL}/${ORG_NAME}/${REPO_NAME}/-/archive/${_vdud_REF}/${REPO_NAME}-${_vdud_REF}.tar.gz" SHA512 "${_vdud_SHA512}" FILENAME "${ORG_NAME}-${REPO_NAME}-${SANITIZED_REF}.tar.gz" ) # Take the last 10 chars of the REF set(REF_MAX_LENGTH 10) string(LENGTH ${SANITIZED_REF} REF_LENGTH) math(EXPR FROM_REF ${REF_LENGTH}-${REF_MAX_LENGTH}) if(FROM_REF LESS 0) set(FROM_REF 0) endif() string(SUBSTRING ${SANITIZED_REF} ${FROM_REF} ${REF_LENGTH} SHORTENED_SANITIZED_REF) # Hash the archive hash along with the patches. Take the first 10 chars of the hash set(PATCHSET_HASH "${_vdud_SHA512}") foreach(PATCH IN LISTS _vdud_PATCHES) file(SHA512 ${PATCH} CURRENT_HASH) string(APPEND PATCHSET_HASH ${CURRENT_HASH}) endforeach() string(SHA512 PATCHSET_HASH ${PATCHSET_HASH}) string(SUBSTRING ${PATCHSET_HASH} 0 10 PATCHSET_HASH) set(SOURCE_PATH "${CURRENT_BUILDTREES_DIR}/src/${SHORTENED_SANITIZED_REF}-${PATCHSET_HASH}") if(NOT EXISTS ${SOURCE_PATH}) set(TEMP_DIR "${CURRENT_BUILDTREES_DIR}/src/TEMP") file(REMOVE_RECURSE ${TEMP_DIR}) vcpkg_extract_source_archive_ex(ARCHIVE "${ARCHIVE}" WORKING_DIRECTORY ${TEMP_DIR}) set_TEMP_SOURCE_PATH(${CURRENT_BUILDTREES_DIR}/src/TEMP ${SANITIZED_REF}) vcpkg_apply_patches( SOURCE_PATH ${TEMP_SOURCE_PATH} PATCHES ${_vdud_PATCHES} ) file(RENAME ${TEMP_SOURCE_PATH} ${SOURCE_PATH}) file(REMOVE_RECURSE ${TEMP_DIR}) endif() set(${_vdud_OUT_SOURCE_PATH} "${SOURCE_PATH}" PARENT_SCOPE) return() endif() # The following is for --head scenarios set(URL "${_vdud_GITLAB_URL}/${ORG_NAME}/${REPO_NAME}/-/archive/${_vdud_HEAD_REF}/${_vdud_HEAD_REF}.tar.gz") string(REPLACE "/" "-" SANITIZED_HEAD_REF "${_vdud_HEAD_REF}") set(downloaded_file_name "${ORG_NAME}-${REPO_NAME}-${SANITIZED_HEAD_REF}.tar.gz") set(downloaded_file_path "${DOWNLOADS}/${downloaded_file_name}") if(_VCPKG_NO_DOWNLOADS) if(NOT EXISTS ${downloaded_file_path} OR NOT EXISTS ${downloaded_file_path}.version) message(FATAL_ERROR "Downloads are disabled, but '${downloaded_file_path}' does not exist.") endif() message(STATUS "Using cached ${downloaded_file_path}") else() if(EXISTS ${downloaded_file_path}) message(STATUS "Purging cached ${downloaded_file_path} to fetch latest (use --no-downloads to suppress)") file(REMOVE ${downloaded_file_path}) endif() if(EXISTS ${downloaded_file_path}.version) file(REMOVE ${downloaded_file_path}.version) endif() if(EXISTS ${CURRENT_BUILDTREES_DIR}/src/head) file(REMOVE_RECURSE ${CURRENT_BUILDTREES_DIR}/src/head) endif() vcpkg_download_distfile(ARCHIVE URLS ${URL} FILENAME ${downloaded_file_name} SKIP_SHA512 ) endif() vcpkg_extract_source_archive_ex( ARCHIVE "${ARCHIVE}" WORKING_DIRECTORY "${CURRENT_BUILDTREES_DIR}/src/head" ) # There are issues with the Gitlab API project paths being URL-escaped, so we use git here to get the head revision execute_process(COMMAND ${GIT} ls-remote "${_vdud_GITLAB_URL}/${ORG_NAME}/${REPO_NAME}.git" "${_vdud_HEAD_REF}" RESULT_VARIABLE _git_result OUTPUT_VARIABLE _git_output ) string(REGEX MATCH "[a-f0-9]+" _version "${_git_output}") # exports VCPKG_HEAD_VERSION to the caller. This will get picked up by ports.cmake after the build. # When multiple vcpkg_from_gitlab's are used after each other, only use the version from the first (hopefully the primary one). if(NOT DEFINED VCPKG_HEAD_VERSION) set(VCPKG_HEAD_VERSION ${_version} PARENT_SCOPE) endif() set_TEMP_SOURCE_PATH(${CURRENT_BUILDTREES_DIR}/src/head ${SANITIZED_HEAD_REF}) vcpkg_apply_patches( SOURCE_PATH ${TEMP_SOURCE_PATH} PATCHES ${_vdud_PATCHES} ) set(${_vdud_OUT_SOURCE_PATH} "${TEMP_SOURCE_PATH}" PARENT_SCOPE) endfunction()