/[gentoo-x86]/eclass/perl-module.eclass
Gentoo

Diff of /eclass/perl-module.eclass

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.112 Revision 1.119
1# Copyright 1999-2004 Gentoo Foundation 1# Copyright 1999-2009 Gentoo Foundation
2# Distributed under the terms of the GNU General Public License v2 2# Distributed under the terms of the GNU General Public License v2
3# $Header: /var/cvsroot/gentoo-x86/eclass/perl-module.eclass,v 1.112 2008/09/30 08:28:44 robbat2 Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/perl-module.eclass,v 1.119 2009/11/14 08:58:50 tove Exp $
4# 4#
5# Author: Seemant Kulleen <seemant@gentoo.org> 5# Author: Seemant Kulleen <seemant@gentoo.org>
6# Maintained by the Perl herd <perl@gentoo.org> 6
7# 7# @ECLASS: perl-module.eclass
8# @MAINTAINER:
9# perl@gentoo.org
10# @BLURB: eclass for perl modules
11# @DESCRIPTION:
8# The perl-module eclass is designed to allow easier installation of perl 12# The perl-module eclass is designed to allow easier installation of perl
9# modules, and their incorporation into the Gentoo Linux system. 13# modules, and their incorporation into the Gentoo Linux system.
10 14
11inherit base 15inherit eutils base
16[[ ${CATEGORY} == "perl-core" ]] && inherit alternatives
12 17
13EXPORT_FUNCTIONS pkg_setup pkg_preinst pkg_postinst pkg_prerm pkg_postrm src_compile src_install src_test src_unpack 18PERL_EXPF="src_unpack src_compile src_test src_install"
14 19
15# 2005.04.28 mcummings 20case "${EAPI:-0}" in
16# Mounting problems with src_test functions has forced me to make the 21 0|1)
17# compilation of perl modules honor the FEATURES maketest flag rather than what 22 PERL_EXPF="${PERL_EXPF} pkg_setup pkg_preinst pkg_postinst pkg_prerm pkg_postrm"
18# is generally necessary. I've left a block to make sure we still need to set 23 ;;
19# the SRC_TEST="do" flag on the suspicion that otherwise we will face 10 times 24 2)
20# as many bug reports as we have lately. 25 PERL_EXPF="${PERL_EXPF} src_prepare src_configure"
21# 26 [[ ${CATEGORY} == "perl-core" ]] && \
22# 2004.05.10 rac 27 PERL_EXPF="${PERL_EXPF} pkg_postinst pkg_postrm"
23# block on makemaker versions earlier than that in the 5.8.2 core. in
24# actuality, this should be handled in the perl ebuild, so every perl
25# ebuild should block versions of MakeMaker older than the one it
26# carries. in the meantime, since we have dumped support for MakeMaker
27# <6.11 and the associated broken DESTDIR handling, block here to save
28# people from sandbox trouble.
29#
30# 2004.05.25 rac
31# for the same reasons, make the perl dep >=5.8.2 to get everybody
32# with 5.8.0 and its 6.03 makemaker up to a version that can
33# understand DESTDIR
34#
35# 2004.10.01 mcummings
36# noticed a discrepancy in how we were sed fixing references to ${D}
37#
38# 2005.03.14 mcummings
39# Updated eclass to include a specific function for dealing with perlocal.pods -
40# this should avoid the conflicts we've been running into with the introduction
41# of file collision features by giving us a single exportable function to deal
42# with the pods. Modifications to the eclass provided by Yaakov S
43# <yselkowitz@hotmail.com> in bug 83622
44#
45# <later the same day>
46# The long awaited (by me) fix for automagically detecting and dealing
47# with module-build dependancies. I've chosen not to make it a default dep since
48# this adds overhead to people that might not otherwise need it, and instead
49# modified the eclass to detect the existence of a Build.PL and behave
50# accordingly. This will fix issues with g-cpan builds that needs module-build
51# support, as well as get rid of the (annoying) style=builder vars. I know of
52# only one module that needed to be hacked for this, Class-MethodMaker-2.05, but
53# that module has a bad Build.PL to begin with. Ebuilds should continue to
54# DEPEND on module-build<-version> as needed, but there should be no need for
55# the style directive any more (especially since it isn't in the eclass
56# anymore). Enjoy!
57#
58# 2005.07.18 mcummings
59# Fix for proper handling of $mydoc - thanks to stkn for noticing we were
60# bombing out there
61#
62# 2005.07.19 mcummings
63# Providing an override var for the use of Module::Build. While it is being
64# incorporated in more and more modules, not all module authors have working
65# Build.PL's in place. The override is to allow for a fallback to the "classic"
66# Makfile.PL - example is Class::MethodMaker, which provides a Build.PL that is
67# severely broken.
68#
69# 2006.02.11 mcummings
70# Per a conversation with solar, adding a change to the dep/rdep lines for
71# minimal. Should fix bug 68367 and bug 83622, as well as other embedded builds
72# that use perl components without providing perl
73#
74# 2006.06.13 mcummings
75# I've reordered and extended the logic on when to invoke module-build versus
76# MakeMaker. The problem that has arisen is that some modules provide a
77# Makefile.PL that passes all arguments on to a Build.PL - including PREFIX,
78# which causes module-build to build with a target of /usr/usr/
79# (how broken is that?). Current logic is if there is a Build.PL and we aren't
80# overriding, use it; otherwise use the Makefile.PL; otherwise return (maybe we
81# want all the functionality of the perl-module eclass without needing to
82# compile??).
83#
84# 2007.08.19 ian
85# Added ${myconf} - bug #176818
86#
87# 2007.10.17 robbat2
88# Added the 'MODULE_AUTHOR' variable. Set it before inheriting the eclass
89# and it will set your HOMEPAGE and SRC_URI correctly for a CPAN package.
90#
91# 2008.09.30 robbat2
92# MODULE_A enables variations other than .tar.gz easily. Also Use MY_P if set
93# for MODULE_A and MY_PN in HOMEPAGE, as suggested by tove.
94 28
29 case "${GENTOO_DEPEND_ON_PERL:-yes}" in
30 yes)
31 DEPEND="dev-lang/perl[-build]"
32 RDEPEND="${DEPEND}"
33 ;;
34 esac
35 ;;
36esac
37
38EXPORT_FUNCTIONS ${PERL_EXPF}
39
40DESCRIPTION="Based on the $ECLASS eclass"
41
42LICENSE="${LICENSE:-|| ( Artistic GPL-2 )}"
43
95[ -z "${SRC_URI}" -a -z "${MODULE_A}" ] && MODULE_A="${MY_P:-${P}}.tar.gz" 44[[ -z "${SRC_URI}" && -z "${MODULE_A}" ]] && MODULE_A="${MY_P:-${P}}.tar.gz"
96[ -z "${SRC_URI}" -a -n "${MODULE_AUTHOR}" ] && \ 45[[ -z "${SRC_URI}" && -n "${MODULE_AUTHOR}" ]] && \
97 SRC_URI="mirror://cpan/authors/id/${MODULE_AUTHOR:0:1}/${MODULE_AUTHOR:0:2}/${MODULE_AUTHOR}/${MODULE_SECTION}/${MODULE_A}" 46 SRC_URI="mirror://cpan/authors/id/${MODULE_AUTHOR:0:1}/${MODULE_AUTHOR:0:2}/${MODULE_AUTHOR}/${MODULE_SECTION}/${MODULE_A}"
98[ -z "${HOMEPAGE}" ] && \ 47[[ -z "${HOMEPAGE}" ]] && \
99 HOMEPAGE="http://search.cpan.org/search?query=${MY_PN:-${PN}}&mode=dist" 48 HOMEPAGE="http://search.cpan.org/dist/${MY_PN:-${PN}}/"
100 49
101SRC_PREP="no" 50SRC_PREP="no"
102SRC_TEST="skip" 51SRC_TEST="skip"
103PREFER_BUILDPL="yes" 52PREFER_BUILDPL="yes"
104 53
105PERL_VERSION="" 54PERL_VERSION=""
106SITE_ARCH="" 55SITE_ARCH=""
107SITE_LIB="" 56SITE_LIB=""
57ARCH_LIB=""
58VENDOR_ARCH=""
108VENDOR_LIB="" 59VENDOR_LIB=""
109VENDOR_ARCH="" 60
110ARCH_LIB=""
111POD_DIR=""
112BUILDER_VER=""
113pm_echovar="" 61pm_echovar=""
62perlinfo_done=false
114 63
115perl-module_src_unpack() { 64perl-module_src_unpack() {
65 base_src_unpack unpack
66 has src_prepare ${PERL_EXPF} || perl-module_src_prepare
67}
68
69perl-module_src_prepare() {
116 if [[ -n ${PATCHES} ]]; then 70 if [[ -n ${PATCHES} ]] ; then
117 base_src_unpack unpack
118 base_src_unpack autopatch 71 base_src_unpack autopatch
119 else
120 base_src_unpack unpack
121 fi 72 fi
73 esvn_clean
74}
75
76perl-module_src_configure() {
77 perl-module_src_prep
122} 78}
123 79
124perl-module_src_prep() { 80perl-module_src_prep() {
81 [[ ${SRC_PREP} = yes ]] && return 0
82 SRC_PREP="yes"
125 83
126 perlinfo 84 ${perlinfo_done} || perlinfo
127 85
128 export PERL_MM_USE_DEFAULT=1 86 export PERL_MM_USE_DEFAULT=1
129 # Disable ExtUtils::AutoInstall from prompting 87 # Disable ExtUtils::AutoInstall from prompting
130 export PERL_EXTUTILS_AUTOINSTALL="--skipdeps" 88 export PERL_EXTUTILS_AUTOINSTALL="--skipdeps"
131 89
132 90 if [[ ${PREFER_BUILDPL} == yes && -f Build.PL ]] ; then
133 SRC_PREP="yes"
134 find ${S} -type d -name "\.svn" -exec /bin/rm -rf {} \; 2>/dev/null
135 if [ "${PREFER_BUILDPL}" == "yes" ] && ( [ -f Build.PL ] || [ ${PN} == "module-build" ] ); then
136 einfo "Using Module::Build" 91 einfo "Using Module::Build"
137 echo "$pm_echovar" | perl Build.PL ${myconf} --installdirs=vendor --destdir=${D} --libdoc= || die "Unable to build! (are you using USE=\"build\"?)" 92 perl Build.PL \
138 elif [ -f Makefile.PL ] && [ ! ${PN} == "module-build" ]; then 93 --installdirs=vendor \
94 --libdoc= \
95 --destdir="${D}" \
96 --create_packlist=0 \
97 ${myconf} \
98 <<< "${pm_echovar}" \
99 || die "Unable to build! (are you using USE=\"build\"?)"
100 elif [[ -f Makefile.PL ]] ; then
139 einfo "Using ExtUtils::MakeMaker" 101 einfo "Using ExtUtils::MakeMaker"
140 echo "$pm_echovar" | perl Makefile.PL ${myconf} INSTALLMAN3DIR='none'\ 102 perl Makefile.PL \
141 PREFIX=/usr INSTALLDIRS=vendor DESTDIR=${D} || die "Unable to build! (are you using USE=\"build\"?)" 103 PREFIX=/usr \
104 INSTALLDIRS=vendor \
105 INSTALLMAN3DIR='none' \
106 DESTDIR="${D}" \
107 ${myconf} \
108 <<< "${pm_echovar}" \
109 || die "Unable to build! (are you using USE=\"build\"?)"
142 fi 110 fi
143 if [ ! -f Build.PL ] && [ ! -f Makefile.PL ]; then 111 if [[ ! -f Build.PL && ! -f Makefile.PL ]] ; then
144 einfo "No Make or Build file detected..." 112 einfo "No Make or Build file detected..."
145 return 113 return
146 fi 114 fi
147} 115}
148 116
149perl-module_src_compile() { 117perl-module_src_compile() {
118 ${perlinfo_done} || perlinfo
150 119
151 perlinfo 120 has src_configure ${PERL_EXPF} || perl-module_src_prep
152 [ "${SRC_PREP}" != "yes" ] && perl-module_src_prep 121
122 if [[ -f Build ]] ; then
123 ./Build build \
124 || die "compilation failed"
153 if [ -f Makefile ]; then 125 elif [[ -f Makefile ]] ; then
126 emake \
127 OTHERLDFLAGS="${LDFLAGS}" \
128 ${mymake} \
154 make ${mymake} || die "compilation failed" 129 || die "compilation failed"
130# OPTIMIZE="${CFLAGS}" \
131 fi
132}
133
134# For testers:
135# This code attempts to work out your threadingness from MAKEOPTS
136# and apply them to Test::Harness.
137#
138# If you want more verbose testing, set TEST_VERBOSE=1
139# in your bashrc | /etc/make.conf | ENV
140#
141# For ebuild writers:
142# If you wish to enable default tests w/ 'make test' ,
143#
144# SRC_TEST="do"
145#
146# If you wish to have threads run in parallel ( using the users makeopts )
147# all of the following have been tested to work.
148#
149# SRC_TEST="do parallel"
150# SRC_TEST="parallel"
151# SRC_TEST="parallel do"
152# SRC_TEST=parallel
153#
154
155perl-module_src_test() {
156 if has 'do' ${SRC_TEST} || has 'parallel' ${SRC_TEST} ; then
157 if has "${TEST_VERBOSE:-0}" 0 && has 'parallel' ${SRC_TEST} ; then
158 export HARNESS_OPTIONS=j$(echo -j1 ${MAKEOPTS} | sed -r "s/.*(-j\s*|--jobs=)([0-9]+).*/\2/" )
159 einfo "Test::Harness Jobs=${HARNESS_OPTIONS}"
160 fi
161 ${perlinfo_done} || perlinfo
162 if [[ -f Build ]] ; then
163 ./Build test verbose=${TEST_VERBOSE:-0} || die "test failed"
164 elif [[ -f Makefile ]] ; then
165 emake test TEST_VERBOSE=${TEST_VERBOSE:-0} || die "test failed"
166 fi
167 fi
168}
169
170perl-module_src_install() {
171 local f
172 ${perlinfo_done} || perlinfo
173
174 if [[ -z ${mytargets} ]] ; then
175 case "${CATEGORY}" in
176 dev-perl|perl-core) mytargets="pure_install" ;;
177 *) mytargets="install" ;;
178 esac
179 fi
180
155 elif [ -f Build ]; then 181 if [[ -f Build ]] ; then
156 perl Build build || die "compilation failed" 182 ./Build ${mytargets} \
183 || die "./Build ${mytargets} failed"
184 elif [[ -f Makefile ]] ; then
185 emake ${myinst} ${mytargets} \
186 || die "emake ${myinst} ${mytargets} failed"
157 fi 187 fi
188
189 if [[ -d "${D}"/usr/share/man ]] ; then
190# einfo "Cleaning out stray man files"
191 find "${D}"/usr/share/man -type f -name "*.3pm" -delete
192 find "${D}"/usr/share/man -depth -type d -empty -delete
193 fi
194
158 fixlocalpod 195 fixlocalpod
159 196
160} 197 for f in Change* CHANGES README* TODO ${mydoc}; do
161 198 [[ -s ${f} ]] && dodoc ${f}
162perl-module_src_test() {
163 if [ "${SRC_TEST}" == "do" ]; then
164 perlinfo
165 if [ -f Makefile ]; then
166 make test || die "test failed"
167 elif [ -f Build ]; then
168 perl Build test || die "test failed"
169 fi
170 fi
171}
172
173perl-module_src_install() {
174
175 perlinfo
176
177 test -z ${mytargets} && mytargets="install"
178
179 if [ -f Makefile ]; then
180 make ${myinst} ${mytargets} || die
181 elif [ -f Build ]; then
182 perl ${S}/Build install
183 fi
184
185
186 einfo "Cleaning out stray man files"
187 for FILE in `find ${D} -type f -name "*.3pm*"`; do
188 rm -rf ${FILE}
189 done 199 done
190 find ${D}/usr/share/man -depth -type d 2>/dev/null | xargs -r rmdir 2>/dev/null
191 200
192 fixlocalpod 201 if [[ -d ${D}/${VENDOR_LIB} ]] ; then
202 find "${D}/${VENDOR_LIB}" -type f -a \( -name .packlist \
203 -o \( -name '*.bs' -a -empty \) \) -delete
204 find "${D}/${VENDOR_LIB}" -depth -mindepth 1 -type d -empty -delete
205 fi
193 206
194 for FILE in `find ${D} -type f |grep -v '.so'`; do 207 find "${D}" -type f -not -name '*.so' -print0 | while read -rd '' f ; do
195 STAT=`file $FILE| grep -i " text"` 208 if file "${f}" | grep -q -i " text" ; then
196 if [ "${STAT}x" != "x" ]; then 209 grep -q "${D}" "${f}" && ewarn "QA: File contains a temporary path ${f}"
197 sed -i -e "s:${D}:/:g" ${FILE} 210 sed -i -e "s:${D}:/:g" "${f}"
198 fi 211 fi
199 done 212 done
200 213
201 for doc in Change* MANIFEST* README* ${mydoc}; do 214 linkduallifescripts
202 [ -s "$doc" ] && dodoc $doc 215}
216
217perl-module_pkg_setup() {
218 ${perlinfo_done} || perlinfo
219}
220
221perl-module_pkg_preinst() {
222 ${perlinfo_done} || perlinfo
223}
224
225perl-module_pkg_postinst() {
226 linkduallifescripts
227}
228
229perl-module_pkg_prerm() { : ; }
230
231perl-module_pkg_postrm() {
232 linkduallifescripts
233}
234
235perlinfo() {
236 perlinfo_done=true
237
238 local f version install{{site,vendor}{arch,lib},archlib}
239 for f in version install{{site,vendor}{arch,lib},archlib} ; do
240 eval "$(perl -V:${f} )"
203 done 241 done
204}
205
206
207perl-module_pkg_setup() {
208
209 perlinfo
210}
211
212
213perl-module_pkg_preinst() {
214
215 perlinfo
216}
217
218perl-module_pkg_postinst() {
219
220 einfo "Man pages are not installed for most modules now."
221 einfo "Please use perldoc instead."
222 updatepod
223}
224
225perl-module_pkg_prerm() {
226
227 updatepod
228}
229
230perl-module_pkg_postrm() {
231
232 updatepod
233}
234
235perlinfo() {
236
237 local version
238 eval `perl '-V:version'`
239 PERL_VERSION=${version} 242 PERL_VERSION=${version}
240
241 local installsitearch
242 eval `perl '-V:installsitearch'`
243 SITE_ARCH=${installsitearch} 243 SITE_ARCH=${installsitearch}
244
245 local installsitelib
246 eval `perl '-V:installsitelib'`
247 SITE_LIB=${installsitelib} 244 SITE_LIB=${installsitelib}
248
249 local installarchlib
250 eval `perl '-V:installarchlib'`
251 ARCH_LIB=${installarchlib} 245 ARCH_LIB=${installarchlib}
252
253 local installvendorlib
254 eval `perl '-V:installvendorlib'`
255 VENDOR_LIB=${installvendorlib} 246 VENDOR_LIB=${installvendorlib}
256
257 local installvendorarch
258 eval `perl '-V:installvendorarch'`
259 VENDOR_ARCH=${installvendorarch} 247 VENDOR_ARCH=${installvendorarch}
248}
260 249
261 if [ "${PREFER_BUILDPL}" == "yes" ]; then 250fixlocalpod() {
262 if [ ! -f ${S}/Makefile.PL ] || [ ${PN} == "module-build" ]; then 251 find "${D}" -type f -name perllocal.pod -delete
263 if [ -f ${S}/Build.PL ]; then 252 find "${D}" -depth -mindepth 1 -type d -empty -delete
264 if [ ${PN} == "module-build" ]; then 253}
265 BUILDER_VER="1" # A bootstrapping if you will 254
255linkduallifescripts() {
256 if [[ ${CATEGORY} != perl-core ]] || ! has_version ">=dev-lang/perl-5.8.8-r8" ; then
257 return 0
258 fi
259
260 local i ff
261 if has "${EBUILD_PHASE:-none}" "postinst" "postrm" ; then
262 for i in "${DUALLIFESCRIPTS[@]}" ; do
263 alternatives_auto_makesym "/usr/bin/${i}" "/usr/bin/${i}-[0-9]*"
264 ff=`echo "${ROOT}"/usr/share/man/man1/${i}-${PV}-${P}.1*`
265 ff=${ff##*.1}
266 alternatives_auto_makesym "/usr/share/man/man1/${i}.1${ff}" "/usr/share/man/man1/${i}-[0-9]*"
267 done
266 else 268 else
267 BUILDER_VER=`perl -MModule::Build -e 'print "$Module::Build::VERSION;"' ` 269 pushd "${D}" > /dev/null
268 fi 270 for i in $(find usr/bin -maxdepth 1 -type f 2>/dev/null) ; do
271 mv ${i}{,-${PV}-${P}} || die
272 DUALLIFESCRIPTS[${#DUALLIFESCRIPTS[*]}]=${i##*/}
273 if [[ -f usr/share/man/man1/${i##*/}.1 ]] ; then
274 mv usr/share/man/man1/${i##*/}{.1,-${PV}-${P}.1} || die
269 fi 275 fi
270 fi
271 fi
272
273 if [ -f /usr/bin/perl ]
274 then
275 POD_DIR="/usr/share/perl/gentoo-pods/${version}"
276 fi
277}
278
279fixlocalpod() {
280 perlinfo
281
282 if [ -f ${D}${ARCH_LIB}/perllocal.pod ];
283 then
284 rm -f ${D}/${ARCH_LIB}/perllocal.pod
285 fi
286
287 if [ -f ${D}${SITE_LIB}/perllocal.pod ];
288 then
289 rm -f ${D}/${SITE_LIB}/perllocal.pod
290 fi
291
292 if [ -f ${D}${VENDOR_LIB}/perllocal.pod ];
293 then
294 rm -f ${D}/${VENDOR_LIB}/perllocal.pod
295 fi
296}
297
298updatepod() {
299 perlinfo
300
301 if [ -d "${POD_DIR}" ]
302 then
303 for FILE in `find ${POD_DIR} -type f -name "*.pod.arch"`; do
304 cat ${FILE} >> ${ARCH_LIB}/perllocal.pod
305 rm -f ${FILE}
306 done 276 done
307 for FILE in `find ${POD_DIR} -type f -name "*.pod.site"`; do 277 popd > /dev/null
308 cat ${FILE} >> ${SITE_LIB}/perllocal.pod
309 rm -f ${FILE}
310 done
311 for FILE in `find ${POD_DIR} -type f -name "*.pod.vendor"`; do
312 cat ${FILE} >> ${VENDOR_LIB}/perllocal.pod
313 rm -f ${FILE}
314 done
315 fi 278 fi
316} 279}

Legend:
Removed from v.1.112  
changed lines
  Added in v.1.119

  ViewVC Help
Powered by ViewVC 1.1.20