/[gentoo-x86]/eclass/ruby-fakegem.eclass
Gentoo

Diff of /eclass/ruby-fakegem.eclass

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

Revision 1.1 Revision 1.31
1# Copyright 1999-2009 Gentoo Foundation 1# Copyright 1999-2011 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/ruby-fakegem.eclass,v 1.1 2009/12/14 12:32:18 a3li Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/ruby-fakegem.eclass,v 1.31 2011/10/21 06:32:29 graaff Exp $
4# 4
5# @ECLASS: ruby-fakegem.eclass 5# @ECLASS: ruby-fakegem.eclass
6# @MAINTAINER: 6# @MAINTAINER:
7# Ruby herd <ruby@gentoo.org> 7# Ruby herd <ruby@gentoo.org>
8# 8# @AUTHOR:
9# Author: Diego E. Pettenò <flameeyes@gentoo.org> 9# Author: Diego E. Pettenò <flameeyes@gentoo.org>
10#
11# Author: Alex Legler <a3li@gentoo.org> 10# Author: Alex Legler <a3li@gentoo.org>
12#
13# @BLURB: An eclass for installing Ruby packages to behave like RubyGems. 11# @BLURB: An eclass for installing Ruby packages to behave like RubyGems.
14# @DESCRIPTION: 12# @DESCRIPTION:
15# This eclass allows to install arbitrary Ruby libraries (including Gems), 13# This eclass allows to install arbitrary Ruby libraries (including Gems),
16# providing integration into the RubyGems system even for "regular" packages. 14# providing integration into the RubyGems system even for "regular" packages.
17#
18 15
19inherit ruby-ng 16inherit ruby-ng
20 17
21# @ECLASS-VARIABLE: RUBY_FAKEGEM_NAME 18# @ECLASS-VARIABLE: RUBY_FAKEGEM_NAME
22# @DESCRIPTION: 19# @DESCRIPTION:
29# RUBY_FAKEGEM_VERSION="${PV}" 26# RUBY_FAKEGEM_VERSION="${PV}"
30 27
31# @ECLASS-VARIABLE: RUBY_FAKEGEM_TASK_DOC 28# @ECLASS-VARIABLE: RUBY_FAKEGEM_TASK_DOC
32# @DESCRIPTION: 29# @DESCRIPTION:
33# Specify the rake(1) task to run to generate documentation. 30# Specify the rake(1) task to run to generate documentation.
34# RUBY_FAKEGEM_VERSION="rdoc" 31# RUBY_FAKEGEM_TASK_DOC="rdoc"
35 32
36# @ECLASS-VARIABLE: RUBY_FAKEGEM_TASK_TEST 33# @ECLASS-VARIABLE: RUBY_FAKEGEM_TASK_TEST
37# @DESCRIPTION: 34# @DESCRIPTION:
38# Specify the rake(1) task used for executing tests. 35# Specify the rake(1) task used for executing tests.
39# RUBY_FAKEGEM_VERSION="test" 36# RUBY_FAKEGEM_TASK_TEST="test"
37
38# @ECLASS-VARIABLE: RUBY_FAKEGEM_DOCDIR
39# @DESCRIPTION:
40# Specify the directory under which the documentation is built;
41# if empty no documentation will be installed automatically.
42# RUBY_FAKEGEM_DOCDIR=""
43
44# @ECLASS-VARIABLE: RUBY_FAKEGEM_EXTRADOC
45# @DESCRIPTION:
46# Extra documentation to install (readme, changelogs, …).
47# RUBY_FAKEGEM_EXTRADOC=""
48
49# @ECLASS-VARIABLE: RUBY_FAKEGEM_BINWRAP
50# @DESCRIPTION:
51# Binaries to wrap around (relative to the bin/ directory)
52# RUBY_FAKEGEM_BINWRAP="*"
53
54# @ECLASS-VARIABLE: RUBY_FAKEGEM_REQUIRE_PATHS
55# @DESCRIPTION:
56# Extra require paths (beside lib) to add to the specification
57# RUBY_FAKEGEM_REQUIRE_PATHS=""
58
59# @ECLASS-VARIABLE: RUBY_FAKEGEM_GEMSPEC
60# @DESCRIPTION:
61# Filename of .gemspec file to install instead of generating a generic one.
62# RUBY_FAKEGEM_GEMSPEC=""
40 63
41RUBY_FAKEGEM_NAME="${RUBY_FAKEGEM_NAME:-${PN}}" 64RUBY_FAKEGEM_NAME="${RUBY_FAKEGEM_NAME:-${PN}}"
42RUBY_FAKEGEM_VERSION="${RUBY_FAKEGEM_VERSION:-${PV}}" 65RUBY_FAKEGEM_VERSION="${RUBY_FAKEGEM_VERSION:-${PV/_pre/.pre}}"
66RUBY_FAKEGEM_SUFFIX="${RUBY_FAKEGEM_SUFFIX:-}"
43 67
44RUBY_FAKEGEM_TASK_DOC="${RUBY_FAKEGEM_TASK_DOC-rdoc}" 68RUBY_FAKEGEM_TASK_DOC="${RUBY_FAKEGEM_TASK_DOC-rdoc}"
45RUBY_FAKEGEM_TASK_TEST="${RUBY_FAKEGEM_TASK_TEST-test}" 69RUBY_FAKEGEM_TASK_TEST="${RUBY_FAKEGEM_TASK_TEST-test}"
46 70
71RUBY_FAKEGEM_BINWRAP="${RUBY_FAKEGEM_BINWRAP-*}"
72
47if [[ ${RUBY_FAKEGEM_TASK_DOC} != "" ]]; then 73if [[ ${RUBY_FAKEGEM_TASK_DOC} != "" ]]; then
48 IUSE="$IUSE doc" 74 IUSE="$IUSE doc"
49 ruby_add_bdepend doc "dev-ruby/rake" 75 ruby_add_bdepend "doc? ( dev-ruby/rake )"
76fi
77
78if [[ -n ${RUBY_FAKEGEM_DOCDIR} ]]; then
79 IUSE="$IUSE doc"
50fi 80fi
51 81
52if [[ ${RUBY_FAKEGEM_TASK_TEST} != "" ]]; then 82if [[ ${RUBY_FAKEGEM_TASK_TEST} != "" ]]; then
53 IUSE="$IUSE test" 83 IUSE="$IUSE test"
54 ruby_add_bdepend test "dev-ruby/rake" 84 ruby_add_bdepend "test? ( dev-ruby/rake )"
55fi 85fi
56 86
87SRC_URI="mirror://rubygems/${RUBY_FAKEGEM_NAME}-${RUBY_FAKEGEM_VERSION}${RUBY_FAKEGEM_SUFFIX:+-${RUBY_FAKEGEM_SUFFIX}}.gem"
88
89ruby_add_bdepend virtual/rubygems
57ruby_add_rdepend virtual/rubygems 90ruby_add_rdepend virtual/rubygems
58 91
59# @FUNCTION: ruby_fakegem_gemsdir 92# @FUNCTION: ruby_fakegem_gemsdir
60# @RETURN: Returns the gem data directory 93# @RETURN: Returns the gem data directory
61# @DESCRIPTION: 94# @DESCRIPTION:
62# This function returns the gems data directory for the ruby 95# This function returns the gems data directory for the ruby
63# implementation in question. 96# implementation in question.
64ruby_fakegem_gemsdir() { 97ruby_fakegem_gemsdir() {
65 local _gemsitedir=$(${RUBY} -r rbconfig -e 'print Config::CONFIG["sitelibdir"]' | sed -e 's:site_ruby:gems:') 98 has "${EAPI}" 2 && ! use prefix && EPREFIX=
99
100 local _gemsitedir=$(ruby_rbconfig_value 'sitelibdir')
101 _gemsitedir=${_gemsitedir//site_ruby/gems}
102 _gemsitedir=${_gemsitedir#${EPREFIX}}
66 103
67 [[ -z ${_gemsitedir} ]] && { 104 [[ -z ${_gemsitedir} ]] && {
68 eerror "Unable to find the gems dir" 105 eerror "Unable to find the gems dir"
69 die "Unable to find the gems dir" 106 die "Unable to find the gems dir"
70 } 107 }
99 insinto $(ruby_fakegem_gemsdir)/gems/${RUBY_FAKEGEM_NAME}-${RUBY_FAKEGEM_VERSION}${newdirname} 136 insinto $(ruby_fakegem_gemsdir)/gems/${RUBY_FAKEGEM_NAME}-${RUBY_FAKEGEM_VERSION}${newdirname}
100 newins "$1" ${newbasename} 137 newins "$1" ${newbasename}
101 ) || die "failed $0 $@" 138 ) || die "failed $0 $@"
102} 139}
103 140
141# @FUNCTION: ruby_fakegem_install_gemspec
142# @DESCRIPTION:
143# Install a .gemspec file for this package. Either use the file indicated
144# by the RUBY_FAKEGEM_GEMSPEC variable, or generate one using
145# ruby_fakegem_genspec.
146ruby_fakegem_install_gemspec() {
147 local gemspec="${T}"/${RUBY_FAKEGEM_NAME}-${_ruby_implementation}
148
149 (
150 if [[ ${RUBY_FAKEGEM_GEMSPEC} != "" ]]; then
151 ruby_fakegem_gemspec_gemspec ${RUBY_FAKEGEM_GEMSPEC} ${gemspec}
152 else
153 local metadata="${WORKDIR}"/${_ruby_implementation}/metadata
154
155 if [[ -e ${metadata} ]]; then
156 ruby_fakegem_metadata_gemspec ${metadata} ${gemspec}
157 else
158 ruby_fakegem_genspec ${gemspec}
159 fi
160 fi
161 ) || die "Unable to generate gemspec file."
162
163 insinto $(ruby_fakegem_gemsdir)/specifications
164 newins ${gemspec} ${RUBY_FAKEGEM_NAME}-${RUBY_FAKEGEM_VERSION}.gemspec || die "Unable to install gemspec file."
165}
166
167# @FUNCTION: ruby_fakegem_gemspec_gemspec
168# @USAGE: gemspec-input gemspec-output
169# @DESCRIPTION:
170# Generates an installable version of the specification indicated by
171# RUBY_FAKEGEM_GEMSPEC. This file is eval'ed to produce a final specification
172# in a way similar to packaging the gemspec file.
173ruby_fakegem_gemspec_gemspec() {
174 ${RUBY} -e "puts eval(File::open('$1').read).to_ruby" > $2
175}
176
177# @FUNCTION: ruby_fakegem_metadata_gemspec
178# @USAGE: gemspec-metadata gemspec-output
179# @DESCRIPTION:
180# Generates an installable version of the specification indicated by
181# the metadata distributed by the gem itself. This is similar to how
182# rubygems creates an installation from a .gem file.
183ruby_fakegem_metadata_gemspec() {
184 ${RUBY} -r yaml -e "puts Gem::Specification.from_yaml(File::open('$1').read).to_ruby" > $2
185}
186
104# @FUNCTION: ruby_fakegem_genspec 187# @FUNCTION: ruby_fakegem_genspec
188# @USAGE: output-gemspec
105# @DESCRIPTION: 189# @DESCRIPTION:
106# Generates a gemspec for the package and places it into the "specifications" 190# Generates a gemspec for the package and places it into the "specifications"
107# directory of RubyGems. 191# directory of RubyGems.
192# If the metadata normally distributed with a gem is present then that is
193# used to generate the gemspec file.
194#
195# As a fallback we can generate our own version.
108# In the gemspec, the following values are set: name, version, summary, 196# In the gemspec, the following values are set: name, version, summary,
109# homepage, and require_paths=["lib"]. 197# homepage, and require_paths=["lib"].
110# See RUBY_FAKEGEM_NAME and RUBY_FAKEGEM_VERSION for setting name and version. 198# See RUBY_FAKEGEM_NAME and RUBY_FAKEGEM_VERSION for setting name and version.
199# See RUBY_FAKEGEM_REQUIRE_PATHS for setting extra require paths.
111ruby_fakegem_genspec() { 200ruby_fakegem_genspec() {
112 ( 201 local required_paths="'lib'"
202 for path in ${RUBY_FAKEGEM_REQUIRE_PATHS}; do
203 required_paths="${required_paths}, '${path}'"
204 done
205
113 # We use the _ruby_implementation variable to avoid having stray 206 # We use the _ruby_implementation variable to avoid having stray
114 # copies with different implementations; while for now we're using 207 # copies with different implementations; while for now we're using
115 # the same exact content, we might have differences in the future, 208 # the same exact content, we might have differences in the future,
116 # so better taking this into consideration. 209 # so better taking this into consideration.
117 cat - > "${T}"/${RUBY_FAKEGEM_NAME}-${_ruby_implementation} <<EOF 210 local quoted_description=${DESCRIPTION//\"/\\\"}
211 cat - > $1 <<EOF
212# generated by ruby-fakegem.eclass $Revision: 1.31 $
118Gem::Specification.new do |s| 213Gem::Specification.new do |s|
119 s.name = "${RUBY_FAKEGEM_NAME}" 214 s.name = "${RUBY_FAKEGEM_NAME}"
120 s.version = "${RUBY_FAKEGEM_VERSION}" 215 s.version = "${RUBY_FAKEGEM_VERSION}"
121 s.summary = "${DESCRIPTION}" 216 s.summary = "${quoted_description}"
122 s.homepage = "${HOMEPAGE}" 217 s.homepage = "${HOMEPAGE}"
123 s.require_paths = ["lib"] 218 s.require_paths = [${required_paths}]
124end 219end
125EOF 220EOF
126
127 insinto $(ruby_fakegem_gemsdir)/specifications
128 newins "${T}"/${RUBY_FAKEGEM_NAME}-${_ruby_implementation} ${RUBY_FAKEGEM_NAME}-${RUBY_FAKEGEM_VERSION}.gemspec
129 ) || die "Unable to install fake gemspec"
130} 221}
131 222
132# @FUNCTION: ruby_fakegem_binwrapper 223# @FUNCTION: ruby_fakegem_binwrapper
133# @USAGE: command [path] 224# @USAGE: command [path]
134# @DESCRIPTION: 225# @DESCRIPTION:
136# path defaults to /usr/bin/$command 227# path defaults to /usr/bin/$command
137ruby_fakegem_binwrapper() { 228ruby_fakegem_binwrapper() {
138 ( 229 (
139 local gembinary=$1 230 local gembinary=$1
140 local newbinary=${2:-/usr/bin/$gembinary} 231 local newbinary=${2:-/usr/bin/$gembinary}
232 local relativegembinary=${RUBY_FAKEGEM_NAME}-${RUBY_FAKEGEM_VERSION}/bin/${gembinary}
233 local binpath=$(dirname $newbinary)
234 [[ ${binpath} = . ]] && binpath=/usr/bin
235
236 # Try to find out whether the package is going to install for
237 # one or multiple implementations; if we're installing for a
238 # *single* implementation, no need to use “/usr/bin/env ruby”
239 # in the shebang, and we can actually avoid errors when
240 # calling the script by default (see for instance the
241 # JRuby-specific commands).
242 local rubycmd=
243 for implementation in ${USE_RUBY}; do
244 # ignore non-enabled implementations
245 use ruby_targets_${implementation} || continue
246 if [ -z $rubycmd ]; then
247 # if no other implementation was set before, set it.
248 rubycmd="$(ruby_implementation_command ${implementation})"
249 else
250 # if another implementation already arrived, then make
251 # it generic and break out of the loop. This ensures
252 # that we do at most two iterations.
253 rubycmd="/usr/bin/env ruby"
254 break
255 fi
256 done
141 257
142 cat - > "${T}"/gembin-wrapper-${gembinary} <<EOF 258 cat - > "${T}"/gembin-wrapper-${gembinary} <<EOF
143#!/usr/bin/env ruby 259#!${rubycmd}
144# This is a simplified version of the RubyGems wrapper 260# This is a simplified version of the RubyGems wrapper
145# 261#
146# Generated by ruby-fakegem.eclass 262# Generated by ruby-fakegem.eclass $Revision: 1.31 $
147 263
148require 'rubygems' 264require 'rubygems'
149 265
150load Gem::GemPathSearcher.new.find('$(tr [A-Z] [a-z] <<< ${RUBY_FAKEGEM_NAME})').full_gem_path + "/bin/${gembinary}" 266load Gem::default_path[-1] + "/gems/${relativegembinary}"
151 267
152EOF 268EOF
153 269
154 exeinto $(dirname $newbinary) 270 exeinto ${binpath:-/usr/bin}
155 newexe "${T}"/gembin-wrapper-${gembinary} $(basename $newbinary) 271 newexe "${T}"/gembin-wrapper-${gembinary} $(basename $newbinary)
156 ) || die "Unable to create fakegem wrapper" 272 ) || die "Unable to create fakegem wrapper"
157} 273}
158 274
159# @FUNCTION: all_fakegem_compile 275# @FUNCTION: all_fakegem_compile
171# Unpack the source archive, including support for unpacking gems. 287# Unpack the source archive, including support for unpacking gems.
172all_ruby_unpack() { 288all_ruby_unpack() {
173 # Special support for extracting .gem files; the file need to be 289 # Special support for extracting .gem files; the file need to be
174 # extracted twice and the mtime from the archive _has_ to be 290 # extracted twice and the mtime from the archive _has_ to be
175 # ignored (it's always set to epoch 0). 291 # ignored (it's always set to epoch 0).
176 # 292 for archive in ${A}; do
177 # This only works if there is exactly one archive and that archive 293 case "${archive}" in
178 # is a .gem file! 294 *.gem)
179 if [[ $(wc -w <<< ${A}) == 1 ]] && 295 # Make sure that we're not running unpack for more than
180 [[ ${A} == *.gem ]]; then 296 # one .gem file, since we won't support that at all.
297 [[ -d "${S}" ]] && die "Unable to unpack ${archive}, ${S} exists"
298
181 ebegin "Unpacking .gem file..." 299 ebegin "Unpacking .gem file..."
182 tar -mxf ${DISTDIR}/${A} || die 300 tar -mxf ${DISTDIR}/${archive} || die
183 eend $? 301 eend $?
184 302
303 ebegin "Uncompressing metadata"
304 gunzip metadata.gz || die
305 eend $?
306
185 mkdir "${S}" 307 mkdir "${S}"
186 pushd "${S}" 308 pushd "${S}" &>/dev/null
187 309
188 ebegin "Unpacking data.tar.gz" 310 ebegin "Unpacking data.tar.gz"
189 tar -mxf "${my_WORKDIR}"/data.tar.gz || die 311 tar -mxf "${my_WORKDIR}"/data.tar.gz || die
190 eend $? 312 eend $?
191 else 313
192 [[ -n ${A} ]] && unpack ${A} 314 popd &>/dev/null
193 fi 315 ;;
316 *.patch.bz2)
317 # We apply the patches with RUBY_PATCHES directly from DISTDIR,
318 # as the WORKDIR variable changes value between the global-scope
319 # and the time all_ruby_unpack/_prepare are called. Since we can
320 # simply decompress them when applying, this is much easier to
321 # deal with for us.
322 einfo "Keeping ${archive} as-is"
323 ;;
324 *)
325 unpack ${archive}
326 ;;
327 esac
328 done
194} 329}
195 330
196# @FUNCTION: all_ruby_compile 331# @FUNCTION: all_ruby_compile
197# @DESCRIPTION: 332# @DESCRIPTION:
198# Compile the package. 333# Compile the package.
203# @FUNCTION: each_fakegem_test 338# @FUNCTION: each_fakegem_test
204# @DESCRIPTION: 339# @DESCRIPTION:
205# Run tests for the package for each ruby target if the test task is defined. 340# Run tests for the package for each ruby target if the test task is defined.
206each_fakegem_test() { 341each_fakegem_test() {
207 local rubyflags= 342 local rubyflags=
208
209 if [[ ${RUBY_FAKEGEM_TASK_TEST} != "" ]]; then
210 ${RUBY} ${rubyflags} -S rake ${RUBY_FAKEGEM_TASK_TEST} || die "tests failed" 343 ${RUBY} ${rubyflags} -S rake ${RUBY_FAKEGEM_TASK_TEST} || die "tests failed"
211 else
212 echo "No test task defined, skipping tests."
213 fi
214} 344}
215 345
346if [[ ${RUBY_FAKEGEM_TASK_TEST} != "" ]]; then
216# @FUNCTION: each_ruby_test 347 # @FUNCTION: each_ruby_test
217# @DESCRIPTION: 348 # @DESCRIPTION:
218# Run the tests for this package. 349 # Run the tests for this package.
219each_ruby_test() { 350 each_ruby_test() {
220 each_fakegem_test 351 each_fakegem_test
221} 352 }
353fi
222 354
223# @FUNCTION: each_fakegem_install 355# @FUNCTION: each_fakegem_install
224# @DESCRIPTION: 356# @DESCRIPTION:
225# Install the package for each ruby target. 357# Install the package for each ruby target.
226each_fakegem_install() { 358each_fakegem_install() {
227 ruby_fakegem_genspec 359 ruby_fakegem_install_gemspec
228 360
229 local _gemlibdirs= 361 local _gemlibdirs="${RUBY_FAKEGEM_EXTRAINSTALL}"
230 for directory in bin lib ${RUBY_FAKEGEM_EXTRAINSTALL}; do 362 for directory in bin lib; do
231 [[ -d ${directory} ]] && _gemlibdirs="${_gemlibdirs} ${directory}" 363 [[ -d ${directory} ]] && _gemlibdirs="${_gemlibdirs} ${directory}"
232 done 364 done
233 365
366 [[ -n ${_gemlibdirs} ]] && \
234 ruby_fakegem_doins -r ${_gemlibdirs} 367 ruby_fakegem_doins -r ${_gemlibdirs}
235} 368}
236 369
237# @FUNCTION: each_ruby_install 370# @FUNCTION: each_ruby_install
238# @DESCRIPTION: 371# @DESCRIPTION:
239# Install the package for each target. 372# Install the package for each target.
244# @FUNCTION: all_fakegem_install 377# @FUNCTION: all_fakegem_install
245# @DESCRIPTION: 378# @DESCRIPTION:
246# Install files common to all ruby targets. 379# Install files common to all ruby targets.
247all_fakegem_install() { 380all_fakegem_install() {
248 if [[ -n ${RUBY_FAKEGEM_DOCDIR} ]] && use doc; then 381 if [[ -n ${RUBY_FAKEGEM_DOCDIR} ]] && use doc; then
249 pushd ${RUBY_FAKEGEM_DOCDIR} 382 for dir in ${RUBY_FAKEGEM_DOCDIR}; do
383 [[ -d ${dir} ]] || continue
384
385 pushd ${dir} &>/dev/null
250 dohtml -r * || die "failed to install documentation" 386 dohtml -r * || die "failed to install documentation"
251 popd 387 popd &>/dev/null
388 done
252 fi 389 fi
253 390
254 if [[ -n ${RUBY_FAKEGEM_EXTRADOC} ]]; then 391 if [[ -n ${RUBY_FAKEGEM_EXTRADOC} ]]; then
255 dodoc ${RUBY_FAKEGEM_EXTRADOC} || die "failed to install further documentation" 392 dodoc ${RUBY_FAKEGEM_EXTRADOC} || die "failed to install further documentation"
256 fi 393 fi
394
395 # binary wrappers; we assume that all the implementations get the
396 # same binaries, or something is wrong anyway, so...
397 if [[ -n ${RUBY_FAKEGEM_BINWRAP} ]]; then
398 local bindir=$(find "${D}" -type d -path "*/gems/${RUBY_FAKEGEM_NAME}-${RUBY_FAKEGEM_VERSION}/bin" -print -quit)
399
400 if [[ -d "${bindir}" ]]; then
401 pushd "${bindir}" &>/dev/null
402 local binaries=$(eval ls ${RUBY_FAKEGEM_BINWRAP})
403 for binary in $binaries; do
404 ruby_fakegem_binwrapper $binary
405 done
406 popd &>/dev/null
407 fi
408 fi
257} 409}
258 410
259# @FUNCTION: all_ruby_install 411# @FUNCTION: all_ruby_install
260# @DESCRIPTION: 412# @DESCRIPTION:
261# Install files common to all ruby targets. 413# Install files common to all ruby targets.

Legend:
Removed from v.1.1  
changed lines
  Added in v.1.31

  ViewVC Help
Powered by ViewVC 1.1.20