/[gentoo-x86]/eclass/subversion.eclass
Gentoo

Contents of /eclass/subversion.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.68 - (show annotations) (download)
Tue Jun 22 18:34:29 2010 UTC (4 years, 2 months ago) by arfrever
Branch: MAIN
Changes since 1.67: +4 -4 lines
dev-util/subversion renamed to dev-vcs/subversion.

1 # Copyright 1999-2009 Gentoo Foundation
2 # Distributed under the terms of the GNU General Public License v2
3 # $Header: /var/cvsroot/gentoo-x86/eclass/subversion.eclass,v 1.67 2009/05/10 20:33:38 arfrever Exp $
4
5 # @ECLASS: subversion.eclass
6 # @MAINTAINER:
7 # Akinori Hattori <hattya@gentoo.org>
8 # Bo ├śrsted Andresen <zlin@gentoo.org>
9 # Arfrever Frehtes Taifersar Arahesis <arfrever@gentoo.org>
10 #
11 # Original Author: Akinori Hattori <hattya@gentoo.org>
12 #
13 # @BLURB: The subversion eclass is written to fetch software sources from subversion repositories
14 # @DESCRIPTION:
15 # The subversion eclass provides functions to fetch, patch and bootstrap
16 # software sources from subversion repositories.
17
18 inherit eutils
19
20 ESVN="${ECLASS}"
21
22 case "${EAPI:-0}" in
23 0|1)
24 EXPORT_FUNCTIONS src_unpack pkg_preinst
25 ;;
26 *)
27 EXPORT_FUNCTIONS src_unpack src_prepare pkg_preinst
28 ;;
29 esac
30
31 DESCRIPTION="Based on the ${ECLASS} eclass"
32
33 SUBVERSION_DEPEND="dev-vcs/subversion
34 net-misc/rsync"
35
36 if [[ -z "${ESVN_DISABLE_DEPENDENCIES}" ]]; then
37 DEPEND="${SUBVERSION_DEPEND}"
38 fi
39
40 # @ECLASS-VARIABLE: ESVN_STORE_DIR
41 # @DESCRIPTION:
42 # subversion sources store directory. Users may override this in /etc/make.conf
43 [[ -z ${ESVN_STORE_DIR} ]] && ESVN_STORE_DIR="${PORTAGE_ACTUAL_DISTDIR:-${DISTDIR}}/svn-src"
44
45 # @ECLASS-VARIABLE: ESVN_FETCH_CMD
46 # @DESCRIPTION:
47 # subversion checkout command
48 ESVN_FETCH_CMD="svn checkout"
49
50 # @ECLASS-VARIABLE: ESVN_UPDATE_CMD
51 # @DESCRIPTION:
52 # subversion update command
53 ESVN_UPDATE_CMD="svn update"
54
55 # @ECLASS-VARIABLE: ESVN_SWITCH_CMD
56 # @DESCRIPTION:
57 # subversion switch command
58 ESVN_SWITCH_CMD="svn switch"
59
60 # @ECLASS-VARIABLE: ESVN_OPTIONS
61 # @DESCRIPTION:
62 # the options passed to checkout or update. If you want a specific revision see
63 # ESVN_REPO_URI instead of using -rREV.
64 ESVN_OPTIONS="${ESVN_OPTIONS:-}"
65
66 # @ECLASS-VARIABLE: ESVN_REPO_URI
67 # @DESCRIPTION:
68 # repository uri
69 #
70 # e.g. http://foo/trunk, svn://bar/trunk, svn://bar/branch/foo@1234
71 #
72 # supported protocols:
73 # http://
74 # https://
75 # svn://
76 # svn+ssh://
77 #
78 # to peg to a specific revision, append @REV to the repo's uri
79 ESVN_REPO_URI="${ESVN_REPO_URI:-}"
80
81 # @ECLASS-VARIABLE: ESVN_REVISION
82 # @DESCRIPTION:
83 # User configurable revision checkout or update to from the repository
84 #
85 # Useful for live svn or trunk svn ebuilds allowing the user to peg
86 # to a specific revision
87 #
88 # Note: This should never be set in an ebuild!
89 ESVN_REVISION="${ESVN_REVISION:-}"
90
91 # @ECLASS-VARIABLE: ESVN_USER
92 # @DESCRIPTION:
93 # User name
94 ESVN_USER="${ESVN_USER:-}"
95
96 # @ECLASS-VARIABLE: ESVN_PASSWORD
97 # @DESCRIPTION:
98 # Password
99 ESVN_PASSWORD="${ESVN_PASSWORD:-}"
100
101 # @ECLASS-VARIABLE: ESVN_PROJECT
102 # @DESCRIPTION:
103 # project name of your ebuild (= name space)
104 #
105 # subversion eclass will check out the subversion repository like:
106 #
107 # ${ESVN_STORE_DIR}/${ESVN_PROJECT}/${ESVN_REPO_URI##*/}
108 #
109 # so if you define ESVN_REPO_URI as http://svn.collab.net/repo/svn/trunk or
110 # http://svn.collab.net/repo/svn/trunk/. and PN is subversion-svn.
111 # it will check out like:
112 #
113 # ${ESVN_STORE_DIR}/subversion/trunk
114 #
115 # this is not used in order to declare the name of the upstream project.
116 # so that you can declare this like:
117 #
118 # # jakarta commons-loggin
119 # ESVN_PROJECT=commons/logging
120 #
121 # default: ${PN/-svn}.
122 ESVN_PROJECT="${ESVN_PROJECT:-${PN/-svn}}"
123
124 # @ECLASS-VARIABLE: ESVN_BOOTSTRAP
125 # @DESCRIPTION:
126 # bootstrap script or command like autogen.sh or etc..
127 ESVN_BOOTSTRAP="${ESVN_BOOTSTRAP:-}"
128
129 # @ECLASS-VARIABLE: ESVN_PATCHES
130 # @DESCRIPTION:
131 # subversion eclass can apply patches in subversion_bootstrap().
132 # you can use regexp in this variable like *.diff or *.patch or etc.
133 # NOTE: patches will be applied before ESVN_BOOTSTRAP is processed.
134 #
135 # Patches are searched both in ${PWD} and ${FILESDIR}, if not found in either
136 # location, the installation dies.
137 ESVN_PATCHES="${ESVN_PATCHES:-}"
138
139 # @ECLASS-VARIABLE: ESVN_RESTRICT
140 # @DESCRIPTION:
141 # this should be a space delimited list of subversion eclass features to
142 # restrict.
143 # export)
144 # don't export the working copy to S.
145 ESVN_RESTRICT="${ESVN_RESTRICT:-}"
146
147 # @ECLASS-VARIABLE: ESVN_DISABLE_DEPENDENCIES
148 # @DESCRIPTION:
149 # Set this variable to a non-empty value to disable the automatic inclusion of
150 # Subversion in dependencies.
151 ESVN_DISABLE_DEPENDENCIES="${ESVN_DISABLE_DEPENDENCIES:-}"
152
153 # @ECLASS-VARIABLE: ESVN_OFFLINE
154 # @DESCRIPTION:
155 # Set this variable to a non-empty value to disable the automatic updating of
156 # an svn source tree. This is intended to be set outside the subversion source
157 # tree by users.
158 ESVN_OFFLINE="${ESVN_OFFLINE:-${ESCM_OFFLINE}}"
159
160 # @ECLASS-VARIABLE: ESVN_UP_FREQ
161 # @DESCRIPTION:
162 # Set the minimum number of hours between svn up'ing in any given svn module. This is particularly
163 # useful for split KDE ebuilds where we want to ensure that all submodules are compiled for the same
164 # revision. It should also be kept user overrideable.
165 ESVN_UP_FREQ="${ESVN_UP_FREQ:=}"
166
167 # @ECLASS-VARIABLE: ESCM_LOGDIR
168 # @DESCRIPTION:
169 # User configuration variable. If set to a path such as e.g. /var/log/scm any
170 # package inheriting from subversion.eclass will record svn revision to
171 # ${CATEGORY}/${PN}.log in that path in pkg_preinst. This is not supposed to be
172 # set by ebuilds/eclasses. It defaults to empty so users need to opt in.
173 ESCM_LOGDIR="${ESCM_LOGDIR:=}"
174
175 # @FUNCTION: subversion_fetch
176 # @USAGE: [repo_uri] [destination]
177 # @DESCRIPTION:
178 # Wrapper function to fetch sources from subversion via svn checkout or svn update,
179 # depending on whether there is an existing working copy in ${ESVN_STORE_DIR}.
180 #
181 # Can take two optional parameters:
182 # repo_uri - a repository URI. default is ESVN_REPO_URI.
183 # destination - a check out path in S.
184 subversion_fetch() {
185 local repo_uri="$(subversion__get_repository_uri "${1:-${ESVN_REPO_URI}}")"
186 local revision="$(subversion__get_peg_revision "${1:-${ESVN_REPO_URI}}")"
187 local S_dest="${2}"
188
189 if [[ -z ${repo_uri} ]]; then
190 die "${ESVN}: ESVN_REPO_URI (or specified URI) is empty."
191 fi
192
193 [[ -n "${ESVN_REVISION}" ]] && revision="${ESVN_REVISION}"
194
195 # check for the protocol
196 local protocol="${repo_uri%%:*}"
197
198 case "${protocol}" in
199 http|https)
200 if ! built_with_use -o dev-vcs/subversion webdav-neon webdav-serf; then
201 echo
202 eerror "In order to emerge this package, you need to"
203 eerror "reinstall Subversion with support for WebDAV."
204 eerror "Subversion requires either Neon or Serf to support WebDAV."
205 echo
206 die "${ESVN}: reinstall Subversion with support for WebDAV."
207 fi
208 ;;
209 svn|svn+ssh)
210 ;;
211 *)
212 die "${ESVN}: fetch from '${protocol}' is not yet implemented."
213 ;;
214 esac
215
216 addread "/etc/subversion"
217 addwrite "${ESVN_STORE_DIR}"
218
219 if [[ ! -d ${ESVN_STORE_DIR} ]]; then
220 debug-print "${FUNCNAME}: initial checkout. creating subversion directory"
221 mkdir -p "${ESVN_STORE_DIR}" || die "${ESVN}: can't mkdir ${ESVN_STORE_DIR}."
222 fi
223
224 cd "${ESVN_STORE_DIR}" || die "${ESVN}: can't chdir to ${ESVN_STORE_DIR}"
225
226 local wc_path="$(subversion__get_wc_path "${repo_uri}")"
227 local options="${ESVN_OPTIONS} --config-dir ${ESVN_STORE_DIR}/.subversion"
228
229 [[ -n "${revision}" ]] && options="${options} -r ${revision}"
230
231 if [[ "${ESVN_OPTIONS}" = *-r* ]]; then
232 ewarn "\${ESVN_OPTIONS} contains -r, this usage is unsupported. Please"
233 ewarn "see \${ESVN_REPO_URI}"
234 fi
235
236 if has_version ">=dev-vcs/subversion-1.6.0"; then
237 options="${options} --config-option=config:auth:password-stores="
238 fi
239
240 debug-print "${FUNCNAME}: wc_path = \"${wc_path}\""
241 debug-print "${FUNCNAME}: ESVN_OPTIONS = \"${ESVN_OPTIONS}\""
242 debug-print "${FUNCNAME}: options = \"${options}\""
243
244 if [[ ! -d ${wc_path}/.svn ]]; then
245 if [[ -n ${ESVN_OFFLINE} ]]; then
246 ewarn "ESVN_OFFLINE cannot be used when there is no existing checkout."
247 fi
248 # first check out
249 einfo "subversion check out start -->"
250 einfo " repository: ${repo_uri}${revision:+@}${revision}"
251
252 debug-print "${FUNCNAME}: ${ESVN_FETCH_CMD} ${options} ${repo_uri}"
253
254 mkdir -p "${ESVN_PROJECT}" || die "${ESVN}: can't mkdir ${ESVN_PROJECT}."
255 cd "${ESVN_PROJECT}" || die "${ESVN}: can't chdir to ${ESVN_PROJECT}"
256 if [[ -n "${ESVN_USER}" ]]; then
257 ${ESVN_FETCH_CMD} ${options} --username "${ESVN_USER}" --password "${ESVN_PASSWORD}" "${repo_uri}" || die "${ESVN}: can't fetch to ${wc_path} from ${repo_uri}."
258 else
259 ${ESVN_FETCH_CMD} ${options} "${repo_uri}" || die "${ESVN}: can't fetch to ${wc_path} from ${repo_uri}."
260 fi
261
262 elif [[ -n ${ESVN_OFFLINE} ]]; then
263 svn upgrade "${wc_path}" &>/dev/null
264 svn cleanup "${wc_path}" &>/dev/null
265 subversion_wc_info "${repo_uri}" || die "${ESVN}: unknown problem occurred while accessing working copy."
266 if [[ -n ${ESVN_REVISION} && ${ESVN_REVISION} != ${ESVN_WC_REVISION} ]]; then
267 die "${ESVN}: You requested off-line updating and revision ${ESVN_REVISION} but only revision ${ESVN_WC_REVISION} is available locally."
268 fi
269 einfo "Fetching disabled: Using existing repository copy at revision ${ESVN_WC_REVISION}."
270 else
271 svn upgrade "${wc_path}" &>/dev/null
272 svn cleanup "${wc_path}" &>/dev/null
273 subversion_wc_info "${repo_uri}" || die "${ESVN}: unknown problem occurred while accessing working copy."
274
275 local esvn_up_freq=
276 if [[ -n ${ESVN_UP_FREQ} ]]; then
277 if [[ -n ${ESVN_UP_FREQ//[[:digit:]]} ]]; then
278 die "${ESVN}: ESVN_UP_FREQ must be an integer value corresponding to the minimum number of hours between svn up."
279 elif [[ -z $(find "${wc_path}/.svn/entries" -mmin "+$((ESVN_UP_FREQ*60))") ]]; then
280 einfo "Fetching disabled since ${ESVN_UP_FREQ} hours has not passed since last update."
281 einfo "Using existing repository copy at revision ${ESVN_WC_REVISION}."
282 esvn_up_freq=no_update
283 fi
284 fi
285
286 if [[ -z ${esvn_up_freq} ]]; then
287 if [[ ${ESVN_WC_URL} != $(subversion__get_repository_uri "${repo_uri}") ]]; then
288 einfo "subversion switch start -->"
289 einfo " old repository: ${ESVN_WC_URL}@${ESVN_WC_REVISION}"
290 einfo " new repository: ${repo_uri}${revision:+@}${revision}"
291
292 debug-print "${FUNCNAME}: ${ESVN_SWITCH_CMD} ${options} ${repo_uri}"
293
294 cd "${wc_path}" || die "${ESVN}: can't chdir to ${wc_path}"
295 if [[ -n "${ESVN_USER}" ]]; then
296 ${ESVN_SWITCH_CMD} ${options} --username "${ESVN_USER}" --password "${ESVN_PASSWORD}" ${repo_uri} || die "${ESVN}: can't update ${wc_path} from ${repo_uri}."
297 else
298 ${ESVN_SWITCH_CMD} ${options} ${repo_uri} || die "${ESVN}: can't update ${wc_path} from ${repo_uri}."
299 fi
300 else
301 # update working copy
302 einfo "subversion update start -->"
303 einfo " repository: ${repo_uri}${revision:+@}${revision}"
304
305 debug-print "${FUNCNAME}: ${ESVN_UPDATE_CMD} ${options}"
306
307 cd "${wc_path}" || die "${ESVN}: can't chdir to ${wc_path}"
308 if [[ -n "${ESVN_USER}" ]]; then
309 ${ESVN_UPDATE_CMD} ${options} --username "${ESVN_USER}" --password "${ESVN_PASSWORD}" || die "${ESVN}: can't update ${wc_path} from ${repo_uri}."
310 else
311 ${ESVN_UPDATE_CMD} ${options} || die "${ESVN}: can't update ${wc_path} from ${repo_uri}."
312 fi
313 fi
314 fi
315 fi
316
317 einfo " working copy: ${wc_path}"
318
319 if ! has "export" ${ESVN_RESTRICT}; then
320 cd "${wc_path}" || die "${ESVN}: can't chdir to ${wc_path}"
321
322 local S="${S}/${S_dest}"
323 mkdir -p "${S}"
324
325 # export to the ${WORKDIR}
326 #* "svn export" has a bug. see http://bugs.gentoo.org/119236
327 #* svn export . "${S}" || die "${ESVN}: can't export to ${S}."
328 rsync -rlpgo --exclude=".svn/" . "${S}" || die "${ESVN}: can't export to ${S}."
329 fi
330
331 echo
332 }
333
334 # @FUNCTION: subversion_bootstrap
335 # @DESCRIPTION:
336 # Apply patches in ${ESVN_PATCHES} and run ${ESVN_BOOTSTRAP} if specified.
337 subversion_bootstrap() {
338 if has "export" ${ESVN_RESTRICT}; then
339 return
340 fi
341
342 cd "${S}"
343
344 if [[ -n ${ESVN_PATCHES} ]]; then
345 einfo "apply patches -->"
346
347 local patch fpatch
348
349 for patch in ${ESVN_PATCHES}; do
350 if [[ -f ${patch} ]]; then
351 epatch "${patch}"
352
353 else
354 for fpatch in ${FILESDIR}/${patch}; do
355 if [[ -f ${fpatch} ]]; then
356 epatch "${fpatch}"
357
358 else
359 die "${ESVN}: ${patch} not found"
360
361 fi
362 done
363
364 fi
365 done
366
367 echo
368 fi
369
370 if [[ -n ${ESVN_BOOTSTRAP} ]]; then
371 einfo "begin bootstrap -->"
372
373 if [[ -f ${ESVN_BOOTSTRAP} && -x ${ESVN_BOOTSTRAP} ]]; then
374 einfo " bootstrap with a file: ${ESVN_BOOTSTRAP}"
375 eval "./${ESVN_BOOTSTRAP}" || die "${ESVN}: can't execute ESVN_BOOTSTRAP."
376
377 else
378 einfo " bootstrap with command: ${ESVN_BOOTSTRAP}"
379 eval "${ESVN_BOOTSTRAP}" || die "${ESVN}: can't eval ESVN_BOOTSTRAP."
380
381 fi
382 fi
383 }
384
385 # @FUNCTION: subversion_src_unpack
386 # @DESCRIPTION:
387 # Default src_unpack. Fetch and, in older EAPIs, bootstrap.
388 subversion_src_unpack() {
389 subversion_fetch || die "${ESVN}: unknown problem occurred in subversion_fetch."
390 if has "${EAPI:-0}" 0 1; then
391 subversion_bootstrap || die "${ESVN}: unknown problem occurred in subversion_bootstrap."
392 fi
393 }
394
395 # @FUNCTION: subversion_src_prepare
396 # @DESCRIPTION:
397 # Default src_prepare. Bootstrap.
398 subversion_src_prepare() {
399 subversion_bootstrap || die "${ESVN}: unknown problem occurred in subversion_bootstrap."
400 }
401
402 # @FUNCTION: subversion_wc_info
403 # @USAGE: [repo_uri]
404 # @RETURN: ESVN_WC_URL, ESVN_WC_ROOT, ESVN_WC_UUID, ESVN_WC_REVISION and ESVN_WC_PATH
405 # @DESCRIPTION:
406 # Get svn info for the specified repo_uri. The default repo_uri is ESVN_REPO_URI.
407 #
408 # The working copy information on the specified repository URI are set to
409 # ESVN_WC_* variables.
410 subversion_wc_info() {
411 local repo_uri="$(subversion__get_repository_uri "${1:-${ESVN_REPO_URI}}")"
412 local wc_path="$(subversion__get_wc_path "${repo_uri}")"
413
414 debug-print "${FUNCNAME}: repo_uri = ${repo_uri}"
415 debug-print "${FUNCNAME}: wc_path = ${wc_path}"
416
417 if [[ ! -d ${wc_path} ]]; then
418 return 1
419 fi
420
421 export ESVN_WC_URL="$(subversion__svn_info "${wc_path}" "URL")"
422 export ESVN_WC_ROOT="$(subversion__svn_info "${wc_path}" "Repository Root")"
423 export ESVN_WC_UUID="$(subversion__svn_info "${wc_path}" "Repository UUID")"
424 export ESVN_WC_REVISION="$(subversion__svn_info "${wc_path}" "Revision")"
425 export ESVN_WC_PATH="${wc_path}"
426 }
427
428 ## -- Private Functions
429
430 ## -- subversion__svn_info() ------------------------------------------------- #
431 #
432 # param $1 - a target.
433 # param $2 - a key name.
434 #
435 subversion__svn_info() {
436 local target="${1}"
437 local key="${2}"
438
439 env LC_ALL=C svn info "${target}" | grep -i "^${key}" | cut -d" " -f2-
440 }
441
442 ## -- subversion__get_repository_uri() --------------------------------------- #
443 #
444 # param $1 - a repository URI.
445 subversion__get_repository_uri() {
446 local repo_uri="${1}"
447
448 debug-print "${FUNCNAME}: repo_uri = ${repo_uri}"
449
450 if [[ -z ${repo_uri} ]]; then
451 die "${ESVN}: ESVN_REPO_URI (or specified URI) is empty."
452 fi
453
454 # delete trailing slash
455 if [[ -z ${repo_uri##*/} ]]; then
456 repo_uri="${repo_uri%/}"
457 fi
458
459 repo_uri="${repo_uri%@*}"
460
461 echo "${repo_uri}"
462 }
463
464 ## -- subversion__get_wc_path() ---------------------------------------------- #
465 #
466 # param $1 - a repository URI.
467 subversion__get_wc_path() {
468 local repo_uri="$(subversion__get_repository_uri "${1}")"
469
470 debug-print "${FUNCNAME}: repo_uri = ${repo_uri}"
471
472 echo "${ESVN_STORE_DIR}/${ESVN_PROJECT}/${repo_uri##*/}"
473 }
474
475 ## -- subversion__get_peg_revision() ----------------------------------------- #
476 #
477 # param $1 - a repository URI.
478 subversion__get_peg_revision() {
479 local repo_uri="${1}"
480
481 debug-print "${FUNCNAME}: repo_uri = ${repo_uri}"
482
483 # repo_uri has peg revision ?
484 if [[ ${repo_uri} != *@* ]]; then
485 debug-print "${FUNCNAME}: repo_uri does not have a peg revision."
486 fi
487
488 local peg_rev=
489 [[ ${repo_uri} = *@* ]] && peg_rev="${repo_uri##*@}"
490
491 debug-print "${FUNCNAME}: peg_rev = ${peg_rev}"
492
493 echo "${peg_rev}"
494 }
495
496 # @FUNCTION: subversion_pkg_preinst
497 # @USAGE: [repo_uri]
498 # @DESCRIPTION:
499 # Log the svn revision of source code. Doing this in pkg_preinst because we
500 # want the logs to stick around if packages are uninstalled without messing with
501 # config protection.
502 subversion_pkg_preinst() {
503 local pkgdate=$(date "+%Y%m%d %H:%M:%S")
504 subversion_wc_info "${1:-${ESVN_REPO_URI}}"
505 if [[ -n ${ESCM_LOGDIR} ]]; then
506 local dir="${ROOT}/${ESCM_LOGDIR}/${CATEGORY}"
507 if [[ ! -d ${dir} ]]; then
508 mkdir -p "${dir}" || \
509 eerror "Failed to create '${dir}' for logging svn revision to '${PORTDIR_SCM}'"
510 fi
511 local logmessage="svn: ${pkgdate} - ${PF}:${SLOT} was merged at revision ${ESVN_WC_REVISION}"
512 if [[ -d ${dir} ]]; then
513 echo "${logmessage}" >> "${dir}/${PN}.log"
514 else
515 eerror "Could not log the message '${logmessage}' to '${dir}/${PN}.log'"
516 fi
517 fi
518 }

  ViewVC Help
Powered by ViewVC 1.1.20