You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
472 lines
14 KiB
472 lines
14 KiB
# Copyright 1999-2013 Gentoo Foundation
|
|
# Distributed under the terms of the GNU General Public License v2
|
|
# $Header: /var/cvsroot/gentoo-x86/eclass/git.eclass,v 1.60 2013/01/15 11:23:43 jlec Exp $
|
|
|
|
# @DEPRECATED
|
|
# This eclass has been superseded by git-2 eclass.
|
|
# Please modify your ebuilds to use that one instead.
|
|
|
|
# @ECLASS: git.eclass
|
|
# @MAINTAINER:
|
|
# Donnie Berkholz <dberkholz@gentoo.org>
|
|
# @BLURB: Fetching and unpacking of git repositories
|
|
# @DESCRIPTION:
|
|
# The git eclass provides functions to fetch, patch and bootstrap
|
|
# software sources from git repositories and is based on the subversion eclass.
|
|
# It is necessary to define at least the EGIT_REPO_URI variable.
|
|
#
|
|
# THANKS TO:
|
|
# Fernando J. Pereda <ferdy@gentoo.org>
|
|
|
|
inherit eutils
|
|
|
|
EGIT="git.eclass"
|
|
|
|
# We DEPEND on a not too ancient git version
|
|
DEPEND=">=dev-vcs/git-1.6"
|
|
|
|
EXPORTED_FUNCTIONS="src_unpack"
|
|
case "${EAPI:-0}" in
|
|
2|3|4|5) EXPORTED_FUNCTIONS="${EXPORTED_FUNCTIONS} src_prepare" ;;
|
|
1|0) ;;
|
|
*) die "EAPI=${EAPI} is not supported" ;;
|
|
esac
|
|
EXPORT_FUNCTIONS ${EXPORTED_FUNCTIONS}
|
|
|
|
# define some nice defaults but only if nothing is set already
|
|
: ${HOMEPAGE:=http://git-scm.com/}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_QUIET
|
|
# @DESCRIPTION:
|
|
# Set to non-empty value to supress some eclass messages.
|
|
: ${EGIT_QUIET:=${ESCM_QUIET}}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_STORE_DIR
|
|
# @DESCRIPTION:
|
|
# Storage directory for git sources.
|
|
# Can be redefined.
|
|
: ${EGIT_STORE_DIR:="${PORTAGE_ACTUAL_DISTDIR-${DISTDIR}}/git-src"}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_UNPACK_DIR
|
|
# @DESCRIPTION:
|
|
# Directory to unpack git sources in.
|
|
|
|
# @ECLASS-VARIABLE: EGIT_HAS_SUBMODULES
|
|
# @DESCRIPTION:
|
|
# Set this to non-empty value to enable submodule support (slower).
|
|
: ${EGIT_HAS_SUBMODULES:=}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_FETCH_CMD
|
|
# @DESCRIPTION:
|
|
# Command for cloning the repository.
|
|
: ${EGIT_FETCH_CMD:="git clone"}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_UPDATE_CMD
|
|
# @DESCRIPTION:
|
|
# Git fetch command.
|
|
if [[ -n ${EGIT_HAS_SUBMODULES} ]]; then
|
|
EGIT_UPDATE_CMD="git pull -f -u"
|
|
else
|
|
EGIT_UPDATE_CMD="git fetch -f -u"
|
|
fi
|
|
|
|
# @ECLASS-VARIABLE: EGIT_DIFFSTAT_CMD
|
|
# @DESCRIPTION:
|
|
# Git command for diffstat.
|
|
EGIT_DIFFSTAT_CMD="git --no-pager diff --stat"
|
|
|
|
# @ECLASS-VARIABLE: EGIT_OPTIONS
|
|
# @DESCRIPTION:
|
|
# This variable value is passed to clone and fetch.
|
|
: ${EGIT_OPTIONS:=}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_MASTER
|
|
# @DESCRIPTION:
|
|
# Variable for specifying master branch.
|
|
# Usefull when upstream don't have master branch.
|
|
: ${EGIT_MASTER:=master}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_REPO_URI
|
|
# @DESCRIPTION:
|
|
# URI for the repository
|
|
# e.g. http://foo, git://bar
|
|
# Supported protocols:
|
|
# http://
|
|
# https://
|
|
# git://
|
|
# git+ssh://
|
|
# rsync://
|
|
# ssh://
|
|
eval X="\$${PN//[-+]/_}_LIVE_REPO"
|
|
if [[ ${X} = "" ]]; then
|
|
: ${EGIT_REPO_URI:=}
|
|
else
|
|
EGIT_REPO_URI="${X}"
|
|
fi
|
|
# @ECLASS-VARIABLE: EGIT_PROJECT
|
|
# @DESCRIPTION:
|
|
# Project name, it must be unique across EGIT_STORE_DIR.
|
|
# Git eclass will check out the git repository into ${EGIT_STORE_DIR}/${EGIT_PROJECT}/${EGIT_REPO_URI##*/}
|
|
# Default is ${PN}.
|
|
: ${EGIT_PROJECT:=${PN}}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_BOOTSTRAP
|
|
# @DESCRIPTION:
|
|
# bootstrap script or command like autogen.sh or etc...
|
|
: ${EGIT_BOOTSTRAP:=}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_OFFLINE
|
|
# @DESCRIPTION:
|
|
# Set this variable to a non-empty value to disable the automatic updating of
|
|
# an GIT source tree. This is intended to be set outside the git source
|
|
# tree by users.
|
|
: ${EGIT_OFFLINE:=${ESCM_OFFLINE}}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_PATCHES
|
|
# @DESCRIPTION:
|
|
# Similar to PATCHES array from base.eclass
|
|
# Only difference is that this patches are applied before bootstrap.
|
|
# Please take note that this variable should be bash array.
|
|
|
|
# @ECLASS-VARIABLE: EGIT_BRANCH
|
|
# @DESCRIPTION:
|
|
# git eclass can fetch any branch in git_fetch().
|
|
eval X="\$${PN//[-+]/_}_LIVE_BRANCH"
|
|
if [[ "${X}" = "" ]]; then
|
|
: ${EGIT_BRANCH:=master}
|
|
else
|
|
EGIT_BRANCH="${X}"
|
|
fi
|
|
|
|
# @ECLASS-VARIABLE: EGIT_COMMIT
|
|
# @DESCRIPTION:
|
|
# git eclass can checkout any commit.
|
|
eval X="\$${PN//[-+]/_}_LIVE_COMMIT"
|
|
if [[ "${X}" = "" ]]; then
|
|
: ${EGIT_COMMIT:=${EGIT_BRANCH}}
|
|
else
|
|
EGIT_COMMIT="${X}"
|
|
fi
|
|
|
|
# @ECLASS-VARIABLE: EGIT_REPACK
|
|
# @DESCRIPTION:
|
|
# Set to non-empty value to repack objects to save disk space. However this can
|
|
# take a long time with VERY big repositories.
|
|
: ${EGIT_REPACK:=}
|
|
|
|
# @ECLASS-VARIABLE: EGIT_PRUNE
|
|
# @DESCRIPTION:
|
|
# Set to non-empty value to prune loose objects on each fetch. This is useful
|
|
# if upstream rewinds and rebases branches often.
|
|
: ${EGIT_PRUNE:=}
|
|
|
|
# @FUNCTION: git_submodules
|
|
# @DESCRIPTION:
|
|
# Internal function wrapping the submodule initialisation and update
|
|
git_submodules() {
|
|
if [[ -n ${EGIT_HAS_SUBMODULES} ]]; then
|
|
debug-print "git submodule init"
|
|
git submodule init
|
|
debug-print "git submodule sync"
|
|
git submodule sync
|
|
debug-print "git submodule update"
|
|
git submodule update
|
|
fi
|
|
}
|
|
|
|
# @FUNCTION: git_branch
|
|
# @DESCRIPTION:
|
|
# Internal function that changes branch for the repo based on EGIT_TREE and
|
|
# EGIT_BRANCH variables.
|
|
git_branch() {
|
|
local branchname=branch-${EGIT_BRANCH} src=origin/${EGIT_BRANCH}
|
|
if [[ "${EGIT_COMMIT}" != "${EGIT_BRANCH}" ]]; then
|
|
branchname=tree-${EGIT_COMMIT}
|
|
src=${EGIT_COMMIT}
|
|
fi
|
|
debug-print "git checkout -b ${branchname} ${src}"
|
|
git checkout -b ${branchname} ${src} &> /dev/null
|
|
|
|
unset branchname src
|
|
}
|
|
|
|
# @FUNCTION: git_fetch
|
|
# @DESCRIPTION:
|
|
# Gets repository from EGIT_REPO_URI and store it in specified EGIT_STORE_DIR
|
|
git_fetch() {
|
|
debug-print-function ${FUNCNAME} "$@"
|
|
|
|
eqawarn "git.eclass is deprecated."
|
|
eqawarn "Please update your ebuilds to use git-2 instead. For details, see"
|
|
eqawarn "http://archives.gentoo.org/gentoo-dev/msg_b7ba363cae580845819ae3501fb157e9.xml"
|
|
|
|
local GIT_DIR EGIT_CLONE_DIR oldsha1 cursha1 extra_clone_opts upstream_branch
|
|
[[ -z ${EGIT_HAS_SUBMODULES} ]] && export GIT_DIR
|
|
|
|
# choose if user wants elog or just einfo.
|
|
if [[ -n ${EGIT_QUIET} ]]; then
|
|
elogcmd="einfo"
|
|
else
|
|
elogcmd="elog"
|
|
fi
|
|
|
|
# If we have same branch and the tree we can do --depth 1 clone
|
|
# which outputs into really smaller data transfers.
|
|
# Sadly we can do shallow copy for now because quite a few packages need .git
|
|
# folder.
|
|
#[[ ${EGIT_COMMIT} = ${EGIT_BRANCH} ]] && \
|
|
# EGIT_FETCH_CMD="${EGIT_FETCH_CMD} --depth 1"
|
|
if [[ -n ${EGIT_TREE} ]] ; then
|
|
EGIT_COMMIT=${EGIT_TREE}
|
|
ewarn "QA: Usage of deprecated EGIT_TREE variable detected."
|
|
ewarn "QA: Use EGIT_COMMIT variable instead."
|
|
fi
|
|
|
|
# EGIT_REPO_URI is empty.
|
|
[[ -z ${EGIT_REPO_URI} ]] && die "${EGIT}: EGIT_REPO_URI is empty."
|
|
|
|
# check for the protocol or pull from a local repo.
|
|
if [[ -z ${EGIT_REPO_URI%%:*} ]] ; then
|
|
case ${EGIT_REPO_URI%%:*} in
|
|
git*|http|https|rsync|ssh) ;;
|
|
*) die "${EGIT}: protocol for fetch from "${EGIT_REPO_URI%:*}" is not yet implemented in eclass." ;;
|
|
esac
|
|
fi
|
|
|
|
# initial clone, we have to create master git storage directory and play
|
|
# nicely with sandbox
|
|
if [[ ! -d ${EGIT_STORE_DIR} ]] ; then
|
|
debug-print "${FUNCNAME}: initial clone. creating git directory"
|
|
addwrite /
|
|
mkdir -m 775 -p "${EGIT_STORE_DIR}" \
|
|
|| die "${EGIT}: can't mkdir ${EGIT_STORE_DIR}."
|
|
export SANDBOX_WRITE="${SANDBOX_WRITE%%:/}"
|
|
fi
|
|
|
|
cd -P "${EGIT_STORE_DIR}" || die "${EGIT}: can't chdir to ${EGIT_STORE_DIR}"
|
|
EGIT_STORE_DIR=${PWD}
|
|
|
|
# allow writing into EGIT_STORE_DIR
|
|
addwrite "${EGIT_STORE_DIR}"
|
|
|
|
[[ -z ${EGIT_REPO_URI##*/} ]] && EGIT_REPO_URI="${EGIT_REPO_URI%/}"
|
|
EGIT_CLONE_DIR="${EGIT_PROJECT}"
|
|
|
|
debug-print "${FUNCNAME}: EGIT_OPTIONS = \"${EGIT_OPTIONS}\""
|
|
|
|
GIT_DIR="${EGIT_STORE_DIR}/${EGIT_CLONE_DIR}"
|
|
# we also have to remove all shallow copied repositories
|
|
# and fetch them again
|
|
if [[ -e "${GIT_DIR}/shallow" ]]; then
|
|
rm -rf "${GIT_DIR}"
|
|
einfo "The ${EGIT_CLONE_DIR} was shallow copy. Refetching."
|
|
fi
|
|
# repack from bare copy to normal one
|
|
if [[ -n ${EGIT_HAS_SUBMODULES} ]] && [[ -d ${GIT_DIR} && ! -d ${GIT_DIR}/.git ]]; then
|
|
rm -rf "${GIT_DIR}"
|
|
einfo "The ${EGIT_CLONE_DIR} was bare copy. Refetching."
|
|
fi
|
|
if [[ -z ${EGIT_HAS_SUBMODULES} ]] && [[ -d ${GIT_DIR} && -d ${GIT_DIR}/.git ]]; then
|
|
rm -rf "${GIT_DIR}"
|
|
einfo "The ${EGIT_CLONE_DIR} was not a bare copy. Refetching."
|
|
fi
|
|
|
|
if [[ -n ${EGIT_HAS_SUBMODULES} ]]; then
|
|
upstream_branch=origin/${EGIT_BRANCH}
|
|
else
|
|
upstream_branch=${EGIT_BRANCH}
|
|
extra_clone_opts=--bare
|
|
fi
|
|
|
|
if [[ ! -d ${GIT_DIR} ]] ; then
|
|
# first clone
|
|
${elogcmd} "GIT NEW clone -->"
|
|
${elogcmd} " repository: ${EGIT_REPO_URI}"
|
|
|
|
debug-print "${EGIT_FETCH_CMD} ${extra_clone_opts} ${EGIT_OPTIONS} \"${EGIT_REPO_URI}\" ${GIT_DIR}"
|
|
${EGIT_FETCH_CMD} ${extra_clone_opts} ${EGIT_OPTIONS} "${EGIT_REPO_URI}" ${GIT_DIR} \
|
|
|| die "${EGIT}: can't fetch from ${EGIT_REPO_URI}."
|
|
|
|
pushd "${GIT_DIR}" &> /dev/null
|
|
cursha1=$(git rev-parse ${upstream_branch})
|
|
${elogcmd} " at the commit: ${cursha1}"
|
|
|
|
git_submodules
|
|
popd &> /dev/null
|
|
elif [[ -n ${EGIT_OFFLINE} ]] ; then
|
|
pushd "${GIT_DIR}" &> /dev/null
|
|
cursha1=$(git rev-parse ${upstream_branch})
|
|
${elogcmd} "GIT offline update -->"
|
|
${elogcmd} " repository: ${EGIT_REPO_URI}"
|
|
${elogcmd} " at the commit: ${cursha1}"
|
|
popd &> /dev/null
|
|
else
|
|
pushd "${GIT_DIR}" &> /dev/null
|
|
# Git urls might change, so unconditionally set it here
|
|
git config remote.origin.url "${EGIT_REPO_URI}"
|
|
|
|
# fetch updates
|
|
${elogcmd} "GIT update -->"
|
|
${elogcmd} " repository: ${EGIT_REPO_URI}"
|
|
|
|
oldsha1=$(git rev-parse ${upstream_branch})
|
|
|
|
if [[ -n ${EGIT_HAS_SUBMODULES} ]]; then
|
|
debug-print "${EGIT_UPDATE_CMD} ${EGIT_OPTIONS}"
|
|
# fix branching
|
|
git checkout ${EGIT_MASTER}
|
|
for x in $(git branch |grep -v "* ${EGIT_MASTER}" |tr '\n' ' '); do
|
|
git branch -D ${x}
|
|
done
|
|
${EGIT_UPDATE_CMD} ${EGIT_OPTIONS} \
|
|
|| die "${EGIT}: can't update from ${EGIT_REPO_URI}."
|
|
else
|
|
debug-print "${EGIT_UPDATE_CMD} ${EGIT_OPTIONS} origin ${EGIT_BRANCH}:${EGIT_BRANCH}"
|
|
${EGIT_UPDATE_CMD} ${EGIT_OPTIONS} origin ${EGIT_BRANCH}:${EGIT_BRANCH} \
|
|
|| die "${EGIT}: can't update from ${EGIT_REPO_URI}."
|
|
fi
|
|
|
|
git_submodules
|
|
cursha1=$(git rev-parse ${upstream_branch})
|
|
|
|
# write out message based on the revisions
|
|
if [[ "${oldsha1}" != "${cursha1}" ]]; then
|
|
${elogcmd} " updating from commit: ${oldsha1}"
|
|
${elogcmd} " to commit: ${cursha1}"
|
|
else
|
|
${elogcmd} " at the commit: ${cursha1}"
|
|
# @ECLASS-VARIABLE: LIVE_FAIL_FETCH_IF_REPO_NOT_UPDATED
|
|
# @DESCRIPTION:
|
|
# If this variable is set to TRUE in make.conf or somewhere in
|
|
# enviroment the package will fail if there is no update, thus in
|
|
# combination with --keep-going it would lead in not-updating
|
|
# pakcages that are up-to-date.
|
|
# TODO: this can lead to issues if more projects/packages use same repo
|
|
[[ ${LIVE_FAIL_FETCH_IF_REPO_NOT_UPDATED} = true ]] && \
|
|
debug-print "${FUNCNAME}: Repository \"${EGIT_REPO_URI}\" is up-to-date. Skipping." && \
|
|
die "${EGIT}: Repository \"${EGIT_REPO_URI}\" is up-to-date. Skipping."
|
|
fi
|
|
${EGIT_DIFFSTAT_CMD} ${oldsha1}..${upstream_branch}
|
|
popd &> /dev/null
|
|
fi
|
|
|
|
pushd "${GIT_DIR}" &> /dev/null
|
|
if [[ -n ${EGIT_REPACK} ]] || [[ -n ${EGIT_PRUNE} ]]; then
|
|
ebegin "Garbage collecting the repository"
|
|
local args
|
|
[[ -n ${EGIT_PRUNE} ]] && args='--prune'
|
|
git gc ${args}
|
|
eend $?
|
|
fi
|
|
popd &> /dev/null
|
|
|
|
# export the git version
|
|
export EGIT_VERSION="${cursha1}"
|
|
|
|
# log the repo state
|
|
[[ "${EGIT_COMMIT}" != "${EGIT_BRANCH}" ]] && ${elogcmd} " commit: ${EGIT_COMMIT}"
|
|
${elogcmd} " branch: ${EGIT_BRANCH}"
|
|
${elogcmd} " storage directory: \"${GIT_DIR}\""
|
|
|
|
if [[ -n ${EGIT_HAS_SUBMODULES} ]]; then
|
|
pushd "${GIT_DIR}" &> /dev/null
|
|
debug-print "rsync -rlpgo . \"${EGIT_UNPACK_DIR:-${S}}\""
|
|
time rsync -rlpgo . "${EGIT_UNPACK_DIR:-${S}}"
|
|
popd &> /dev/null
|
|
else
|
|
unset GIT_DIR
|
|
debug-print "git clone -l -s -n \"${EGIT_STORE_DIR}/${EGIT_CLONE_DIR}\" \"${EGIT_UNPACK_DIR:-${S}}\""
|
|
git clone -l -s -n "${EGIT_STORE_DIR}/${EGIT_CLONE_DIR}" "${EGIT_UNPACK_DIR:-${S}}"
|
|
fi
|
|
|
|
pushd "${EGIT_UNPACK_DIR:-${S}}" &> /dev/null
|
|
git_branch
|
|
# submodules always reqire net (thanks to branches changing)
|
|
[[ -z ${EGIT_OFFLINE} ]] && git_submodules
|
|
popd &> /dev/null
|
|
|
|
echo ">>> Unpacked to ${EGIT_UNPACK_DIR:-${S}}"
|
|
}
|
|
|
|
# @FUNCTION: git_bootstrap
|
|
# @DESCRIPTION:
|
|
# Runs bootstrap command if EGIT_BOOTSTRAP variable contains some value
|
|
# Remember that what ever gets to the EGIT_BOOTSTRAP variable gets evaled by bash.
|
|
git_bootstrap() {
|
|
debug-print-function ${FUNCNAME} "$@"
|
|
|
|
if [[ -n ${EGIT_BOOTSTRAP} ]] ; then
|
|
pushd "${S}" > /dev/null
|
|
einfo "Starting bootstrap"
|
|
|
|
if [[ -f ${EGIT_BOOTSTRAP} ]]; then
|
|
# we have file in the repo which we should execute
|
|
debug-print "$FUNCNAME: bootstraping with file \"${EGIT_BOOTSTRAP}\""
|
|
|
|
if [[ -x ${EGIT_BOOTSTRAP} ]]; then
|
|
eval "./${EGIT_BOOTSTRAP}" \
|
|
|| die "${EGIT}: bootstrap script failed"
|
|
else
|
|
eerror "\"${EGIT_BOOTSTRAP}\" is not executable."
|
|
eerror "Report upstream, or bug ebuild maintainer to remove bootstrap command."
|
|
die "${EGIT}: \"${EGIT_BOOTSTRAP}\" is not executable."
|
|
fi
|
|
else
|
|
# we execute some system command
|
|
debug-print "$FUNCNAME: bootstraping with commands \"${EGIT_BOOTSTRAP}\""
|
|
|
|
eval "${EGIT_BOOTSTRAP}" \
|
|
|| die "${EGIT}: bootstrap commands failed."
|
|
|
|
fi
|
|
|
|
einfo "Bootstrap finished"
|
|
popd > /dev/null
|
|
fi
|
|
}
|
|
|
|
# @FUNCTION: git_apply_patches
|
|
# @DESCRIPTION:
|
|
# Apply patches from EGIT_PATCHES bash array.
|
|
# Preferred is using the variable as bash array but for now it allows to write
|
|
# it also as normal space separated string list. (This part of code should be
|
|
# removed when all ebuilds get converted on bash array).
|
|
git_apply_patches() {
|
|
debug-print-function ${FUNCNAME} "$@"
|
|
|
|
pushd "${EGIT_UNPACK_DIR:-${S}}" > /dev/null
|
|
if [[ ${#EGIT_PATCHES[@]} -gt 1 ]] ; then
|
|
for i in "${EGIT_PATCHES[@]}"; do
|
|
debug-print "$FUNCNAME: git_autopatch: patching from ${i}"
|
|
epatch "${i}"
|
|
done
|
|
elif [[ -n ${EGIT_PATCHES} ]]; then
|
|
# no need for loop if space separated string is passed.
|
|
debug-print "$FUNCNAME: git_autopatch: patching from ${EGIT_PATCHES}"
|
|
epatch "${EGIT_PATCHES}"
|
|
fi
|
|
|
|
popd > /dev/null
|
|
}
|
|
|
|
# @FUNCTION: git_src_unpack
|
|
# @DESCRIPTION:
|
|
# src_upack function, calls src_prepare one if EAPI!=2.
|
|
git_src_unpack() {
|
|
debug-print-function ${FUNCNAME} "$@"
|
|
|
|
git_fetch || die "${EGIT}: unknown problem in git_fetch()."
|
|
|
|
has src_prepare ${EXPORTED_FUNCTIONS} || git_src_prepare
|
|
}
|
|
|
|
# @FUNCTION: git_src_prepare
|
|
# @DESCRIPTION:
|
|
# src_prepare function for git stuff. Patches, bootstrap...
|
|
git_src_prepare() {
|
|
debug-print-function ${FUNCNAME} "$@"
|
|
|
|
git_apply_patches
|
|
git_bootstrap
|
|
}
|