710bc2d90e
The QtSynchronizeRepo.cmake script, which is meant to be driven by a
git-sync-to script, has been rewritten to support more use cases, as
well as improve the code readability and error reporting.
The script now supports the following additional use cases:
- Clone a specified qt/{repo} submodule from code.qt.io into the
current directory, and initialize (clone) its dependencies
- Initialize a submodule and its dependencies in an existing qt5.git
super repo. This is similar to what init-repository does, except
instead of using the qt5.git sha1s, it uses the dependencies.yaml
of the specified submodule
- Support for git fetch --depth, to allow shallow cloning of the
specified submodule and its dependencies. This is useful for CI
where only a specific revision needs to be checked out.
The main incentive for this change is allow cloning qttools/dev/HEAD
and its dependencies in a CI run, but it's useful for daily work as
well. At some point we should check what can be merged together with
the existing init-repository script.
Pick-to: 6.8
Task-number: QTBUG-128730
Change-Id: Ie6d49d253223cc93b8831ef41d25e0adeac39b8b
Reviewed-by: Joerg Bornemann <joerg.bornemann@qt.io>
65 lines
1.9 KiB
CMake
65 lines
1.9 KiB
CMake
# Copyright (C) 2024 The Qt Company Ltd.
|
|
# SPDX-License-Identifier: BSD-3-Clause
|
|
|
|
# This script is to be called (ideally from a git-sync-to alias script):
|
|
# cmake -DSYNC_TO_MODULE="$1" -DSYNC_TO_BRANCH="$2" -P cmake/QtSynchronizeRepo.cmake
|
|
|
|
# Or as follows (ideally from a git-qt-foreach alias script):
|
|
# cmake -DQT_FOREACH=TRUE "-DARGS=$*" -P cmake/QtSynchronizeRepo.cmake
|
|
#
|
|
# The script can take additional options.
|
|
#
|
|
# SYNC_REF_SPEC - an alias for SYNC_TO_BRANCH, can be a tag, branch or commit sha1.
|
|
#
|
|
# REMOTE_NAME - remote name to use for fetching, default is origin.
|
|
#
|
|
# GIT_DEPTH - corresponds to git's --depth option, will be passed to git clone and git submodule
|
|
# update --init operations.
|
|
#
|
|
# SHOW_PROGRESS - passes --progress to git submodule update operations
|
|
#
|
|
# VERBOSE - enables more verbose output
|
|
#
|
|
# The script also takes the following environment variables:
|
|
#
|
|
# QT_TL_SUBMODULE_UPDATE_FLAGS - additional flags to pass to git submodule update calls.
|
|
#
|
|
# To run the script in full debug mode use:
|
|
# cmake -DSYNC_TO_MODULE="$1" -DSYNC_TO_BRANCH="$2" -DSHOW_PROGRESS=1 -DVERBOSE=1
|
|
# -P cmake/QtSynchronizeRepo.cmake --log-level=DEBUG --trace-redirect=log.txt --trace-expand
|
|
|
|
cmake_policy(VERSION 3.16)
|
|
include("${CMAKE_CURRENT_LIST_DIR}/QtTopLevelHelpers.cmake")
|
|
if(QT_FOREACH)
|
|
qt_internal_foreach_repo_run(ARGS ${ARGS})
|
|
else()
|
|
set(args "")
|
|
|
|
if(SYNC_REF_SPEC)
|
|
set(ref_spec "${SYNC_REF_SPEC}")
|
|
elseif(SYNC_TO_BRANCH)
|
|
set(ref_spec "${SYNC_TO_BRANCH}")
|
|
endif()
|
|
|
|
if(REMOTE_NAME)
|
|
list(APPEND args REMOTE_NAME "${REMOTE_NAME}")
|
|
endif()
|
|
|
|
if(GIT_DEPTH)
|
|
list(APPEND args GIT_DEPTH "${GIT_DEPTH}")
|
|
endif()
|
|
|
|
if(SHOW_PROGRESS)
|
|
list(APPEND args SHOW_PROGRESS)
|
|
endif()
|
|
|
|
if(VERBOSE)
|
|
list(APPEND args VERBOSE)
|
|
endif()
|
|
|
|
qt_internal_sync_to(${SYNC_TO_MODULE}
|
|
SYNC_REF ${ref_spec}
|
|
${args}
|
|
)
|
|
endif()
|