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