eclass/git.eclass - mirrors/cros/chromiumos/overlays/portage-stable - Git at Google

 # Copyright 1999-2011 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
 # $Header: /var/cvsroot/gentoo-x86/eclass/git.eclass,v 1.58 2011/12/14 23:40:18 vapier 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
 	4|3|2) 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
 }
	# Copyright 1999-2011 Gentoo Foundation
	# Distributed under the terms of the GNU General Public License v2
	# $Header: /var/cvsroot/gentoo-x86/eclass/git.eclass,v 1.58 2011/12/14 23:40:18 vapier 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
	4\|3\|2) 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
	}