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

Contents of /eclass/subversion.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.57 - (show annotations) (download)
Thu Mar 6 09:23:39 2008 UTC (6 years, 5 months ago) by zlin
Branch: MAIN
Changes since 1.56: +2 -2 lines
Typo.

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

  ViewVC Help
Powered by ViewVC 1.1.20