/[gentoo-x86]/eclass/java-ant-2.eclass
Gentoo

Contents of /eclass/java-ant-2.eclass

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.56 - (show annotations) (download)
Sat Apr 20 18:23:57 2013 UTC (14 months, 2 weeks ago) by sera
Branch: MAIN
Changes since 1.55: +2 -2 lines
Raise ant-core dep to version 1.8.2. #466558

1 # eclass for ant based Java packages
2 #
3 # Copyright (c) 2004-2005, Thomas Matthijs <axxo@gentoo.org>
4 # Copyright (c) 2004-2011, Gentoo Foundation
5 # Changes:
6 # May 2007:
7 # Made bsfix make one pass for all things and add some glocal targets for
8 # setting up the whole thing. Contributed by kiorky
9 # (kiorky@cryptelium.net).
10 # December 2006:
11 # I pretty much rewrote the logic of the bsfix functions
12 # and xml-rewrite.py because they were so slow
13 # Petteri R├Ąty (betelgeuse@gentoo.org)
14 #
15 # Licensed under the GNU General Public License, v2
16 #
17 # $Header: /var/cvsroot/gentoo-x86/eclass/java-ant-2.eclass,v 1.55 2012/09/14 05:04:50 ferringb Exp $
18
19 inherit java-utils-2 multilib
20
21 # This eclass provides functionality for Java packages which use
22 # ant to build. In particular, it will attempt to fix build.xml files, so that
23 # they use the appropriate 'target' and 'source' attributes.
24
25 # -----------------------------------------------------------------------------
26 # @variable-preinherit WANT_ANT_TASKS
27 # @variable-default ""
28 #
29 # Please see the description in java-utils-2.eclass.
30 #WANT_ANT_TASKS
31
32 # -----------------------------------------------------------------------------
33 # @variable-preinherit JAVA_ANT_DISABLE_ANT_CORE_DEP
34 # @variable-default unset for java-pkg-2, true for java-pkg-opt-2
35 #
36 # Setting this variable non-empty before inheriting java-ant-2 disables adding
37 # dev-java/ant-core into DEPEND.
38
39 # construct ant-speficic DEPEND
40 # add ant-core into DEPEND, unless disabled
41 if [[ -z "${JAVA_ANT_DISABLE_ANT_CORE_DEP}" ]]; then
42 JAVA_ANT_E_DEPEND="${JAVA_ANT_E_DEPEND} >=dev-java/ant-core-1.8.2"
43 fi
44
45 # add ant tasks specified in WANT_ANT_TASKS to DEPEND
46 local ANT_TASKS_DEPEND;
47 ANT_TASKS_DEPEND="$(java-pkg_ant-tasks-depend)"
48 # check that java-pkg_ant-tasks-depend didn't fail
49 if [[ $? != 0 ]]; then
50 eerror "${ANT_TASKS_DEPEND}"
51 die "java-pkg_ant-tasks-depend() failed"
52 fi
53
54 # We need some tools from javatoolkit. We also need portage 2.1 for phase hooks
55 # and ant dependencies constructed above. Python is there for
56 # java-ant_remove-taskdefs
57 JAVA_ANT_E_DEPEND="${JAVA_ANT_E_DEPEND}
58 ${ANT_TASKS_DEPEND}
59 ${JAVA_PKG_PORTAGE_DEP}
60 >=dev-java/javatoolkit-0.3.0-r2
61 >=dev-lang/python-2.4"
62
63 # this eclass must be inherited after java-pkg-2 or java-pkg-opt-2
64 # if it's java-pkg-opt-2, ant dependencies are pulled based on USE flag
65 if has java-pkg-opt-2 ${INHERITED}; then
66 JAVA_ANT_E_DEPEND="${JAVA_PKG_OPT_USE}? ( ${JAVA_ANT_E_DEPEND} )"
67 elif ! has java-pkg-2 ${INHERITED}; then
68 eerror "java-ant-2 eclass can only be inherited AFTER java-pkg-2 or java-pkg-opt-2"
69 fi
70
71 DEPEND="${JAVA_ANT_E_DEPEND}"
72
73 # ------------------------------------------------------------------------------
74 # @global JAVA_PKG_BSFIX
75 #
76 # Should we attempt to 'fix' ant build files to include the source/target
77 # attributes when calling javac?
78 #
79 # default: on
80 # ------------------------------------------------------------------------------
81 JAVA_PKG_BSFIX=${JAVA_PKG_BSFIX:-"on"}
82
83 # ------------------------------------------------------------------------------
84 # @global JAVA_PKG_BSFIX_ALL
85 #
86 # If we're fixing build files, should we try to fix all the ones we can find?
87 #
88 # default: yes
89 # ------------------------------------------------------------------------------
90 JAVA_PKG_BSFIX_ALL=${JAVA_PKG_BSFIX_ALL:-"yes"}
91
92 # ------------------------------------------------------------------------------
93 # @global JAVA_PKG_BSFIX_NAME
94 #
95 # Filename of build files to fix/search for
96 #
97 # default: build.xml
98 # ------------------------------------------------------------------------------
99 JAVA_PKG_BSFIX_NAME=${JAVA_PKG_BSFIX_NAME:-"build.xml"}
100
101 # ------------------------------------------------------------------------------
102 # @global JAVA_PKG_BSFIX_TARGETS_TAGS
103 #
104 # Targets to fix the 'source' attribute in
105 #
106 # default: javac xjavac javac.preset
107 # ------------------------------------------------------------------------------
108 JAVA_PKG_BSFIX_TARGET_TAGS=${JAVA_PKG_BSFIX_TARGET_TAGS:-"javac xjavac javac.preset"}
109
110 # ------------------------------------------------------------------------------
111 # @global JAVA_PKG_BSFIX_SOURCE_TAGS
112 #
113 # Targets to fix the 'target' attribute in
114 #
115 # default: javacdoc javac xjavac javac.preset
116 # ------------------------------------------------------------------------------
117 JAVA_PKG_BSFIX_SOURCE_TAGS=${JAVA_PKG_BSFIX_SOURCE_TAGS:-"javadoc javac xjavac javac.preset"}
118
119 # ------------------------------------------------------------------------------
120 # @global JAVA_ANT_CLASSPATH_TAGS
121 #
122 # Targets to add the classpath attribute to
123 #
124 # default: javac xjavac
125 # ------------------------------------------------------------------------------
126 JAVA_ANT_CLASSPATH_TAGS="javac xjavac"
127
128 # ------------------------------------------------------------------------------
129 # @global JAVA_ANT_IGNORE_SYSTEM_CLASSES
130 #
131 # Rewrites available tasks to ignore ant classpath.
132 #
133 # default: off
134 # ------------------------------------------------------------------------------
135
136 case "${EAPI:-0}" in
137 0|1) : ;;
138 *) EXPORT_FUNCTIONS src_configure ;;
139 esac
140
141 # ------------------------------------------------------------------------------
142 # @eclass-src_configure
143 #
144 # src_configure rewrites the build.xml files
145 # ------------------------------------------------------------------------------
146 java-ant-2_src_configure() {
147 # if java support is optional, don't perform this when the USE flag is off
148 if has java-pkg-opt-2 ${INHERITED}; then
149 use ${JAVA_PKG_OPT_USE} || return
150 fi
151
152 # eant will call us unless called by Portage
153 [[ -e "${T}/java-ant-2_src_configure-run" ]] && return
154
155 [[ "${JAVA_ANT_IGNORE_SYSTEM_CLASSES}" ]] \
156 && java-ant_ignore-system-classes "${S}/build.xml"
157
158 java-ant_bsfix
159 touch "${T}/java-ant-2_src_configure-run"
160 }
161
162 # ------------------------------------------------------------------------------
163 # @private java-ant_bsfix
164 #
165 # Attempts to fix build files. The following variables will affect its behavior
166 # as listed above:
167 # JAVA_PKG_BSFIX
168 # JAVA_PKG_BSFIX_ALL
169 # JAVA_PKG_BSFIX_NAME,
170 # ------------------------------------------------------------------------------
171 java-ant_bsfix() {
172 debug-print-function ${FUNCNAME} $*
173
174 [[ "${JAVA_PKG_BSFIX}" != "on" ]] && return
175 if ! java-pkg_needs-vm; then
176 echo "QA Notice: Package is using java-ant, but doesn't depend on a Java VM"
177 fi
178
179 pushd "${S}" >/dev/null
180
181 local find_args=""
182 [[ "${JAVA_PKG_BSFIX_ALL}" == "yes" ]] || find_args="-maxdepth 1"
183
184 find_args="${find_args} -type f -name ${JAVA_PKG_BSFIX_NAME// / -o -name } "
185
186 # This voodoo is done for paths with spaces
187 local bsfix_these
188 while read line; do
189 [[ -z ${line} ]] && continue
190 bsfix_these="${bsfix_these} '${line}'"
191 done <<-EOF
192 $(find . ${find_args})
193 EOF
194
195 [[ "${bsfix_these// /}" ]] && eval java-ant_bsfix_files ${bsfix_these}
196
197 popd > /dev/null
198 }
199
200 _bsfix_die() {
201 if has_version dev-python/pyxml; then
202 eerror "If the output above contains:"
203 eerror "ImportError:"
204 eerror "/usr/lib/python2.4/site-packages/_xmlplus/parsers/pyexpat.so:"
205 eerror "undefined symbol: PyUnicodeUCS2_DecodeUTF8"
206 eerror "Try re-emerging dev-python/pyxml"
207 die ${1} " Look at the eerror message above"
208 else
209 die ${1}
210 fi
211 }
212
213 # ------------------------------------------------------------------------------
214 # @public java-ant_bsfix_files
215 #
216 # Attempts to fix named build files. The following variables will affect its behavior
217 # as listed above:
218 # JAVA_PKG_BSFIX_SOURCE_TAGS
219 # JAVA_PKG_BSFIX_TARGET_TAGS
220 # JAVA_ANT_REWRITE_CLASSPATH
221 # JAVA_ANT_JAVADOC_INPUT_DIRS: Where we can find java sources for javadoc
222 # input. Can be a space separated list of
223 # directories
224 # JAVA_ANT_BSFIX_EXTRA_ARGS: You can use this to pass extra variables to the
225 # rewriter if you know what you are doing.
226 #
227 # If JAVA_ANT_JAVADOC_INPUT_DIRS is set, we will turn on the adding of a basic
228 # javadoc target to the ant's build.xml with the javadoc xml-rewriter feature.
229 # Then we will set EANT DOC TARGET to the added javadoc target
230 # NOTE: the variable JAVA_ANT_JAVADOC_OUTPUT_DIR points where we will
231 # generate the javadocs. This is a read-only variable, dont change it.
232
233 # When changing this function, make sure that it works with paths with spaces in
234 # them.
235 # ------------------------------------------------------------------------------
236 java-ant_bsfix_files() {
237 debug-print-function ${FUNCNAME} $*
238
239 [[ ${#} = 0 ]] && die "${FUNCNAME} called without arguments"
240
241 local want_source="$(java-pkg_get-source)"
242 local want_target="$(java-pkg_get-target)"
243
244 debug-print "${FUNCNAME}: target: ${want_target} source: ${want_source}"
245
246 if [ -z "${want_source}" -o -z "${want_target}" ]; then
247 eerror "Could not find valid -source/-target values"
248 eerror "Please file a bug about this on bugs.gentoo.org"
249 die "Could not find valid -source/-target values"
250 else
251 local files
252
253 for file in "${@}"; do
254 debug-print "${FUNCNAME}: ${file}"
255
256 if [[ -n "${JAVA_PKG_DEBUG}" ]]; then
257 cp "${file}" "${file}.orig" || die "failed to copy ${file}"
258 fi
259
260 if [[ ! -w "${file}" ]]; then
261 chmod u+w "${file}" || die "chmod u+w ${file} failed"
262 fi
263
264 files="${files} -f '${file}'"
265 done
266
267 # for javadoc target and all in one pass, we need the new rewriter.
268 local rewriter3="/usr/share/javatoolkit/xml-rewrite-3.py"
269 if [[ ! -f ${rewriter3} ]]; then
270 rewriter3="/usr/$(get_libdir)/javatoolkit/bin/xml-rewrite-3.py"
271 fi
272
273 local rewriter4="/usr/$(get_libdir)/javatoolkit/bin/build-xml-rewrite"
274
275 if [[ -x ${rewriter4} && ${JAVA_ANT_ENCODING} ]]; then
276 [[ ${JAVA_ANT_REWRITE_CLASSPATH} ]] && local gcp="-g"
277 [[ ${JAVA_ANT_ENCODING} ]] && local enc="-e ${JAVA_ANT_ENCODING}"
278 eval echo "cElementTree rewriter"
279 debug-print "${rewriter4} extra args: ${gcp} ${enc}"
280 ${rewriter4} ${gcp} ${enc} \
281 -c "${JAVA_PKG_BSFIX_SOURCE_TAGS}" source ${want_source} \
282 -c "${JAVA_PKG_BSFIX_TARGET_TAGS}" target ${want_target} \
283 "${@}" || die "build-xml-rewrite failed"
284 elif [[ ! -f ${rewriter3} ]]; then
285 debug-print "Using second generation rewriter"
286 eval echo "Rewriting source attributes"
287 eval xml-rewrite-2.py ${files} \
288 -c -e ${JAVA_PKG_BSFIX_SOURCE_TAGS// / -e } \
289 -a source -v ${want_source} || _bsfix_die "xml-rewrite2 failed: ${file}"
290
291 eval echo "Rewriting target attributes"
292 eval xml-rewrite-2.py ${files} \
293 -c -e ${JAVA_PKG_BSFIX_TARGET_TAGS// / -e } \
294 -a target -v ${want_target} || _bsfix_die "xml-rewrite2 failed: ${file}"
295
296 eval echo "Rewriting nowarn attributes"
297 eval xml-rewrite-2.py ${files} \
298 -c -e ${JAVA_PKG_BSFIX_TARGET_TAGS// / -e } \
299 -a nowarn -v yes || _bsfix_die "xml-rewrite2 failed: ${file}"
300
301 if [[ ${JAVA_ANT_REWRITE_CLASSPATH} ]]; then
302 eval echo "Adding gentoo.classpath to javac tasks"
303 eval xml-rewrite-2.py ${files} \
304 -c -e javac -e xjavac -a classpath -v \
305 '\${gentoo.classpath}' \
306 || _bsfix_die "xml-rewrite2 failed"
307 fi
308 else
309 debug-print "Using third generation rewriter"
310 eval echo "Rewriting attributes"
311 local bsfix_extra_args=""
312 # WARNING KEEP THE ORDER, ESPECIALLY FOR CHANGED ATTRIBUTES!
313 if [[ -n ${JAVA_ANT_REWRITE_CLASSPATH} ]]; then
314 local cp_tags="${JAVA_ANT_CLASSPATH_TAGS// / -e }"
315 bsfix_extra_args="${bsfix_extra_args} -g -e ${cp_tags}"
316 bsfix_extra_args="${bsfix_extra_args} -a classpath -v '\${gentoo.classpath}'"
317 fi
318 if [[ -n ${JAVA_ANT_JAVADOC_INPUT_DIRS} ]]; then
319 if [[ -n ${JAVA_ANT_JAVADOC_OUTPUT_DIR} ]]; then
320 die "Do not define JAVA_ANT_JAVADOC_OUTPUT_DIR!"
321 fi
322 # Where will our generated javadoc go.
323 readonly JAVA_ANT_JAVADOC_OUTPUT_DIR="${WORKDIR}/gentoo_javadoc"
324 mkdir -p "${JAVA_ANT_JAVADOC_OUTPUT_DIR}" || die
325
326 if has doc ${IUSE}; then
327 if use doc; then
328 if [[ -z ${EANT_DOC_TARGET} ]]; then
329 EANT_DOC_TARGET="gentoojavadoc"
330 else
331 die "You can't use javadoc adding and set EANT_DOC_TARGET too."
332 fi
333
334 for dir in ${JAVA_ANT_JAVADOC_INPUT_DIRS};do
335 if [[ ! -d ${dir} ]]; then
336 eerror "This dir: ${dir} doesnt' exists"
337 die "You must specify directories for javadoc input/output dirs."
338 fi
339 done
340 bsfix_extra_args="${bsfix_extra_args} --javadoc --source-directory "
341 # filter third/double spaces
342 JAVA_ANT_JAVADOC_INPUT_DIRS=${JAVA_ANT_JAVADOC_INPUT_DIRS// /}
343 JAVA_ANT_JAVADOC_INPUT_DIRS=${JAVA_ANT_JAVADOC_INPUT_DIRS// /}
344 bsfix_extra_args="${bsfix_extra_args} ${JAVA_ANT_JAVADOC_INPUT_DIRS// / --source-directory }"
345 bsfix_extra_args="${bsfix_extra_args} --output-directory ${JAVA_ANT_JAVADOC_OUTPUT_DIR}"
346 fi
347 else
348 die "You need to have doc in IUSE when using JAVA_ANT_JAVADOC_INPUT_DIRS"
349 fi
350 fi
351
352 [[ -n ${JAVA_ANT_BSFIX_EXTRA_ARGS} ]] \
353 && bsfix_extra_args="${bsfix_extra_args} ${JAVA_ANT_BSFIX_EXTRA_ARGS}"
354
355 debug-print "bsfix_extra_args: ${bsfix_extra_args}"
356
357 eval ${rewriter3} ${files} \
358 -c --source-element ${JAVA_PKG_BSFIX_SOURCE_TAGS// / --source-element } \
359 --source-attribute source --source-value ${want_source} \
360 --target-element ${JAVA_PKG_BSFIX_TARGET_TAGS// / --target-element } \
361 --target-attribute target --target-value ${want_target} \
362 --target-attribute nowarn --target-value yes \
363 ${bsfix_extra_args} \
364 || _bsfix_die "xml-rewrite2 failed: ${file}"
365 fi
366
367 if [[ -n "${JAVA_PKG_DEBUG}" ]]; then
368 for file in "${@}"; do
369 diff -NurbB "${file}.orig" "${file}"
370 done
371 fi
372 fi
373 return 0 # so that the 1 for diff doesn't get reported
374 }
375
376
377 # ------------------------------------------------------------------------------
378 # @public java-ant_bsfix_one
379 #
380 # Attempts to fix named build file. The following variables will affect its behavior
381 # as listed above:
382 # JAVA_PKG_BSFIX_SOURCE_TAGS
383 # JAVA_PKG_BSFIX_TARGET_TAGS
384 # ------------------------------------------------------------------------------
385 java-ant_bsfix_one() {
386 debug-print-function ${FUNCNAME} $*
387
388 if [ -z "${1}" ]; then
389 eerror "${FUNCNAME} needs one argument"
390 die "${FUNCNAME} needs one argument"
391 fi
392
393 java-ant_bsfix_files "${1}"
394 }
395
396 # ------------------------------------------------------------------------------
397 # @public java-ant_rewrite-classpath
398 #
399 # Adds 'classpath="${gentoo.classpath}"' to specified build file.
400 # Affected by:
401 # JAVA_ANT_CLASSPATH_TAGS
402 # @param $1 - the file to rewrite (defaults to build.xml)
403 # ------------------------------------------------------------------------------
404 java-ant_rewrite-classpath() {
405 debug-print-function ${FUNCNAME} $*
406
407 local file="${1}"
408 [[ -z "${1}" ]] && file=build.xml
409 [[ ${#} -gt 1 ]] && die "${FUNCNAME} currently can only rewrite one file."
410
411 echo "Adding gentoo.classpath to ${file}"
412 debug-print "java-ant_rewrite-classpath: ${file}"
413
414 cp "${file}" "${file}.orig" || die "failed to copy ${file}"
415
416 chmod u+w "${file}"
417
418 java-ant_xml-rewrite -f "${file}" --change \
419 -e ${JAVA_ANT_CLASSPATH_TAGS// / -e } -a classpath -v '${gentoo.classpath}'
420
421 if [[ -n "${JAVA_PKG_DEBUG}" ]]; then
422 diff -NurbB "${file}.orig" "${file}"
423 fi
424 }
425
426 # ------------------------------------------------------------------------------
427 # @public java-ant_remove-taskdefs
428 #
429 # Removes (named) taskdef elements from the file.
430 # Options:
431 # --name NAME : only remove taskdef with name NAME.
432 # @param $1 - the file to rewrite (defaults to build.xml)
433 # ------------------------------------------------------------------------------
434 java-ant_remove-taskdefs() {
435 debug-print-function ${FUNCNAME} $*
436 local task_name
437 if [[ "${1}" == --name ]]; then
438 task_name="${2}"
439 shift 2
440 fi
441 local file="${1:-build.xml}"
442 echo "Removing taskdefs from ${file}"
443 python <<EOF
444 import sys
445 from xml.dom.minidom import parse
446 dom = parse("${file}")
447 for elem in dom.getElementsByTagName('taskdef'):
448 if (len("${task_name}") == 0 or elem.getAttribute("name") == "${task_name}"):
449 elem.parentNode.removeChild(elem)
450 elem.unlink()
451 f = open("${file}", "w")
452 dom.writexml(f)
453 f.close()
454 EOF
455 [[ $? != 0 ]] && die "Removing taskdefs failed"
456 }
457
458 # ------------------------------------------------------------------------------
459 # @public java-ant_ignore-system-classes
460 #
461 # Makes the available task ignore classes in the system classpath
462 # @param $1 - the file to rewrite (defaults to build.xml)
463 # ------------------------------------------------------------------------------
464 java-ant_ignore-system-classes() {
465 debug-print-function ${FUNCNAME} $*
466 local file=${1:-build.xml}
467 echo "Changing ignoresystemclasses to true for available tasks in ${file}"
468 java-ant_xml-rewrite -f "${file}" --change \
469 -e available -a ignoresystemclasses -v "true"
470 }
471
472 # ------------------------------------------------------------------------------
473 # @public java-ant_xml-rewrite
474 # Run the right xml-rewrite binary with the given arguments
475 # ------------------------------------------------------------------------------
476 java-ant_xml-rewrite() {
477 local gen2="/usr/bin/xml-rewrite-2.py"
478 local gen2_1="/usr/$(get_libdir)/javatoolkit/bin/xml-rewrite-2.py"
479 # gen1 is deprecated
480 if [[ -x "${gen2}" ]]; then
481 ${gen2} "${@}" || die "${gen2} failed"
482 elif [[ -x "${gen2_1}" ]]; then
483 ${gen2_1} "${@}" || die "${gen2_1} failed"
484 else
485 eerror "No binary for rewriting found."
486 eerror "Do you have dev-java/javatoolkit installed?"
487 die "xml-rewrite not found"
488 fi
489 }
490
491 # ------------------------------------------------------------------------------
492 # @public java-ant_rewrite-bootclasspath
493 #
494 # Adds bootclasspath to javac-like tasks in build.xml filled with jars of a
495 # bootclasspath package of given version.
496 #
497 # Affected by:
498 # JAVA_PKG_BSFIX_TARGET_TAGS - the tags of javac tasks
499 #
500 # @param $1 - the version of bootclasspath (e.g. 1.5), 'auto' for bootclasspath
501 # of the current JDK
502 # @param $2 - path to desired build.xml file, defaults to 'build.xml'
503 # @param $3 - (optional) what to prepend the bootclasspath with (to override)
504 # @param $4 - (optional) what to append to the bootclasspath
505 # ------------------------------------------------------------------------------
506
507 java-ant_rewrite-bootclasspath() {
508 local version="${1}"
509 local file="${2-build.xml}"
510 local extra_before="${3}"
511 local extra_after="${4}"
512
513 local bcp="$(java-pkg_get-bootclasspath "${version}")"
514
515 if [[ -n "${extra_before}" ]]; then
516 bcp="${extra_before}:${bcp}"
517 fi
518 if [[ -n "${extra_after}" ]]; then
519 bcp="${bcp}:${extra_after}"
520 fi
521
522 java-ant_xml-rewrite -f "${file}" -c -e ${JAVA_PKG_BSFIX_TARGET_TAGS// / -e } \
523 -a bootclasspath -v "${bcp}"
524 }

  ViewVC Help
Powered by ViewVC 1.1.20