2012-12-18 07:16:27 +04:00
|
|
|
|
# -*- coding: utf-8 -*-
|
2007-11-10 10:48:56 +03:00
|
|
|
|
#--
|
|
|
|
|
# Copyright 2006 by Chad Fowler, Rich Kilmer, Jim Weirich and others.
|
|
|
|
|
# All rights reserved.
|
|
|
|
|
# See LICENSE.txt for permissions.
|
|
|
|
|
#++
|
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
|
2013-07-09 02:41:03 +04:00
|
|
|
|
require 'rubygems/version'
|
|
|
|
|
require 'rubygems/requirement'
|
|
|
|
|
require 'rubygems/platform'
|
|
|
|
|
require 'rubygems/deprecate'
|
2013-09-14 12:59:02 +04:00
|
|
|
|
require 'rubygems/basic_specification'
|
|
|
|
|
require 'rubygems/stub_specification'
|
2013-11-19 04:34:13 +04:00
|
|
|
|
require 'rubygems/util/stringio'
|
2013-07-09 02:41:03 +04:00
|
|
|
|
|
|
|
|
|
# :stopdoc:
|
|
|
|
|
# date.rb can't be loaded for `make install` due to miniruby
|
|
|
|
|
# Date is needed for old gems that stored #date as Date instead of Time.
|
|
|
|
|
class Date; end
|
|
|
|
|
# :startdoc:
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
|
|
|
|
# The Specification class contains the information for a Gem. Typically
|
|
|
|
|
# defined in a .gemspec file or a Rakefile, and looks like this:
|
|
|
|
|
#
|
|
|
|
|
# Gem::Specification.new do |s|
|
|
|
|
|
# s.name = 'example'
|
|
|
|
|
# s.version = '0.1.0'
|
2013-11-22 03:27:30 +04:00
|
|
|
|
# s.licenses = ['MIT']
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# s.summary = "This is an example!"
|
|
|
|
|
# s.description = "Much longer explanation of the example!"
|
|
|
|
|
# s.authors = ["Ruby Coder"]
|
|
|
|
|
# s.email = 'rubycoder@example.com'
|
|
|
|
|
# s.files = ["lib/example.rb"]
|
2013-03-01 02:25:55 +04:00
|
|
|
|
# s.homepage = 'https://rubygems.org/gems/example'
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# end
|
|
|
|
|
#
|
2013-09-14 12:59:02 +04:00
|
|
|
|
# Starting in RubyGems 2.0, a Specification can hold arbitrary
|
2013-10-16 04:14:16 +04:00
|
|
|
|
# metadata. See #metadata for restrictions on the format and size of metadata
|
|
|
|
|
# items you may add to a specification.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
class Gem::Specification < Gem::BasicSpecification
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# REFACTOR: Consider breaking out this version stuff into a separate
|
|
|
|
|
# module. There's enough special stuff around it that it may justify
|
|
|
|
|
# a separate class.
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# The version number of a specification that does not specify one
|
2009-06-10 01:38:59 +04:00
|
|
|
|
# (i.e. RubyGems 0.7 or earlier).
|
|
|
|
|
|
|
|
|
|
NONEXISTENT_SPECIFICATION_VERSION = -1
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# The specification version applied to any new Specification instances
|
|
|
|
|
# created. This should be bumped whenever something in the spec format
|
|
|
|
|
# changes.
|
2011-06-01 07:45:05 +04:00
|
|
|
|
#
|
|
|
|
|
# Specification Version History:
|
|
|
|
|
#
|
|
|
|
|
# spec ruby
|
|
|
|
|
# ver ver yyyy-mm-dd description
|
|
|
|
|
# -1 <0.8.0 pre-spec-version-history
|
|
|
|
|
# 1 0.8.0 2004-08-01 Deprecated "test_suite_file" for "test_files"
|
|
|
|
|
# "test_file=x" is a shortcut for "test_files=[x]"
|
|
|
|
|
# 2 0.9.5 2007-10-01 Added "required_rubygems_version"
|
|
|
|
|
# Now forward-compatible with future versions
|
|
|
|
|
# 3 1.3.2 2009-01-03 Added Fixnum validation to specification_version
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# 4 1.9.0 2011-06-07 Added metadata
|
2009-06-10 01:38:59 +04:00
|
|
|
|
#--
|
|
|
|
|
# When updating this number, be sure to also update #to_ruby.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
#
|
2009-06-10 01:38:59 +04:00
|
|
|
|
# NOTE RubyGems < 1.2 cannot load specification versions > 2.
|
|
|
|
|
|
2013-10-20 05:33:19 +04:00
|
|
|
|
CURRENT_SPECIFICATION_VERSION = 4 # :nodoc:
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# An informal list of changes to the specification. The highest-valued
|
|
|
|
|
# key should be equal to the CURRENT_SPECIFICATION_VERSION.
|
|
|
|
|
|
2013-10-20 05:33:19 +04:00
|
|
|
|
SPECIFICATION_VERSION_HISTORY = { # :nodoc:
|
2012-11-29 10:52:18 +04:00
|
|
|
|
-1 => ['(RubyGems versions up to and including 0.7 did not have versioned specifications)'],
|
|
|
|
|
1 => [
|
|
|
|
|
'Deprecated "test_suite_file" in favor of the new, but equivalent, "test_files"',
|
|
|
|
|
'"test_file=x" is a shortcut for "test_files=[x]"'
|
|
|
|
|
],
|
|
|
|
|
2 => [
|
|
|
|
|
'Added "required_rubygems_version"',
|
|
|
|
|
'Now forward-compatible with future versions',
|
|
|
|
|
],
|
|
|
|
|
3 => [
|
|
|
|
|
'Added Fixnum validation to the specification_version'
|
|
|
|
|
],
|
|
|
|
|
4 => [
|
|
|
|
|
'Added sandboxed freeform metadata to the specification version.'
|
|
|
|
|
]
|
|
|
|
|
}
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2013-10-20 05:33:19 +04:00
|
|
|
|
MARSHAL_FIELDS = { # :nodoc:
|
|
|
|
|
-1 => 16,
|
|
|
|
|
1 => 16,
|
|
|
|
|
2 => 16,
|
|
|
|
|
3 => 17,
|
|
|
|
|
4 => 18,
|
|
|
|
|
}
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
today = Time.now.utc
|
2013-10-20 05:33:19 +04:00
|
|
|
|
TODAY = Time.utc(today.year, today.month, today.day) # :nodoc:
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2013-10-20 05:33:19 +04:00
|
|
|
|
LOAD_CACHE = {} # :nodoc:
|
2013-09-14 12:59:02 +04:00
|
|
|
|
|
|
|
|
|
private_constant :LOAD_CACHE if defined? private_constant
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
# :startdoc:
|
|
|
|
|
|
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# List of attribute names: [:name, :version, ...]
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@@required_attributes = [:rubygems_version,
|
|
|
|
|
:specification_version,
|
|
|
|
|
:name,
|
|
|
|
|
:version,
|
|
|
|
|
:date,
|
|
|
|
|
:summary,
|
|
|
|
|
:require_paths]
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Map of attribute names to default values.
|
|
|
|
|
|
|
|
|
|
@@default_value = {
|
|
|
|
|
:authors => [],
|
|
|
|
|
:autorequire => nil,
|
|
|
|
|
:bindir => 'bin',
|
|
|
|
|
:cert_chain => [],
|
|
|
|
|
:date => TODAY,
|
|
|
|
|
:dependencies => [],
|
|
|
|
|
:description => nil,
|
|
|
|
|
:email => nil,
|
|
|
|
|
:executables => [],
|
|
|
|
|
:extensions => [],
|
|
|
|
|
:extra_rdoc_files => [],
|
|
|
|
|
:files => [],
|
|
|
|
|
:homepage => nil,
|
|
|
|
|
:licenses => [],
|
2012-11-29 10:52:18 +04:00
|
|
|
|
:metadata => {},
|
2011-06-01 07:45:05 +04:00
|
|
|
|
:name => nil,
|
|
|
|
|
:platform => Gem::Platform::RUBY,
|
|
|
|
|
:post_install_message => nil,
|
|
|
|
|
:rdoc_options => [],
|
|
|
|
|
:require_paths => ['lib'],
|
|
|
|
|
:required_ruby_version => Gem::Requirement.default,
|
|
|
|
|
:required_rubygems_version => Gem::Requirement.default,
|
|
|
|
|
:requirements => [],
|
|
|
|
|
:rubyforge_project => nil,
|
|
|
|
|
:rubygems_version => Gem::VERSION,
|
|
|
|
|
:signing_key => nil,
|
|
|
|
|
:specification_version => CURRENT_SPECIFICATION_VERSION,
|
|
|
|
|
:summary => nil,
|
|
|
|
|
:test_files => [],
|
|
|
|
|
:version => nil,
|
|
|
|
|
}
|
|
|
|
|
|
2013-10-20 05:33:19 +04:00
|
|
|
|
Dupable = { } # :nodoc:
|
2013-09-14 12:59:02 +04:00
|
|
|
|
|
|
|
|
|
@@default_value.each do |k,v|
|
|
|
|
|
case v
|
|
|
|
|
when Time, Numeric, Symbol, true, false, nil
|
|
|
|
|
Dupable[k] = false
|
|
|
|
|
else
|
|
|
|
|
Dupable[k] = true
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@@attributes = @@default_value.keys.sort_by { |s| s.to_s }
|
|
|
|
|
@@array_attributes = @@default_value.reject { |k,v| v != [] }.keys
|
|
|
|
|
@@nil_attributes, @@non_nil_attributes = @@default_value.keys.partition { |k|
|
|
|
|
|
@@default_value[k].nil?
|
|
|
|
|
}
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
######################################################################
|
|
|
|
|
# :section: Required gemspec attributes
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# This gem's name.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.name = 'rake'
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_accessor :name
|
|
|
|
|
|
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# This gem's version.
|
|
|
|
|
#
|
|
|
|
|
# The version string can contain numbers and periods, such as +1.0.0+.
|
|
|
|
|
# A gem is a 'prerelease' gem if the version has a letter in it, such as
|
|
|
|
|
# +1.0.0.pre+.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.version = '0.4.1'
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_reader :version
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# Paths in the gem to add to <code>$LOAD_PATH</code> when this gem is
|
|
|
|
|
# activated.
|
|
|
|
|
#
|
2013-10-16 04:14:16 +04:00
|
|
|
|
# See also #require_paths
|
|
|
|
|
#
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# If you have an extension you do not need to add <code>"ext"</code> to the
|
|
|
|
|
# require path, the extension build process will copy the extension files
|
|
|
|
|
# into "lib" for you.
|
|
|
|
|
#
|
|
|
|
|
# The default value is <code>"lib"</code>
|
2011-06-01 07:45:05 +04:00
|
|
|
|
#
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# # If all library files are in the root directory...
|
|
|
|
|
# spec.require_path = '.'
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
attr_writer :require_paths
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# The version of RubyGems used to create this gem.
|
|
|
|
|
#
|
|
|
|
|
# Do not set this, it is set automatically when the gem is packaged.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_accessor :rubygems_version
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# A short summary of this gem's description. Displayed in `gem list -d`.
|
2011-06-01 07:45:05 +04:00
|
|
|
|
#
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# The #description should be more detailed than the summary.
|
2012-11-29 10:52:18 +04:00
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.summary = "This is a small summary of my gem"
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
attr_reader :summary
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# The platform this gem runs on.
|
2011-06-01 07:45:05 +04:00
|
|
|
|
#
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# This is usually Gem::Platform::RUBY or Gem::Platform::CURRENT.
|
|
|
|
|
#
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# Most gems contain pure Ruby code; they should simply leave the default
|
|
|
|
|
# value in place. Some gems contain C (or other) code to be compiled into a
|
|
|
|
|
# Ruby "extension". The should leave the default value in place unless
|
|
|
|
|
# their code will only compile on a certain type of system. Some gems
|
|
|
|
|
# consist of pre-compiled code ("binary gems"). It's especially important
|
|
|
|
|
# that they set the platform attribute appropriately. A shortcut is to set
|
|
|
|
|
# the platform to Gem::Platform::CURRENT, which will cause the gem builder
|
|
|
|
|
# to set the platform to the appropriate value for the system on which the
|
|
|
|
|
# build is being performed.
|
2012-11-29 10:52:18 +04:00
|
|
|
|
#
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# If this attribute is set to a non-default value, it will be included in
|
|
|
|
|
# the filename of the gem when it is built such as:
|
|
|
|
|
# nokogiri-1.6.0-x86-mingw32.gem
|
2012-11-29 10:52:18 +04:00
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# spec.platform = Gem::Platform.local
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
def platform= platform
|
|
|
|
|
if @original_platform.nil? or
|
|
|
|
|
@original_platform == Gem::Platform::RUBY then
|
|
|
|
|
@original_platform = platform
|
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
case platform
|
|
|
|
|
when Gem::Platform::CURRENT then
|
|
|
|
|
@new_platform = Gem::Platform.local
|
|
|
|
|
@original_platform = @new_platform.to_s
|
|
|
|
|
|
|
|
|
|
when Gem::Platform then
|
|
|
|
|
@new_platform = platform
|
|
|
|
|
|
|
|
|
|
# legacy constants
|
|
|
|
|
when nil, Gem::Platform::RUBY then
|
|
|
|
|
@new_platform = Gem::Platform::RUBY
|
|
|
|
|
when 'mswin32' then # was Gem::Platform::WIN32
|
|
|
|
|
@new_platform = Gem::Platform.new 'x86-mswin32'
|
|
|
|
|
when 'i586-linux' then # was Gem::Platform::LINUX_586
|
|
|
|
|
@new_platform = Gem::Platform.new 'x86-linux'
|
|
|
|
|
when 'powerpc-darwin' then # was Gem::Platform::DARWIN
|
|
|
|
|
@new_platform = Gem::Platform.new 'ppc-darwin'
|
|
|
|
|
else
|
|
|
|
|
@new_platform = Gem::Platform.new platform
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
@platform = @new_platform.to_s
|
|
|
|
|
|
|
|
|
|
invalidate_memoized_attributes
|
|
|
|
|
|
|
|
|
|
@new_platform
|
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Files included in this gem. You cannot append to this accessor, you must
|
|
|
|
|
# assign to it.
|
2011-06-01 07:45:05 +04:00
|
|
|
|
#
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Only add files you can require to this list, not directories, etc.
|
|
|
|
|
#
|
|
|
|
|
# Directories are automatically stripped from this list when building a gem,
|
|
|
|
|
# other non-files cause an error.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# require 'rake'
|
|
|
|
|
# spec.files = FileList['lib/**/*.rb',
|
|
|
|
|
# 'bin/*',
|
|
|
|
|
# '[A-Z]*',
|
|
|
|
|
# 'test/**/*'].to_a
|
|
|
|
|
#
|
|
|
|
|
# # or without Rake...
|
|
|
|
|
# spec.files = Dir['lib/**/*.rb'] + Dir['bin/*']
|
|
|
|
|
# spec.files += Dir['[A-Z]*'] + Dir['test/**/*']
|
|
|
|
|
# spec.files.reject! { |fn| fn.include? "CVS" }
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
def files
|
|
|
|
|
# DO NOT CHANGE TO ||= ! This is not a normal accessor. (yes, it sucks)
|
|
|
|
|
# DOC: Why isn't it normal? Why does it suck? How can we fix this?
|
|
|
|
|
@files = [@files,
|
|
|
|
|
@test_files,
|
|
|
|
|
add_bindir(@executables),
|
|
|
|
|
@extra_rdoc_files,
|
|
|
|
|
@extensions,
|
2013-09-19 01:29:41 +04:00
|
|
|
|
].flatten.sort.uniq.compact
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
######################################################################
|
|
|
|
|
# :section: Optional gemspec attributes
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# The path in the gem for executable scripts. Usually 'bin'
|
2012-11-29 10:52:18 +04:00
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.bindir = 'bin'
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_accessor :bindir
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# The certificate chain used to sign this gem. See Gem::Security for
|
|
|
|
|
# details.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_accessor :cert_chain
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# A long description of this gem
|
2012-11-29 10:52:18 +04:00
|
|
|
|
#
|
|
|
|
|
# The description should be more detailed than the summary.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.description = <<-EOF
|
|
|
|
|
# Rake is a Make-like program implemented in Ruby. Tasks and
|
|
|
|
|
# dependencies are specified in standard Ruby syntax.
|
|
|
|
|
# EOF
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_reader :description
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# A contact email address (or addresses) for this gem
|
2009-06-10 01:38:59 +04:00
|
|
|
|
#
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.email = 'john.jones@example.com'
|
|
|
|
|
# spec.email = ['jack@example.com', 'jill@example.com']
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
attr_accessor :email
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# The URL of this gem's home page
|
2011-06-01 07:45:05 +04:00
|
|
|
|
#
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Usage:
|
2011-06-01 07:45:05 +04:00
|
|
|
|
#
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# spec.homepage = 'http://rake.rubyforge.org'
|
|
|
|
|
|
|
|
|
|
attr_accessor :homepage
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# A message that gets displayed after the gem is installed.
|
2011-06-01 07:45:05 +04:00
|
|
|
|
#
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.post_install_message = "Thanks for installing!"
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
attr_accessor :post_install_message
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# The key used to sign this gem. See Gem::Security for details.
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
attr_accessor :signing_key
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# :attr_accessor: metadata
|
|
|
|
|
#
|
2013-10-16 04:14:16 +04:00
|
|
|
|
# The metadata holds extra data for this gem that may be useful to other
|
|
|
|
|
# consumers and is settable by gem authors without requiring an update to
|
|
|
|
|
# the rubygems software.
|
2012-11-29 10:52:18 +04:00
|
|
|
|
#
|
2013-10-16 04:14:16 +04:00
|
|
|
|
# Metadata items have the following restrictions:
|
|
|
|
|
#
|
|
|
|
|
# * The metadata must be a Hash object
|
|
|
|
|
# * All keys and values must be Strings
|
|
|
|
|
# * Keys can be a maximum of 128 bytes and values can be a maximum of 1024
|
|
|
|
|
# bytes
|
|
|
|
|
# * All strings must be UTF-8, no binary data is allowed
|
|
|
|
|
#
|
|
|
|
|
# To add metadata for the location of a issue tracker:
|
|
|
|
|
#
|
|
|
|
|
# s.metadata = { "issue_tracker" => "https://example/issues" }
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
|
|
|
|
attr_accessor :metadata
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Adds a development dependency named +gem+ with +requirements+ to this
|
|
|
|
|
# gem.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.add_development_dependency 'example', '~> 1.1', '>= 1.1.4'
|
|
|
|
|
#
|
|
|
|
|
# Development dependencies aren't installed by default and aren't
|
|
|
|
|
# activated when a gem is required.
|
|
|
|
|
|
|
|
|
|
def add_development_dependency(gem, *requirements)
|
|
|
|
|
add_dependency_with_type(gem, :development, *requirements)
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Adds a runtime dependency named +gem+ with +requirements+ to this gem.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.add_runtime_dependency 'example', '~> 1.1', '>= 1.1.4'
|
|
|
|
|
|
|
|
|
|
def add_runtime_dependency(gem, *requirements)
|
|
|
|
|
add_dependency_with_type(gem, :runtime, *requirements)
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Singular writer for #authors
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.author = 'John Jones'
|
|
|
|
|
|
|
|
|
|
def author= o
|
|
|
|
|
self.authors = [o]
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Sets the list of authors, ensuring it is an array.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.authors = ['John Jones', 'Mary Smith']
|
|
|
|
|
|
|
|
|
|
def authors= value
|
|
|
|
|
@authors = Array(value).flatten.grep(String)
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
|
|
|
|
# Executables included in the gem.
|
|
|
|
|
#
|
|
|
|
|
# For example, the rake gem has rake as an executable. You don’t specify the
|
|
|
|
|
# full path (as in bin/rake); all application-style files are expected to be
|
2013-09-14 12:59:02 +04:00
|
|
|
|
# found in bindir. These files must be executable Ruby files. Files that
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# use bash or other interpreters will not work.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.executables << 'rake'
|
|
|
|
|
|
|
|
|
|
def executables
|
|
|
|
|
@executables ||= []
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Extensions to build when installing the gem, specifically the paths to
|
|
|
|
|
# extconf.rb-style files used to compile extensions.
|
|
|
|
|
#
|
|
|
|
|
# These files will be run when the gem is installed, causing the C (or
|
|
|
|
|
# whatever) code to be compiled on the user’s machine.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.extensions << 'ext/rmagic/extconf.rb'
|
2013-08-27 00:24:51 +04:00
|
|
|
|
#
|
|
|
|
|
# See Gem::Ext::Builder for information about writing extensions for gems.
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
|
|
|
|
def extensions
|
|
|
|
|
@extensions ||= []
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Extra files to add to RDoc such as README or doc/examples.txt
|
|
|
|
|
#
|
|
|
|
|
# When the user elects to generate the RDoc documentation for a gem (typically
|
|
|
|
|
# at install time), all the library files are sent to RDoc for processing.
|
|
|
|
|
# This option allows you to have some non-code files included for a more
|
|
|
|
|
# complete set of documentation.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.extra_rdoc_files = ['README', 'doc/user-guide.txt']
|
|
|
|
|
|
|
|
|
|
def extra_rdoc_files
|
|
|
|
|
@extra_rdoc_files ||= []
|
|
|
|
|
end
|
|
|
|
|
|
2013-10-20 04:31:12 +04:00
|
|
|
|
##
|
|
|
|
|
# The version of RubyGems that installed this gem. Returns
|
|
|
|
|
# <code>Gem::Version.new(0)</code> for gems installed by versions earlier
|
|
|
|
|
# than RubyGems 2.2.0.
|
|
|
|
|
|
|
|
|
|
def installed_by_version # :nodoc:
|
|
|
|
|
@installed_by_version ||= Gem::Version.new(0)
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Sets the version of RubyGems that installed this gem. See also
|
|
|
|
|
# #installed_by_version.
|
|
|
|
|
|
|
|
|
|
def installed_by_version= version # :nodoc:
|
|
|
|
|
@installed_by_version = Gem::Version.new version
|
|
|
|
|
end
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
2013-11-22 03:27:30 +04:00
|
|
|
|
# :category: Recommended gemspec attributes
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# The license for this gem.
|
|
|
|
|
#
|
|
|
|
|
# The license must be a short name, no more than 64 characters.
|
|
|
|
|
#
|
|
|
|
|
# This should just be the name of your license. The full
|
|
|
|
|
# text of the license should be inside of the gem when you build it.
|
|
|
|
|
#
|
2013-10-16 04:14:16 +04:00
|
|
|
|
# See http://opensource.org/licenses/alphabetical for a list of licenses and
|
2013-11-22 03:27:30 +04:00
|
|
|
|
# their abbreviations (or short names). GitHub also provides a
|
|
|
|
|
# license picker at http://choosealicense.com/
|
|
|
|
|
#
|
|
|
|
|
# According to copyright law, not having an OSI-approved open source license
|
|
|
|
|
# means you have no rights to use the code for any purpose-- in other words,
|
|
|
|
|
# "all rights reserved".
|
2013-10-16 04:14:16 +04:00
|
|
|
|
#
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# You can set multiple licenses with #licenses=
|
|
|
|
|
#
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Usage:
|
|
|
|
|
# spec.license = 'MIT'
|
|
|
|
|
|
|
|
|
|
def license=o
|
|
|
|
|
self.licenses = [o]
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
2013-11-22 03:27:30 +04:00
|
|
|
|
# :category: Recommended gemspec attributes
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# The license(s) for the library.
|
|
|
|
|
#
|
|
|
|
|
# Each license must be a short name, no more than 64 characters.
|
|
|
|
|
#
|
|
|
|
|
# This should just be the name of your license. The full
|
|
|
|
|
# text of the license should be inside of the gem when you build it.
|
|
|
|
|
#
|
2013-10-16 04:14:16 +04:00
|
|
|
|
# See #license= for more discussion
|
|
|
|
|
#
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Usage:
|
|
|
|
|
# spec.licenses = ['MIT', 'GPL-2']
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
def licenses= licenses
|
|
|
|
|
@licenses = Array licenses
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Specifies the rdoc options to be used when generating API documentation.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.rdoc_options << '--title' << 'Rake -- Ruby Make' <<
|
|
|
|
|
# '--main' << 'README' <<
|
|
|
|
|
# '--line-numbers'
|
|
|
|
|
|
|
|
|
|
def rdoc_options
|
|
|
|
|
@rdoc_options ||= []
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# The version of Ruby required by this gem. The ruby version can be
|
|
|
|
|
# specified to the patch-level:
|
|
|
|
|
#
|
|
|
|
|
# $ ruby -v -e 'p Gem.ruby_version'
|
|
|
|
|
# ruby 2.0.0p247 (2013-06-27 revision 41674) [x86_64-darwin12.4.0]
|
|
|
|
|
# #<Gem::Version "2.0.0.247">
|
2012-11-29 10:52:18 +04:00
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# # This gem will work with 1.8.6 or greater...
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# spec.required_ruby_version = '>= 1.8.6'
|
|
|
|
|
#
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# # Only with ruby 2.0.x
|
|
|
|
|
# spec.required_ruby_version = '~> 2.0'
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
|
|
|
|
def required_ruby_version= req
|
|
|
|
|
@required_ruby_version = Gem::Requirement.create req
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Lists the external (to RubyGems) requirements that must be met for this gem
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# to work. It's simply information for the user.
|
2012-11-29 10:52:18 +04:00
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
#
|
|
|
|
|
# spec.requirements << 'libmagick, v6.0'
|
|
|
|
|
# spec.requirements << 'A good graphics card'
|
|
|
|
|
|
|
|
|
|
def requirements
|
|
|
|
|
@requirements ||= []
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# A collection of unit test files. They will be loaded as unit tests when
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# the user requests a gem to be unit tested.
|
|
|
|
|
#
|
|
|
|
|
# Usage:
|
|
|
|
|
# spec.test_files = Dir.glob('test/tc_*.rb')
|
|
|
|
|
# spec.test_files = ['tests/test-suite.rb']
|
|
|
|
|
|
|
|
|
|
def test_files= files
|
|
|
|
|
@test_files = Array files
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
######################################################################
|
|
|
|
|
# :section: Specification internals
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# True when this gemspec has been activated. This attribute is not persisted.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_accessor :activated
|
|
|
|
|
|
|
|
|
|
alias :activated? :activated
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
|
|
|
|
# Autorequire was used by old RubyGems to automatically require a file.
|
|
|
|
|
#
|
|
|
|
|
# Deprecated: It is neither supported nor functional.
|
|
|
|
|
|
2013-08-27 00:24:51 +04:00
|
|
|
|
attr_accessor :autorequire # :nodoc:
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Sets the default executable for this gem.
|
|
|
|
|
#
|
|
|
|
|
# Deprecated: You must now specify the executable name to Gem.bin_path.
|
|
|
|
|
|
|
|
|
|
attr_writer :default_executable
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Allows deinstallation of gems with legacy platforms.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_writer :original_platform # :nodoc:
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2013-09-14 12:59:02 +04:00
|
|
|
|
# The version of Ruby required by this gem
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_reader :required_ruby_version
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# The RubyGems version required by this gem
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_reader :required_rubygems_version
|
2013-08-27 00:24:51 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# The rubyforge project this gem lives under. i.e. RubyGems'
|
|
|
|
|
# rubyforge_project is "rubygems".
|
2013-08-27 00:24:51 +04:00
|
|
|
|
#
|
|
|
|
|
# This option is deprecated.
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attr_accessor :rubyforge_project
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# The Gem::Specification version of this gemspec.
|
|
|
|
|
#
|
|
|
|
|
# Do not set this, it is set automatically when the gem is packaged.
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
attr_accessor :specification_version
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
def self._all # :nodoc:
|
|
|
|
|
unless defined?(@@all) && @@all then
|
|
|
|
|
@@all = stubs.map(&:to_spec)
|
|
|
|
|
|
|
|
|
|
# After a reset, make sure already loaded specs
|
|
|
|
|
# are still marked as activated.
|
|
|
|
|
specs = {}
|
|
|
|
|
Gem.loaded_specs.each_value{|s| specs[s] = true}
|
|
|
|
|
@@all.each{|s| s.activated = true if specs[s]}
|
|
|
|
|
|
|
|
|
|
_resort!(@@all)
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
2013-09-14 12:59:02 +04:00
|
|
|
|
@@all
|
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
def self._clear_load_cache # :nodoc:
|
|
|
|
|
LOAD_CACHE.clear
|
|
|
|
|
end
|
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
def self.each_gemspec(dirs) # :nodoc:
|
2013-09-14 12:59:02 +04:00
|
|
|
|
dirs.each do |dir|
|
|
|
|
|
Dir[File.join(dir, "*.gemspec")].each do |path|
|
|
|
|
|
yield path.untaint
|
|
|
|
|
end
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
2013-09-14 12:59:02 +04:00
|
|
|
|
end
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
def self.each_stub(dirs) # :nodoc:
|
2013-09-14 12:59:02 +04:00
|
|
|
|
each_gemspec(dirs) do |path|
|
|
|
|
|
stub = Gem::StubSpecification.new(path)
|
|
|
|
|
yield stub if stub.valid?
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
2013-09-14 12:59:02 +04:00
|
|
|
|
end
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
def self.each_spec(dirs) # :nodoc:
|
2013-09-14 12:59:02 +04:00
|
|
|
|
each_gemspec(dirs) do |path|
|
|
|
|
|
spec = self.load path
|
|
|
|
|
yield spec if spec
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
##
|
|
|
|
|
# Returns a Gem::StubSpecification for every installed gem
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
def self.stubs
|
|
|
|
|
@@stubs ||= begin
|
|
|
|
|
stubs = {}
|
|
|
|
|
each_stub([default_specifications_dir] + dirs) do |stub|
|
|
|
|
|
stubs[stub.full_name] ||= stub
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
2013-01-17 04:37:28 +04:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
stubs = stubs.values
|
|
|
|
|
_resort!(stubs)
|
|
|
|
|
stubs
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
def self._resort!(specs) # :nodoc:
|
|
|
|
|
specs.sort! { |a, b|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
names = a.name <=> b.name
|
|
|
|
|
next names if names.nonzero?
|
|
|
|
|
b.version <=> a.version
|
|
|
|
|
}
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
|
|
|
|
# Loads the default specifications. It should be called only once.
|
|
|
|
|
|
|
|
|
|
def self.load_defaults
|
2013-09-14 12:59:02 +04:00
|
|
|
|
each_spec([default_specifications_dir]) do |spec|
|
|
|
|
|
# #load returns nil if the spec is bad, so we just ignore
|
|
|
|
|
# it at this stage
|
2012-11-29 10:52:18 +04:00
|
|
|
|
Gem.register_default_spec(spec)
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Adds +spec+ to the known specifications, keeping the collection
|
|
|
|
|
# properly sorted.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.add_spec spec
|
|
|
|
|
# TODO: find all extraneous adds
|
|
|
|
|
# puts
|
|
|
|
|
# p :add_spec => [spec.full_name, caller.reject { |s| s =~ /minitest/ }]
|
|
|
|
|
|
|
|
|
|
# TODO: flush the rest of the crap from the tests
|
|
|
|
|
# raise "no dupes #{spec.full_name} in #{all_names.inspect}" if
|
|
|
|
|
# _all.include? spec
|
|
|
|
|
|
|
|
|
|
raise "nil spec!" unless spec # TODO: remove once we're happy with tests
|
|
|
|
|
|
|
|
|
|
return if _all.include? spec
|
|
|
|
|
|
|
|
|
|
_all << spec
|
2013-09-14 12:59:02 +04:00
|
|
|
|
stubs << spec
|
|
|
|
|
_resort!(_all)
|
|
|
|
|
_resort!(stubs)
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Adds multiple specs to the known specifications.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.add_specs *specs
|
|
|
|
|
raise "nil spec!" if specs.any?(&:nil?) # TODO: remove once we're happy
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# TODO: this is much more efficient, but we need the extra checks for now
|
|
|
|
|
# _all.concat specs
|
|
|
|
|
# _resort!
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
specs.each do |spec| # TODO: slow
|
|
|
|
|
add_spec spec
|
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Returns all specifications. This method is discouraged from use.
|
|
|
|
|
# You probably want to use one of the Enumerable methods instead.
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.all
|
|
|
|
|
warn "NOTE: Specification.all called from #{caller.first}" unless
|
2011-10-04 02:15:47 +04:00
|
|
|
|
Gem::Deprecate.skip
|
2011-06-01 07:45:05 +04:00
|
|
|
|
_all
|
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Sets the known specs to +specs+. Not guaranteed to work for you in
|
|
|
|
|
# the future. Use at your own risk. Caveat emptor. Doomy doom doom.
|
|
|
|
|
# Etc etc.
|
|
|
|
|
#
|
|
|
|
|
#--
|
|
|
|
|
# Makes +specs+ the known specs
|
|
|
|
|
# Listen, time is a river
|
|
|
|
|
# Winter comes, code breaks
|
|
|
|
|
#
|
|
|
|
|
# -- wilsonb
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.all= specs
|
2013-09-14 12:59:02 +04:00
|
|
|
|
@@all = @@stubs = specs
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Return full names of all specs in sorted order.
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.all_names
|
|
|
|
|
self._all.map(&:full_name)
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Return the list of all array-oriented instance variables.
|
|
|
|
|
#--
|
|
|
|
|
# Not sure why we need to use so much stupid reflection in here...
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.array_attributes
|
|
|
|
|
@@array_attributes.dup
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Return the list of all instance variables.
|
|
|
|
|
#--
|
|
|
|
|
# Not sure why we need to use so much stupid reflection in here...
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.attribute_names
|
|
|
|
|
@@attributes.dup
|
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Return the directories that Specification uses to find specs.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.dirs
|
|
|
|
|
@@dirs ||= Gem.path.collect { |dir|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
File.join dir.dup.untaint, "specifications"
|
2011-06-01 07:45:05 +04:00
|
|
|
|
}
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Set the directories that Specification uses to find specs. Setting
|
|
|
|
|
# this resets the list of known specs.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.dirs= dirs
|
|
|
|
|
self.reset
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@@dirs = Array(dirs).map { |dir| File.join dir, "specifications" }
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
extend Enumerable
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Enumerate every known spec. See ::dirs= and ::add_spec to set the list of
|
|
|
|
|
# specs.
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.each
|
|
|
|
|
return enum_for(:each) unless block_given?
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
self._all.each do |x|
|
|
|
|
|
yield x
|
2007-11-10 10:48:56 +03:00
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Returns every spec that matches +name+ and optional +requirements+.
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.find_all_by_name name, *requirements
|
|
|
|
|
requirements = Gem::Requirement.default if requirements.empty?
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# TODO: maybe try: find_all { |s| spec === dep }
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
Gem::Dependency.new(name, *requirements).matching_specs
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Find the best specification matching a +name+ and +requirements+. Raises
|
|
|
|
|
# if the dependency doesn't resolve to a valid specification.
|
|
|
|
|
|
|
|
|
|
def self.find_by_name name, *requirements
|
|
|
|
|
requirements = Gem::Requirement.default if requirements.empty?
|
|
|
|
|
|
|
|
|
|
# TODO: maybe try: find { |s| spec === dep }
|
|
|
|
|
|
|
|
|
|
Gem::Dependency.new(name, *requirements).to_spec
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Return the best specification that contains the file matching +path+.
|
|
|
|
|
|
|
|
|
|
def self.find_by_path path
|
|
|
|
|
self.find { |spec|
|
|
|
|
|
spec.contains_requirable_file? path
|
|
|
|
|
}
|
|
|
|
|
end
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
|
|
|
|
# Return the best specification that contains the file matching +path+
|
|
|
|
|
# amongst the specs that are not activated.
|
|
|
|
|
|
|
|
|
|
def self.find_inactive_by_path path
|
2013-09-14 12:59:02 +04:00
|
|
|
|
stub = stubs.find { |s|
|
|
|
|
|
s.contains_requirable_file? path unless s.activated?
|
2012-11-29 10:52:18 +04:00
|
|
|
|
}
|
2013-09-14 12:59:02 +04:00
|
|
|
|
stub && stub.to_spec
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Return currently unresolved specs that contain the file matching +path+.
|
|
|
|
|
|
|
|
|
|
def self.find_in_unresolved path
|
|
|
|
|
# TODO: do we need these?? Kill it
|
2012-11-29 10:52:18 +04:00
|
|
|
|
specs = unresolved_deps.values.map { |dep| dep.to_specs }.flatten
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
specs.find_all { |spec| spec.contains_requirable_file? path }
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Search through all unresolved deps and sub-dependencies and return
|
|
|
|
|
# specs that contain the file matching +path+.
|
|
|
|
|
|
|
|
|
|
def self.find_in_unresolved_tree path
|
2012-11-29 10:52:18 +04:00
|
|
|
|
specs = unresolved_deps.values.map { |dep| dep.to_specs }.flatten
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
specs.reverse_each do |spec|
|
|
|
|
|
trails = []
|
|
|
|
|
spec.traverse do |from_spec, dep, to_spec, trail|
|
|
|
|
|
next unless to_spec.conflicts.empty?
|
|
|
|
|
trails << trail if to_spec.contains_requirable_file? path
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
next if trails.empty?
|
|
|
|
|
|
|
|
|
|
return trails.map(&:reverse).sort.first.reverse
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
[]
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Special loader for YAML files. When a Specification object is loaded
|
|
|
|
|
# from a YAML file, it bypasses the normal Ruby object initialization
|
|
|
|
|
# routine (#initialize). This method makes up for that and deals with
|
2009-06-10 01:38:59 +04:00
|
|
|
|
# gems of different ages.
|
|
|
|
|
#
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# +input+ can be anything that YAML.load() accepts: String or IO.
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
|
|
|
|
def self.from_yaml(input)
|
2012-04-18 04:04:12 +04:00
|
|
|
|
Gem.load_yaml
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
input = normalize_yaml_input input
|
|
|
|
|
spec = YAML.load input
|
|
|
|
|
|
|
|
|
|
if spec && spec.class == FalseClass then
|
|
|
|
|
raise Gem::EndOfYAMLException
|
2007-11-10 10:48:56 +03:00
|
|
|
|
end
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
unless Gem::Specification === spec then
|
|
|
|
|
raise Gem::Exception, "YAML data doesn't evaluate to gem specification"
|
2007-11-10 10:48:56 +03:00
|
|
|
|
end
|
|
|
|
|
|
2013-02-05 06:37:35 +04:00
|
|
|
|
spec.specification_version ||= NONEXISTENT_SPECIFICATION_VERSION
|
2012-11-29 10:52:18 +04:00
|
|
|
|
spec.reset_nil_attributes_to_default
|
2012-11-29 12:10:23 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
spec
|
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Return the latest specs, optionally including prerelease specs if
|
|
|
|
|
# +prerelease+ is true.
|
|
|
|
|
|
|
|
|
|
def self.latest_specs prerelease = false
|
|
|
|
|
result = Hash.new { |h,k| h[k] = {} }
|
|
|
|
|
native = {}
|
|
|
|
|
|
2013-07-09 02:41:03 +04:00
|
|
|
|
Gem::Specification.reverse_each do |spec|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
next if spec.version.prerelease? unless prerelease
|
|
|
|
|
|
|
|
|
|
native[spec.name] = spec.version if spec.platform == Gem::Platform::RUBY
|
|
|
|
|
result[spec.name][spec.platform] = spec
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
result.map(&:last).map(&:values).flatten.reject { |spec|
|
|
|
|
|
minimum = native[spec.name]
|
|
|
|
|
minimum && spec.version < minimum
|
2013-09-14 12:59:02 +04:00
|
|
|
|
}.sort_by{ |tup| tup.name }
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-01-19 03:08:49 +03:00
|
|
|
|
# Loads Ruby format gemspec from +file+.
|
|
|
|
|
|
|
|
|
|
def self.load file
|
2012-11-29 10:52:18 +04:00
|
|
|
|
return unless file
|
2011-01-19 03:08:49 +03:00
|
|
|
|
file = file.dup.untaint
|
2012-11-29 10:52:18 +04:00
|
|
|
|
return unless File.file?(file)
|
2011-01-19 03:08:49 +03:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
spec = LOAD_CACHE[file]
|
|
|
|
|
return spec if spec
|
|
|
|
|
|
2011-01-19 03:08:49 +03:00
|
|
|
|
code = if defined? Encoding
|
2012-04-18 04:04:12 +04:00
|
|
|
|
File.read file, :mode => 'r:UTF-8:-'
|
2011-01-19 03:08:49 +03:00
|
|
|
|
else
|
|
|
|
|
File.read file
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
code.untaint
|
|
|
|
|
|
|
|
|
|
begin
|
|
|
|
|
spec = eval code, binding, file
|
|
|
|
|
|
|
|
|
|
if Gem::Specification === spec
|
2013-12-01 03:27:52 +04:00
|
|
|
|
spec.loaded_from = File.expand_path file.to_s
|
2013-09-14 12:59:02 +04:00
|
|
|
|
LOAD_CACHE[file] = spec
|
2011-01-19 03:08:49 +03:00
|
|
|
|
return spec
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
warn "[#{file}] isn't a Gem::Specification (#{spec.class} instead)."
|
|
|
|
|
rescue SignalException, SystemExit
|
|
|
|
|
raise
|
|
|
|
|
rescue SyntaxError, Exception => e
|
|
|
|
|
warn "Invalid gemspec in [#{file}]: #{e}"
|
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-01-19 03:08:49 +03:00
|
|
|
|
nil
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Specification attributes that must be non-nil
|
|
|
|
|
|
|
|
|
|
def self.non_nil_attributes
|
|
|
|
|
@@non_nil_attributes.dup
|
|
|
|
|
end
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
|
|
|
|
# Make sure the YAML specification is properly formatted with dashes
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
def self.normalize_yaml_input(input)
|
|
|
|
|
result = input.respond_to?(:read) ? input.read : input
|
2011-03-01 12:41:32 +03:00
|
|
|
|
result = "--- " + result unless result =~ /\A--- /
|
2011-06-01 07:45:05 +04:00
|
|
|
|
result.gsub!(/ !!null \n/, " \n")
|
|
|
|
|
# date: 2011-04-26 00:00:00.000000000Z
|
|
|
|
|
# date: 2011-04-26 00:00:00.000000000 Z
|
|
|
|
|
result.gsub!(/^(date: \d{4}-\d{2}-\d{2} \d{2}:\d{2}:\d{2}\.\d+?)Z/, '\1 Z')
|
|
|
|
|
result
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2013-09-14 12:59:02 +04:00
|
|
|
|
# Return a list of all outdated local gem names. This method is HEAVY
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# as it must go fetch specifications from the server.
|
2013-09-14 12:59:02 +04:00
|
|
|
|
#
|
|
|
|
|
# Use outdated_and_latest_version if you wish to retrieve the latest remote
|
|
|
|
|
# version as well.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.outdated
|
2013-09-14 12:59:02 +04:00
|
|
|
|
outdated_and_latest_version.map { |local, _| local.name }
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Enumerates the outdated local gems yielding the local specification and
|
|
|
|
|
# the latest remote version.
|
|
|
|
|
#
|
|
|
|
|
# This method may take some time to return as it must check each local gem
|
|
|
|
|
# against the server's index.
|
|
|
|
|
|
|
|
|
|
def self.outdated_and_latest_version
|
|
|
|
|
return enum_for __method__ unless block_given?
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
# TODO: maybe we should switch to rubygems' version service?
|
|
|
|
|
fetcher = Gem::SpecFetcher.fetcher
|
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
latest_specs(true).each do |local_spec|
|
|
|
|
|
dependency =
|
|
|
|
|
Gem::Dependency.new local_spec.name, ">= #{local_spec.version}"
|
2013-07-31 02:10:21 +04:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
remotes, = fetcher.search_for_dependency dependency
|
|
|
|
|
remotes = remotes.map { |n, _| n.version }
|
|
|
|
|
|
|
|
|
|
latest_remote = remotes.sort.last
|
|
|
|
|
|
|
|
|
|
yield [local_spec, latest_remote] if
|
|
|
|
|
latest_remote and local_spec.version < latest_remote
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
nil
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Removes +spec+ from the known specs.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def self.remove_spec spec
|
|
|
|
|
_all.delete spec
|
2013-09-14 12:59:02 +04:00
|
|
|
|
stubs.delete_if { |s| s.full_name == spec.full_name }
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Is +name+ a required attribute?
|
|
|
|
|
|
|
|
|
|
def self.required_attribute?(name)
|
|
|
|
|
@@required_attributes.include? name.to_sym
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Required specification attributes
|
|
|
|
|
|
|
|
|
|
def self.required_attributes
|
|
|
|
|
@@required_attributes.dup
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Reset the list of known specs, running pre and post reset hooks
|
|
|
|
|
# registered in Gem.
|
|
|
|
|
|
|
|
|
|
def self.reset
|
|
|
|
|
@@dirs = nil
|
2012-11-29 10:52:18 +04:00
|
|
|
|
Gem.pre_reset_hooks.each { |hook| hook.call }
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@@all = nil
|
2013-09-14 12:59:02 +04:00
|
|
|
|
@@stubs = nil
|
|
|
|
|
_clear_load_cache
|
2012-11-29 10:52:18 +04:00
|
|
|
|
unresolved = unresolved_deps
|
|
|
|
|
unless unresolved.empty? then
|
|
|
|
|
w = "W" + "ARN"
|
|
|
|
|
warn "#{w}: Unresolved specs during Gem::Specification.reset:"
|
|
|
|
|
unresolved.values.each do |dep|
|
|
|
|
|
warn " #{dep}"
|
|
|
|
|
end
|
|
|
|
|
warn "#{w}: Clearing out unresolved specs."
|
|
|
|
|
warn "Please report a bug if this causes problems."
|
|
|
|
|
unresolved.clear
|
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
Gem.post_reset_hooks.each { |hook| hook.call }
|
|
|
|
|
end
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# DOC: This method needs documented or nodoc'd
|
|
|
|
|
def self.unresolved_deps
|
|
|
|
|
@unresolved_deps ||= Hash.new { |h, n| h[n] = Gem::Dependency.new n }
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Load custom marshal format, re-initializing defaults as needed
|
|
|
|
|
|
|
|
|
|
def self._load(str)
|
|
|
|
|
array = Marshal.load str
|
|
|
|
|
|
|
|
|
|
spec = Gem::Specification.new
|
|
|
|
|
spec.instance_variable_set :@specification_version, array[1]
|
|
|
|
|
|
|
|
|
|
current_version = CURRENT_SPECIFICATION_VERSION
|
|
|
|
|
|
|
|
|
|
field_count = if spec.specification_version > current_version then
|
|
|
|
|
spec.instance_variable_set :@specification_version,
|
|
|
|
|
current_version
|
|
|
|
|
MARSHAL_FIELDS[current_version]
|
|
|
|
|
else
|
|
|
|
|
MARSHAL_FIELDS[spec.specification_version]
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
if array.size < field_count then
|
|
|
|
|
raise TypeError, "invalid Gem::Specification format #{array.inspect}"
|
|
|
|
|
end
|
|
|
|
|
|
2012-04-18 04:04:12 +04:00
|
|
|
|
# Cleanup any YAML::PrivateType. They only show up for an old bug
|
|
|
|
|
# where nil => null, so just convert them to nil based on the type.
|
|
|
|
|
|
|
|
|
|
array.map! { |e| e.kind_of?(YAML::PrivateType) ? nil : e }
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
spec.instance_variable_set :@rubygems_version, array[0]
|
|
|
|
|
# spec version
|
|
|
|
|
spec.instance_variable_set :@name, array[2]
|
|
|
|
|
spec.instance_variable_set :@version, array[3]
|
2012-04-18 04:04:12 +04:00
|
|
|
|
spec.date = array[4]
|
2011-06-01 07:45:05 +04:00
|
|
|
|
spec.instance_variable_set :@summary, array[5]
|
|
|
|
|
spec.instance_variable_set :@required_ruby_version, array[6]
|
|
|
|
|
spec.instance_variable_set :@required_rubygems_version, array[7]
|
|
|
|
|
spec.instance_variable_set :@original_platform, array[8]
|
|
|
|
|
spec.instance_variable_set :@dependencies, array[9]
|
|
|
|
|
spec.instance_variable_set :@rubyforge_project, array[10]
|
|
|
|
|
spec.instance_variable_set :@email, array[11]
|
|
|
|
|
spec.instance_variable_set :@authors, array[12]
|
|
|
|
|
spec.instance_variable_set :@description, array[13]
|
|
|
|
|
spec.instance_variable_set :@homepage, array[14]
|
|
|
|
|
spec.instance_variable_set :@has_rdoc, array[15]
|
|
|
|
|
spec.instance_variable_set :@new_platform, array[16]
|
|
|
|
|
spec.instance_variable_set :@platform, array[16].to_s
|
|
|
|
|
spec.instance_variable_set :@license, array[17]
|
2012-11-29 10:52:18 +04:00
|
|
|
|
spec.instance_variable_set :@metadata, array[18]
|
2011-06-01 07:45:05 +04:00
|
|
|
|
spec.instance_variable_set :@loaded, false
|
2011-07-23 20:05:19 +04:00
|
|
|
|
spec.instance_variable_set :@activated, false
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
spec
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
def <=>(other) # :nodoc:
|
|
|
|
|
sort_obj <=> other.sort_obj
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
def == other # :nodoc:
|
|
|
|
|
self.class === other &&
|
|
|
|
|
name == other.name &&
|
|
|
|
|
version == other.version &&
|
|
|
|
|
platform == other.platform
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Dump only crucial instance variables.
|
|
|
|
|
#--
|
|
|
|
|
# MAINTAIN ORDER!
|
|
|
|
|
# (down with the man)
|
|
|
|
|
|
|
|
|
|
def _dump(limit)
|
|
|
|
|
Marshal.dump [
|
|
|
|
|
@rubygems_version,
|
|
|
|
|
@specification_version,
|
|
|
|
|
@name,
|
|
|
|
|
@version,
|
|
|
|
|
date,
|
|
|
|
|
@summary,
|
|
|
|
|
@required_ruby_version,
|
|
|
|
|
@required_rubygems_version,
|
|
|
|
|
@original_platform,
|
|
|
|
|
@dependencies,
|
|
|
|
|
@rubyforge_project,
|
|
|
|
|
@email,
|
|
|
|
|
@authors,
|
|
|
|
|
@description,
|
|
|
|
|
@homepage,
|
|
|
|
|
true, # has_rdoc
|
|
|
|
|
@new_platform,
|
2012-11-29 10:52:18 +04:00
|
|
|
|
@licenses,
|
|
|
|
|
@metadata
|
2011-06-01 07:45:05 +04:00
|
|
|
|
]
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Activate this spec, registering it as a loaded spec and adding
|
|
|
|
|
# it's lib paths to $LOAD_PATH. Returns true if the spec was
|
|
|
|
|
# activated, false if it was previously activated. Freaks out if
|
|
|
|
|
# there are conflicts upon activation.
|
|
|
|
|
|
|
|
|
|
def activate
|
|
|
|
|
raise_if_conflicts
|
|
|
|
|
|
|
|
|
|
return false if Gem.loaded_specs[self.name]
|
|
|
|
|
|
|
|
|
|
activate_dependencies
|
|
|
|
|
add_self_to_load_path
|
|
|
|
|
|
|
|
|
|
Gem.loaded_specs[self.name] = self
|
2011-07-23 20:05:19 +04:00
|
|
|
|
@activated = true
|
|
|
|
|
@loaded = true
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
return true
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Activate all unambiguously resolved runtime dependencies of this
|
2013-12-20 02:09:19 +04:00
|
|
|
|
# spec. Add any ambiguous dependencies to the unresolved list to be
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# resolved later, as needed.
|
|
|
|
|
|
|
|
|
|
def activate_dependencies
|
2012-11-29 10:52:18 +04:00
|
|
|
|
unresolved = Gem::Specification.unresolved_deps
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
self.runtime_dependencies.each do |spec_dep|
|
2012-04-18 04:04:12 +04:00
|
|
|
|
if loaded = Gem.loaded_specs[spec_dep.name]
|
|
|
|
|
next if spec_dep.matches_spec? loaded
|
|
|
|
|
|
|
|
|
|
msg = "can't satisfy '#{spec_dep}', already activated '#{loaded.full_name}'"
|
|
|
|
|
e = Gem::LoadError.new msg
|
|
|
|
|
e.name = spec_dep.name
|
|
|
|
|
|
|
|
|
|
raise e
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
specs = spec_dep.to_specs
|
|
|
|
|
|
|
|
|
|
if specs.size == 1 then
|
|
|
|
|
specs.first.activate
|
|
|
|
|
else
|
|
|
|
|
name = spec_dep.name
|
2012-11-29 10:52:18 +04:00
|
|
|
|
unresolved[name] = unresolved[name].merge spec_dep
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
unresolved.delete self.name
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Returns an array with bindir attached to each executable in the
|
|
|
|
|
# +executables+ list
|
|
|
|
|
|
|
|
|
|
def add_bindir(executables)
|
|
|
|
|
return nil if executables.nil?
|
|
|
|
|
|
|
|
|
|
if @bindir then
|
|
|
|
|
Array(executables).map { |e| File.join(@bindir, e) }
|
2009-06-10 01:38:59 +04:00
|
|
|
|
else
|
2011-06-01 07:45:05 +04:00
|
|
|
|
executables
|
|
|
|
|
end
|
|
|
|
|
rescue
|
|
|
|
|
return nil
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Adds a dependency on gem +dependency+ with type +type+ that requires
|
|
|
|
|
# +requirements+. Valid types are currently <tt>:runtime</tt> and
|
|
|
|
|
# <tt>:development</tt>.
|
|
|
|
|
|
|
|
|
|
def add_dependency_with_type(dependency, type, *requirements)
|
|
|
|
|
requirements = if requirements.empty? then
|
2012-11-29 10:52:18 +04:00
|
|
|
|
Gem::Requirement.default
|
|
|
|
|
else
|
|
|
|
|
requirements.flatten
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
unless dependency.respond_to?(:name) &&
|
|
|
|
|
dependency.respond_to?(:version_requirements)
|
2013-07-09 02:41:03 +04:00
|
|
|
|
dependency = Gem::Dependency.new(dependency.to_s, requirements, type)
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
dependencies << dependency
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
private :add_dependency_with_type
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
alias add_dependency add_runtime_dependency
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Adds this spec's require paths to LOAD_PATH, in the proper location.
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def add_self_to_load_path
|
2012-12-01 08:48:36 +04:00
|
|
|
|
return if default_gem?
|
|
|
|
|
|
2013-09-19 01:29:41 +04:00
|
|
|
|
paths = full_require_paths
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# gem directories must come after -I and ENV['RUBYLIB']
|
|
|
|
|
insert_index = Gem.load_path_insert_index
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
if insert_index then
|
|
|
|
|
# gem directories must come after -I and ENV['RUBYLIB']
|
|
|
|
|
$LOAD_PATH.insert(insert_index, *paths)
|
2009-06-10 01:38:59 +04:00
|
|
|
|
else
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# we are probably testing in core, -I and RUBYLIB don't apply
|
|
|
|
|
$LOAD_PATH.unshift(*paths)
|
2007-11-10 10:48:56 +03:00
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# Singular reader for #authors. Returns the first author in the list
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def author
|
|
|
|
|
val = authors and val.first
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# The list of author names who wrote this gem.
|
2013-08-27 00:24:51 +04:00
|
|
|
|
#
|
|
|
|
|
# spec.authors = ['Chad Fowler', 'Jim Weirich', 'Rich Kilmer']
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def authors
|
|
|
|
|
@authors ||= []
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2010-02-22 05:52:35 +03:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Returns the full path to installed gem's bin directory.
|
2010-02-22 05:52:35 +03:00
|
|
|
|
#
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# NOTE: do not confuse this with +bindir+, which is just 'bin', not
|
|
|
|
|
# a full path.
|
2010-02-22 05:52:35 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def bin_dir
|
|
|
|
|
@bin_dir ||= File.join gem_dir, bindir # TODO: this is unfortunate
|
2010-02-22 05:52:35 +03:00
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Returns the full path to an executable named +name+ in this gem.
|
|
|
|
|
|
|
|
|
|
def bin_file name
|
|
|
|
|
File.join bin_dir, name
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
|
|
|
|
# Returns the build_args used to install the gem
|
|
|
|
|
|
|
|
|
|
def build_args
|
2013-11-12 04:16:41 +04:00
|
|
|
|
if File.exist? build_info_file
|
2012-11-29 10:52:18 +04:00
|
|
|
|
File.readlines(build_info_file).map { |x| x.strip }
|
|
|
|
|
else
|
|
|
|
|
[]
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
##
|
|
|
|
|
# Builds extensions for this platform if the gem has extensions listed and
|
|
|
|
|
# the gem.build_complete file is missing.
|
|
|
|
|
|
|
|
|
|
def build_extensions # :nodoc:
|
|
|
|
|
return if default_gem?
|
2013-10-17 02:37:39 +04:00
|
|
|
|
return if extensions.empty?
|
2013-11-10 23:37:05 +04:00
|
|
|
|
return if installed_by_version < Gem::Version.new('2.2.0.preview.2')
|
2013-10-16 04:14:16 +04:00
|
|
|
|
return if File.exist? gem_build_complete_path
|
|
|
|
|
return if !File.writable?(base_dir) &&
|
|
|
|
|
!File.exist?(File.join(base_dir, 'extensions'))
|
|
|
|
|
|
2013-10-17 02:37:39 +04:00
|
|
|
|
begin
|
|
|
|
|
# We need to require things in $LOAD_PATH without looking for the
|
|
|
|
|
# extension we are about to build.
|
|
|
|
|
unresolved_deps = Gem::Specification.unresolved_deps.dup
|
|
|
|
|
Gem::Specification.unresolved_deps.clear
|
|
|
|
|
|
|
|
|
|
require 'rubygems/config_file'
|
|
|
|
|
require 'rubygems/ext'
|
|
|
|
|
require 'rubygems/user_interaction'
|
|
|
|
|
|
|
|
|
|
Gem::DefaultUserInteraction.use_ui Gem::SilentUI.new do
|
|
|
|
|
builder = Gem::Ext::Builder.new self
|
|
|
|
|
builder.build_extensions
|
|
|
|
|
end
|
|
|
|
|
ensure
|
|
|
|
|
Gem::Specification.unresolved_deps.replace unresolved_deps
|
2013-10-16 04:14:16 +04:00
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
|
|
|
|
# Returns the full path to the build info directory
|
|
|
|
|
|
|
|
|
|
def build_info_dir
|
|
|
|
|
File.join base_dir, "build_info"
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Returns the full path to the file containing the build
|
|
|
|
|
# information generated when the gem was installed
|
|
|
|
|
|
|
|
|
|
def build_info_file
|
|
|
|
|
File.join build_info_dir, "#{full_name}.info"
|
|
|
|
|
end
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Returns the full path to the cache directory containing this
|
|
|
|
|
# spec's cached gem.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def cache_dir
|
|
|
|
|
@cache_dir ||= File.join base_dir, "cache"
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-03-01 12:41:32 +03:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Returns the full path to the cached gem for this spec.
|
|
|
|
|
|
|
|
|
|
def cache_file
|
|
|
|
|
@cache_file ||= File.join cache_dir, "#{full_name}.gem"
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Return any possible conflicts against the currently loaded specs.
|
|
|
|
|
|
|
|
|
|
def conflicts
|
|
|
|
|
conflicts = {}
|
|
|
|
|
Gem.loaded_specs.values.each do |spec|
|
|
|
|
|
bad = self.runtime_dependencies.find_all { |dep|
|
|
|
|
|
spec.name == dep.name and not spec.satisfies_requirement? dep
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
conflicts[spec] = bad unless bad.empty?
|
|
|
|
|
end
|
|
|
|
|
conflicts
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# The date this gem was created. Lazily defaults to the current UTC date.
|
|
|
|
|
#
|
|
|
|
|
# There is no need to set this in your gem specification.
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
def date
|
|
|
|
|
@date ||= TODAY
|
|
|
|
|
end
|
|
|
|
|
|
2013-10-20 05:33:19 +04:00
|
|
|
|
DateTimeFormat = # :nodoc:
|
|
|
|
|
/\A
|
|
|
|
|
(\d{4})-(\d{2})-(\d{2})
|
|
|
|
|
(\s+ \d{2}:\d{2}:\d{2}\.\d+ \s* (Z | [-+]\d\d:\d\d) )?
|
|
|
|
|
\Z/x
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# The date this gem was created
|
2011-03-01 12:41:32 +03:00
|
|
|
|
#
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# DO NOT set this, it is set automatically when the gem is packaged.
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
def date= date
|
|
|
|
|
# We want to end up with a Time object with one-day resolution.
|
|
|
|
|
# This is the cleanest, most-readable, faster-than-using-Date
|
|
|
|
|
# way to do it.
|
|
|
|
|
@date = case date
|
|
|
|
|
when String then
|
2012-11-29 10:52:18 +04:00
|
|
|
|
if DateTimeFormat =~ date then
|
2011-06-01 07:45:05 +04:00
|
|
|
|
Time.utc($1.to_i, $2.to_i, $3.to_i)
|
2012-04-18 04:04:12 +04:00
|
|
|
|
|
|
|
|
|
# Workaround for where the date format output from psych isn't
|
|
|
|
|
# parsed as a Time object by syck and thus comes through as a
|
|
|
|
|
# string.
|
|
|
|
|
elsif /\A(\d{4})-(\d{2})-(\d{2}) \d{2}:\d{2}:\d{2}\.\d+?Z\z/ =~ date then
|
|
|
|
|
Time.utc($1.to_i, $2.to_i, $3.to_i)
|
2011-06-01 07:45:05 +04:00
|
|
|
|
else
|
|
|
|
|
raise(Gem::InvalidSpecificationException,
|
|
|
|
|
"invalid date format in specification: #{date.inspect}")
|
|
|
|
|
end
|
|
|
|
|
when Time, Date then
|
|
|
|
|
Time.utc(date.year, date.month, date.day)
|
|
|
|
|
else
|
|
|
|
|
TODAY
|
|
|
|
|
end
|
2011-03-01 12:41:32 +03:00
|
|
|
|
end
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# The default executable for this gem.
|
|
|
|
|
#
|
|
|
|
|
# Deprecated: The name of the gem is assumed to be the name of the
|
|
|
|
|
# executable now. See Gem.bin_path.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2013-08-27 00:24:51 +04:00
|
|
|
|
def default_executable # :nodoc:
|
2011-06-01 07:45:05 +04:00
|
|
|
|
if defined?(@default_executable) and @default_executable
|
|
|
|
|
result = @default_executable
|
|
|
|
|
elsif @executables and @executables.size == 1
|
|
|
|
|
result = Array(@executables).first
|
|
|
|
|
else
|
|
|
|
|
result = nil
|
2007-11-10 10:48:56 +03:00
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
result
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# The default value for specification attribute +name+
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def default_value name
|
|
|
|
|
@@default_value[name]
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# A list of Gem::Dependency objects this gem depends on.
|
|
|
|
|
#
|
|
|
|
|
# Use #add_dependency or #add_development_dependency to add dependencies to
|
|
|
|
|
# a gem.
|
|
|
|
|
|
|
|
|
|
def dependencies
|
|
|
|
|
@dependencies ||= []
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Return a list of all gems that have a dependency on this gemspec. The
|
|
|
|
|
# list is structured with entries that conform to:
|
|
|
|
|
#
|
|
|
|
|
# [depending_gem, dependency, [list_of_gems_that_satisfy_dependency]]
|
|
|
|
|
|
|
|
|
|
def dependent_gems
|
|
|
|
|
out = []
|
|
|
|
|
Gem::Specification.each do |spec|
|
|
|
|
|
spec.dependencies.each do |dep|
|
|
|
|
|
if self.satisfies_requirement?(dep) then
|
|
|
|
|
sats = []
|
|
|
|
|
find_all_satisfiers(dep) do |sat|
|
|
|
|
|
sats << sat
|
|
|
|
|
end
|
|
|
|
|
out << [spec, dep, sats]
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
out
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Returns all specs that matches this spec's runtime dependencies.
|
|
|
|
|
|
|
|
|
|
def dependent_specs
|
|
|
|
|
runtime_dependencies.map { |dep| dep.to_specs }.flatten
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
2013-08-27 00:24:51 +04:00
|
|
|
|
# A detailed description of this gem. See also #summary
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
def description= str
|
|
|
|
|
@description = str.to_s
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# List of dependencies that are used for development
|
|
|
|
|
|
|
|
|
|
def development_dependencies
|
|
|
|
|
dependencies.select { |d| d.type == :development }
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Returns the full path to this spec's documentation directory. If +type+
|
2013-12-14 14:54:54 +04:00
|
|
|
|
# is given it will be appended to the end. For example:
|
2012-11-29 10:52:18 +04:00
|
|
|
|
#
|
|
|
|
|
# spec.doc_dir # => "/path/to/gem_repo/doc/a-1"
|
|
|
|
|
#
|
|
|
|
|
# spec.doc_dir 'ri' # => "/path/to/gem_repo/doc/a-1/ri"
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
def doc_dir type = nil
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@doc_dir ||= File.join base_dir, 'doc', full_name
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
|
|
|
|
if type then
|
|
|
|
|
File.join @doc_dir, type
|
|
|
|
|
else
|
|
|
|
|
@doc_dir
|
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
|
|
|
|
|
2010-04-22 12:24:42 +04:00
|
|
|
|
def encode_with coder # :nodoc:
|
2009-06-10 01:38:59 +04:00
|
|
|
|
mark_version
|
|
|
|
|
|
2010-04-22 12:24:42 +04:00
|
|
|
|
coder.add 'name', @name
|
|
|
|
|
coder.add 'version', @version
|
|
|
|
|
platform = case @original_platform
|
|
|
|
|
when nil, '' then
|
|
|
|
|
'ruby'
|
|
|
|
|
when String then
|
|
|
|
|
@original_platform
|
|
|
|
|
else
|
|
|
|
|
@original_platform.to_s
|
|
|
|
|
end
|
|
|
|
|
coder.add 'platform', platform
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
attributes = @@attributes.map(&:to_s) - %w[name version platform]
|
2010-04-22 12:24:42 +04:00
|
|
|
|
attributes.each do |name|
|
|
|
|
|
coder.add name, instance_variable_get("@#{name}")
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def eql? other # :nodoc:
|
|
|
|
|
self.class === other && same_attributes?(other)
|
2010-04-22 12:24:42 +04:00
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Singular accessor for #executables
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def executable
|
|
|
|
|
val = executables and val.first
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Singular accessor for #executables
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def executable=o
|
|
|
|
|
self.executables = [o]
|
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Sets executables to +value+, ensuring it is an array. Don't
|
|
|
|
|
# use this, push onto the array instead.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def executables= value
|
|
|
|
|
# TODO: warn about setting instead of pushing
|
|
|
|
|
@executables = Array(value)
|
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Sets extensions to +extensions+, ensuring it is an array. Don't
|
|
|
|
|
# use this, push onto the array instead.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def extensions= extensions
|
|
|
|
|
# TODO: warn about setting instead of pushing
|
|
|
|
|
@extensions = Array extensions
|
|
|
|
|
end
|
2007-11-20 08:56:43 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Sets extra_rdoc_files to +files+, ensuring it is an array. Don't
|
|
|
|
|
# use this, push onto the array instead.
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def extra_rdoc_files= files
|
|
|
|
|
# TODO: warn about setting instead of pushing
|
|
|
|
|
@extra_rdoc_files = Array files
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# The default (generated) file name of the gem. See also #spec_name.
|
|
|
|
|
#
|
|
|
|
|
# spec.file_name # => "example-1.0.gem"
|
|
|
|
|
|
|
|
|
|
def file_name
|
|
|
|
|
"#{full_name}.gem"
|
2011-03-01 12:41:32 +03:00
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Sets files to +files+, ensuring it is an array.
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def files= files
|
|
|
|
|
@files = Array files
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Finds all gems that satisfy +dep+
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def find_all_satisfiers dep
|
|
|
|
|
Gem::Specification.each do |spec|
|
|
|
|
|
yield spec if spec.satisfies_requirement? dep
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
private :find_all_satisfiers
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Creates a duplicate spec without large blobs that aren't used at runtime.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def for_cache
|
|
|
|
|
spec = dup
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
spec.files = nil
|
|
|
|
|
spec.test_files = nil
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
spec
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
def find_full_gem_path # :nodoc:
|
2013-09-14 12:59:02 +04:00
|
|
|
|
super || File.expand_path(File.join(gems_dir, original_name))
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
2013-09-14 12:59:02 +04:00
|
|
|
|
private :find_full_gem_path
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def full_name
|
2013-09-14 12:59:02 +04:00
|
|
|
|
@full_name ||= super
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
2013-10-16 04:14:16 +04:00
|
|
|
|
# The path to the gem.build_complete file within the extension install
|
|
|
|
|
# directory.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
def gem_build_complete_path # :nodoc:
|
2013-12-10 23:54:19 +04:00
|
|
|
|
File.join extension_dir, 'gem.build_complete'
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2013-10-17 06:08:53 +04:00
|
|
|
|
##
|
|
|
|
|
# Work around bundler removing my methods
|
|
|
|
|
|
|
|
|
|
def gem_dir # :nodoc:
|
|
|
|
|
super
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Deprecated and ignored, defaults to true.
|
|
|
|
|
#
|
|
|
|
|
# Formerly used to indicate this gem was RDoc-capable.
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2013-08-27 00:24:51 +04:00
|
|
|
|
def has_rdoc # :nodoc:
|
2009-06-10 01:38:59 +04:00
|
|
|
|
true
|
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Deprecated and ignored.
|
|
|
|
|
#
|
|
|
|
|
# Formerly used to indicate this gem was RDoc-capable.
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2013-08-27 00:24:51 +04:00
|
|
|
|
def has_rdoc= ignored # :nodoc:
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@has_rdoc = true
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2013-08-27 00:24:51 +04:00
|
|
|
|
alias :has_rdoc? :has_rdoc # :nodoc:
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# True if this gem has files in test_files
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def has_unit_tests?
|
|
|
|
|
not test_files.empty?
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# :stopdoc:
|
|
|
|
|
alias has_test_suite? has_unit_tests?
|
|
|
|
|
# :startdoc:
|
|
|
|
|
|
|
|
|
|
def hash # :nodoc:
|
2013-09-14 12:59:02 +04:00
|
|
|
|
name.hash ^ version.hash
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def init_with coder # :nodoc:
|
2013-11-10 21:51:40 +04:00
|
|
|
|
@installed_by_version ||= nil
|
2011-06-01 07:45:05 +04:00
|
|
|
|
yaml_initialize coder.tag, coder.map
|
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Specification constructor. Assigns the default values to the attributes
|
|
|
|
|
# and yields itself for further initialization. Optionally takes +name+ and
|
|
|
|
|
# +version+.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def initialize name = nil, version = nil
|
|
|
|
|
@loaded = false
|
2011-07-23 20:05:19 +04:00
|
|
|
|
@activated = false
|
2013-09-14 12:59:02 +04:00
|
|
|
|
self.loaded_from = nil
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@original_platform = nil
|
2013-10-20 04:31:12 +04:00
|
|
|
|
@installed_by_version = nil
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@@nil_attributes.each do |key|
|
|
|
|
|
instance_variable_set "@#{key}", nil
|
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@@non_nil_attributes.each do |key|
|
|
|
|
|
default = default_value(key)
|
2013-09-14 12:59:02 +04:00
|
|
|
|
value = Dupable[key] ? default.dup : default
|
2011-06-01 07:45:05 +04:00
|
|
|
|
instance_variable_set "@#{key}", value
|
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@new_platform = Gem::Platform::RUBY
|
|
|
|
|
|
|
|
|
|
self.name = name if name
|
|
|
|
|
self.version = version if version
|
|
|
|
|
|
|
|
|
|
yield self if block_given?
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Duplicates array_attributes from +other_spec+ so state isn't shared.
|
|
|
|
|
|
|
|
|
|
def initialize_copy other_spec
|
|
|
|
|
self.class.array_attributes.each do |name|
|
|
|
|
|
name = :"@#{name}"
|
2012-11-29 10:52:18 +04:00
|
|
|
|
next unless other_spec.instance_variable_defined? name
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
begin
|
|
|
|
|
val = other_spec.instance_variable_get(name)
|
|
|
|
|
if val then
|
|
|
|
|
instance_variable_set name, val.dup
|
2012-04-18 04:04:12 +04:00
|
|
|
|
elsif Gem.configuration.really_verbose
|
2011-06-01 07:45:05 +04:00
|
|
|
|
warn "WARNING: #{full_name} has an invalid nil value for #{name}"
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
rescue TypeError
|
|
|
|
|
e = Gem::FormatException.new \
|
|
|
|
|
"#{full_name} has an invalid value for #{name}"
|
|
|
|
|
|
|
|
|
|
e.file_path = loaded_from
|
|
|
|
|
raise e
|
2007-11-10 10:48:56 +03:00
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Expire memoized instance variables that can incorrectly generate, replace
|
|
|
|
|
# or miss files due changes in certain attributes used to compute them.
|
|
|
|
|
|
|
|
|
|
def invalidate_memoized_attributes
|
|
|
|
|
@full_name = nil
|
|
|
|
|
@cache_file = nil
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
private :invalidate_memoized_attributes
|
2007-12-20 11:39:12 +03:00
|
|
|
|
|
2013-10-20 05:33:19 +04:00
|
|
|
|
def inspect # :nodoc:
|
2012-11-29 10:52:18 +04:00
|
|
|
|
if $DEBUG
|
|
|
|
|
super
|
|
|
|
|
else
|
|
|
|
|
"#<#{self.class}:0x#{__id__.to_s(16)} #{full_name}>"
|
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
2007-12-20 11:39:12 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Returns a string usable in Dir.glob to match all requirable paths
|
|
|
|
|
# for this spec.
|
2007-12-20 11:39:12 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def lib_dirs_glob
|
|
|
|
|
dirs = if self.require_paths.size > 1 then
|
|
|
|
|
"{#{self.require_paths.join(',')}}"
|
|
|
|
|
else
|
|
|
|
|
self.require_paths.first
|
|
|
|
|
end
|
2007-12-20 11:39:12 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
"#{self.full_gem_path}/#{dirs}"
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-12-20 11:39:12 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Files in the Gem under one of the require_paths
|
2007-12-20 11:39:12 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def lib_files
|
|
|
|
|
@files.select do |file|
|
|
|
|
|
require_paths.any? do |path|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
file.start_with? path
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Singular accessor for #licenses
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def license
|
|
|
|
|
val = licenses and val.first
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Plural accessor for setting licenses
|
2013-10-16 04:14:16 +04:00
|
|
|
|
#
|
|
|
|
|
# See #license= for details
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def licenses
|
|
|
|
|
@licenses ||= []
|
|
|
|
|
end
|
2008-06-18 02:04:18 +04:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
def loaded_from= path # :nodoc:
|
|
|
|
|
super
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
@bin_dir = nil
|
|
|
|
|
@cache_dir = nil
|
|
|
|
|
@cache_file = nil
|
|
|
|
|
@doc_dir = nil
|
|
|
|
|
@ri_dir = nil
|
|
|
|
|
@spec_dir = nil
|
|
|
|
|
@spec_file = nil
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
2009-03-06 06:56:38 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Sets the rubygems_version to the current RubyGems version.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def mark_version
|
|
|
|
|
@rubygems_version = Gem::VERSION
|
|
|
|
|
end
|
2009-03-06 06:56:38 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Return all files in this gem that match for +glob+.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def matches_for_glob glob # TODO: rename?
|
|
|
|
|
# TODO: do we need these?? Kill it
|
|
|
|
|
glob = File.join(self.lib_dirs_glob, glob)
|
|
|
|
|
|
2011-08-26 05:10:50 +04:00
|
|
|
|
Dir[glob].map { |f| f.untaint } # FIX our tests are broken, run w/ SAFE=1
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Warn about unknown attributes while loading a spec.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def method_missing(sym, *a, &b) # :nodoc:
|
|
|
|
|
if @specification_version > CURRENT_SPECIFICATION_VERSION and
|
|
|
|
|
sym.to_s =~ /=$/ then
|
|
|
|
|
warn "ignoring #{sym} loading #{full_name}" if $DEBUG
|
|
|
|
|
else
|
|
|
|
|
super
|
|
|
|
|
end
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Normalize the list of files so that:
|
|
|
|
|
# * All file lists have redundancies removed.
|
|
|
|
|
# * Files referenced in the extra_rdoc_files are included in the package
|
|
|
|
|
# file list.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def normalize
|
|
|
|
|
if defined?(@extra_rdoc_files) and @extra_rdoc_files then
|
|
|
|
|
@extra_rdoc_files.uniq!
|
|
|
|
|
@files ||= []
|
|
|
|
|
@files.concat(@extra_rdoc_files)
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@files = @files.uniq if @files
|
|
|
|
|
@extensions = @extensions.uniq if @extensions
|
|
|
|
|
@test_files = @test_files.uniq if @test_files
|
|
|
|
|
@executables = @executables.uniq if @executables
|
|
|
|
|
@extra_rdoc_files = @extra_rdoc_files.uniq if @extra_rdoc_files
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
|
|
|
|
# Return a NameTuple that represents this Specification
|
|
|
|
|
|
|
|
|
|
def name_tuple
|
|
|
|
|
Gem::NameTuple.new name, version, original_platform
|
|
|
|
|
end
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Returns the full name (name-version) of this gemspec using the original
|
|
|
|
|
# platform. For use with legacy gems.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def original_name # :nodoc:
|
|
|
|
|
if platform == Gem::Platform::RUBY or platform.nil? then
|
|
|
|
|
"#{@name}-#{@version}"
|
|
|
|
|
else
|
|
|
|
|
"#{@name}-#{@version}-#{@original_platform}"
|
|
|
|
|
end
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Cruft. Use +platform+.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def original_platform # :nodoc:
|
|
|
|
|
@original_platform ||= platform
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# The platform this gem runs on. See Gem::Platform for details.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def platform
|
|
|
|
|
@new_platform ||= Gem::Platform::RUBY
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def pretty_print(q) # :nodoc:
|
|
|
|
|
q.group 2, 'Gem::Specification.new do |s|', 'end' do
|
|
|
|
|
q.breakable
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2013-10-20 04:31:12 +04:00
|
|
|
|
attributes = @@attributes - [:name, :version]
|
|
|
|
|
attributes.unshift :installed_by_version
|
|
|
|
|
attributes.unshift :version
|
|
|
|
|
attributes.unshift :name
|
|
|
|
|
|
|
|
|
|
attributes.each do |attr_name|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
current_value = self.send attr_name
|
|
|
|
|
if current_value != default_value(attr_name) or
|
|
|
|
|
self.class.required_attribute? attr_name then
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
q.text "s.#{attr_name} = "
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
if attr_name == :date then
|
|
|
|
|
current_value = current_value.utc
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
q.text "Time.utc(#{current_value.year}, #{current_value.month}, #{current_value.day})"
|
|
|
|
|
else
|
|
|
|
|
q.pp current_value
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
q.breakable
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Check the spec for possible conflicts and freak out if there are any.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def raise_if_conflicts
|
|
|
|
|
other = Gem.loaded_specs[self.name]
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
if other and self.version != other.version then
|
|
|
|
|
# This gem is already loaded. If the currently loaded gem is not in the
|
|
|
|
|
# list of candidate gems, then we have a version conflict.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
msg = "can't activate #{full_name}, already activated #{other.full_name}"
|
|
|
|
|
|
|
|
|
|
e = Gem::LoadError.new msg
|
|
|
|
|
e.name = self.name
|
|
|
|
|
# TODO: e.requirement = dep.requirement
|
|
|
|
|
|
|
|
|
|
raise e
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
conf = self.conflicts
|
|
|
|
|
|
|
|
|
|
unless conf.empty? then
|
|
|
|
|
y = conf.map { |act,con|
|
|
|
|
|
"#{act.full_name} conflicts with #{con.join(", ")}"
|
|
|
|
|
}.join ", "
|
|
|
|
|
|
|
|
|
|
# TODO: improve message by saying who activated `con`
|
|
|
|
|
|
|
|
|
|
raise Gem::LoadError, "Unable to activate #{self.full_name}, because #{y}"
|
|
|
|
|
end
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Sets rdoc_options to +value+, ensuring it is an array. Don't
|
|
|
|
|
# use this, push onto the array instead.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def rdoc_options= options
|
|
|
|
|
# TODO: warn about setting instead of pushing
|
|
|
|
|
@rdoc_options = Array options
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Singular accessor for #require_paths
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def require_path
|
|
|
|
|
val = require_paths and val.first
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Singular accessor for #require_paths
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def require_path= path
|
|
|
|
|
self.require_paths = [path]
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# The RubyGems version required by this gem
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def required_rubygems_version= req
|
|
|
|
|
@required_rubygems_version = Gem::Requirement.create req
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Set requirements to +req+, ensuring it is an array. Don't
|
|
|
|
|
# use this, push onto the array instead.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def requirements= req
|
|
|
|
|
# TODO: warn about setting instead of pushing
|
|
|
|
|
@requirements = Array req
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
def respond_to_missing? m, include_private = false # :nodoc:
|
|
|
|
|
false
|
|
|
|
|
end
|
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Returns the full path to this spec's ri directory.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def ri_dir
|
|
|
|
|
@ri_dir ||= File.join base_dir, 'ri', full_name
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Return a string containing a Ruby code representation of the given
|
|
|
|
|
# object.
|
|
|
|
|
|
|
|
|
|
def ruby_code(obj)
|
|
|
|
|
case obj
|
2011-08-26 05:10:50 +04:00
|
|
|
|
when String then obj.dump
|
2011-06-01 07:45:05 +04:00
|
|
|
|
when Array then '[' + obj.map { |x| ruby_code x }.join(", ") + ']'
|
2012-11-29 10:52:18 +04:00
|
|
|
|
when Hash then
|
|
|
|
|
seg = obj.keys.sort.map { |k| "#{k.to_s.dump} => #{obj[k].to_s.dump}" }
|
|
|
|
|
"{ #{seg.join(', ')} }"
|
2011-08-26 05:10:50 +04:00
|
|
|
|
when Gem::Version then obj.to_s.dump
|
|
|
|
|
when Date then obj.strftime('%Y-%m-%d').dump
|
|
|
|
|
when Time then obj.strftime('%Y-%m-%d').dump
|
2011-06-01 07:45:05 +04:00
|
|
|
|
when Numeric then obj.inspect
|
|
|
|
|
when true, false, nil then obj.inspect
|
|
|
|
|
when Gem::Platform then "Gem::Platform.new(#{obj.to_a.inspect})"
|
2012-12-18 07:16:27 +04:00
|
|
|
|
when Gem::Requirement then
|
|
|
|
|
list = obj.as_list
|
|
|
|
|
"Gem::Requirement.new(#{ruby_code(list.size == 1 ? obj.to_s : list)})"
|
2011-06-01 07:45:05 +04:00
|
|
|
|
else raise Gem::Exception, "ruby_code case not handled: #{obj.class}"
|
|
|
|
|
end
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
private :ruby_code
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# List of dependencies that will automatically be activated at runtime.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def runtime_dependencies
|
|
|
|
|
dependencies.select { |d| d.type == :runtime }
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# True if this gem has the same attributes as +other+.
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def same_attributes? spec
|
|
|
|
|
@@attributes.all? { |name, default| self.send(name) == spec.send(name) }
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
private :same_attributes?
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Checks if this specification meets the requirement of +dependency+.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def satisfies_requirement? dependency
|
|
|
|
|
return @name == dependency.name &&
|
|
|
|
|
dependency.requirement.satisfied_by?(@version)
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Returns an object you can use to sort specifications in #sort_by.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def sort_obj
|
|
|
|
|
[@name, @version, @new_platform == Gem::Platform::RUBY ? -1 : 1]
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
##
|
2013-11-19 04:34:13 +04:00
|
|
|
|
# Used by Gem::Resolver to order Gem::Specification objects
|
2013-09-14 12:59:02 +04:00
|
|
|
|
|
|
|
|
|
def source # :nodoc:
|
2013-11-22 22:53:21 +04:00
|
|
|
|
Gem::Source::Installed.new
|
2013-09-14 12:59:02 +04:00
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Returns the full path to the directory containing this spec's
|
|
|
|
|
# gemspec file. eg: /usr/local/lib/ruby/gems/1.8/specifications
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def spec_dir
|
|
|
|
|
@spec_dir ||= File.join base_dir, "specifications"
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Returns the full path to this spec's gemspec file.
|
|
|
|
|
# eg: /usr/local/lib/ruby/gems/1.8/specifications/mygem-1.0.gemspec
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def spec_file
|
|
|
|
|
@spec_file ||= File.join spec_dir, "#{full_name}.gemspec"
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# The default name of the gemspec. See also #file_name
|
|
|
|
|
#
|
|
|
|
|
# spec.spec_name # => "example-1.0.gemspec"
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def spec_name
|
|
|
|
|
"#{full_name}.gemspec"
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# A short summary of this gem's description.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def summary= str
|
|
|
|
|
@summary = str.to_s.strip.
|
|
|
|
|
gsub(/(\w-)\n[ \t]*(\w)/, '\1\2').gsub(/\n[ \t]*/, " ") # so. weird.
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Singular accessor for #test_files
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def test_file
|
|
|
|
|
val = test_files and val.first
|
|
|
|
|
end
|
2009-03-06 06:56:38 +03:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# Singular mutator for #test_files
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def test_file= file
|
|
|
|
|
self.test_files = [file]
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2009-06-10 01:38:59 +04:00
|
|
|
|
##
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# Test files included in this gem. You cannot append to this accessor, you
|
|
|
|
|
# must assign to it.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def test_files
|
|
|
|
|
# Handle the possibility that we have @test_suite_file but not
|
|
|
|
|
# @test_files. This will happen when an old gem is loaded via
|
|
|
|
|
# YAML.
|
|
|
|
|
if defined? @test_suite_file then
|
|
|
|
|
@test_files = [@test_suite_file].flatten
|
|
|
|
|
@test_suite_file = nil
|
|
|
|
|
end
|
|
|
|
|
if defined?(@test_files) and @test_files then
|
|
|
|
|
@test_files
|
|
|
|
|
else
|
|
|
|
|
@test_files = []
|
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Returns a Ruby code representation of this specification, such that it can
|
|
|
|
|
# be eval'ed and reconstruct the same specification later. Attributes that
|
|
|
|
|
# still have their default values are omitted.
|
|
|
|
|
|
|
|
|
|
def to_ruby
|
|
|
|
|
mark_version
|
|
|
|
|
result = []
|
|
|
|
|
result << "# -*- encoding: utf-8 -*-"
|
2013-10-16 04:14:16 +04:00
|
|
|
|
result << "#{Gem::StubSpecification::PREFIX}#{name} #{version} #{platform} #{@require_paths.join("\0")}"
|
|
|
|
|
result << "#{Gem::StubSpecification::PREFIX}#{extensions.join "\0"}" unless
|
|
|
|
|
extensions.empty?
|
2011-06-01 07:45:05 +04:00
|
|
|
|
result << nil
|
|
|
|
|
result << "Gem::Specification.new do |s|"
|
|
|
|
|
|
|
|
|
|
result << " s.name = #{ruby_code name}"
|
|
|
|
|
result << " s.version = #{ruby_code version}"
|
|
|
|
|
unless platform.nil? or platform == Gem::Platform::RUBY then
|
|
|
|
|
result << " s.platform = #{ruby_code original_platform}"
|
2008-09-25 14:13:50 +04:00
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
result << ""
|
|
|
|
|
result << " s.required_rubygems_version = #{ruby_code required_rubygems_version} if s.respond_to? :required_rubygems_version="
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
if metadata and !metadata.empty?
|
|
|
|
|
result << " s.metadata = #{ruby_code metadata} if s.respond_to? :metadata="
|
|
|
|
|
end
|
2013-10-16 04:14:16 +04:00
|
|
|
|
result << " s.require_paths = #{ruby_code @require_paths}"
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
handled = [
|
|
|
|
|
:dependencies,
|
|
|
|
|
:name,
|
|
|
|
|
:platform,
|
2013-10-16 04:14:16 +04:00
|
|
|
|
:require_paths,
|
2011-06-01 07:45:05 +04:00
|
|
|
|
:required_rubygems_version,
|
|
|
|
|
:specification_version,
|
|
|
|
|
:version,
|
|
|
|
|
:has_rdoc,
|
|
|
|
|
:default_executable,
|
2012-11-29 10:52:18 +04:00
|
|
|
|
:metadata
|
2011-06-01 07:45:05 +04:00
|
|
|
|
]
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
@@attributes.each do |attr_name|
|
|
|
|
|
next if handled.include? attr_name
|
|
|
|
|
current_value = self.send(attr_name)
|
|
|
|
|
if current_value != default_value(attr_name) or
|
|
|
|
|
self.class.required_attribute? attr_name then
|
|
|
|
|
result << " s.#{attr_name} = #{ruby_code current_value}"
|
|
|
|
|
end
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2013-11-10 21:51:40 +04:00
|
|
|
|
if @installed_by_version then
|
2013-10-20 04:31:12 +04:00
|
|
|
|
result << nil
|
2013-11-10 21:51:40 +04:00
|
|
|
|
result << " s.installed_by_version = \"#{Gem::VERSION}\" if s.respond_to? :installed_by_version"
|
2013-10-20 04:31:12 +04:00
|
|
|
|
end
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
unless dependencies.empty? then
|
|
|
|
|
result << nil
|
|
|
|
|
result << " if s.respond_to? :specification_version then"
|
|
|
|
|
result << " s.specification_version = #{specification_version}"
|
|
|
|
|
result << nil
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
result << " if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then"
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
dependencies.each do |dep|
|
|
|
|
|
req = dep.requirements_list.inspect
|
|
|
|
|
dep.instance_variable_set :@type, :runtime if dep.type.nil? # HACK
|
|
|
|
|
result << " s.add_#{dep.type}_dependency(%q<#{dep.name}>, #{req})"
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
result << " else"
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
dependencies.each do |dep|
|
|
|
|
|
version_reqs_param = dep.requirements_list.inspect
|
|
|
|
|
result << " s.add_dependency(%q<#{dep.name}>, #{version_reqs_param})"
|
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
result << ' end'
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
result << " else"
|
2011-06-01 07:45:05 +04:00
|
|
|
|
dependencies.each do |dep|
|
|
|
|
|
version_reqs_param = dep.requirements_list.inspect
|
|
|
|
|
result << " s.add_dependency(%q<#{dep.name}>, #{version_reqs_param})"
|
|
|
|
|
end
|
2012-11-29 10:52:18 +04:00
|
|
|
|
result << " end"
|
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
result << "end"
|
|
|
|
|
result << nil
|
|
|
|
|
|
|
|
|
|
result.join "\n"
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Returns a Ruby lighter-weight code representation of this specification,
|
|
|
|
|
# used for indexing only.
|
|
|
|
|
#
|
|
|
|
|
# See #to_ruby.
|
|
|
|
|
|
|
|
|
|
def to_ruby_for_cache
|
|
|
|
|
for_cache.to_ruby
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def to_s # :nodoc:
|
|
|
|
|
"#<Gem::Specification name=#{@name} version=#{@version}>"
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2013-09-14 12:59:02 +04:00
|
|
|
|
##
|
|
|
|
|
# Returns self
|
|
|
|
|
|
|
|
|
|
def to_spec
|
|
|
|
|
self
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def to_yaml(opts = {}) # :nodoc:
|
|
|
|
|
if YAML.const_defined?(:ENGINE) && !YAML::ENGINE.syck? then
|
2012-04-18 04:04:12 +04:00
|
|
|
|
# Because the user can switch the YAML engine behind our
|
|
|
|
|
# back, we have to check again here to make sure that our
|
|
|
|
|
# psych code was properly loaded, and load it if not.
|
|
|
|
|
unless Gem.const_defined?(:NoAliasYAMLTree)
|
|
|
|
|
require 'rubygems/psych_tree'
|
|
|
|
|
end
|
|
|
|
|
|
2013-07-09 05:27:59 +04:00
|
|
|
|
builder = Gem::NoAliasYAMLTree.create
|
2012-04-18 04:04:12 +04:00
|
|
|
|
builder << self
|
|
|
|
|
ast = builder.tree
|
|
|
|
|
|
2013-11-19 04:34:13 +04:00
|
|
|
|
io = Gem::StringSink.new
|
2012-11-29 10:52:18 +04:00
|
|
|
|
io.set_encoding Encoding::UTF_8 if Object.const_defined? :Encoding
|
2012-04-18 04:04:12 +04:00
|
|
|
|
|
|
|
|
|
Psych::Visitors::Emitter.new(io).accept(ast)
|
|
|
|
|
|
|
|
|
|
io.string.gsub(/ !!null \n/, " \n")
|
2009-06-10 01:38:59 +04:00
|
|
|
|
else
|
2011-06-01 07:45:05 +04:00
|
|
|
|
YAML.quick_emit object_id, opts do |out|
|
|
|
|
|
out.map taguri, to_yaml_style do |map|
|
|
|
|
|
encode_with map
|
|
|
|
|
end
|
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Recursively walk dependencies of this spec, executing the +block+ for each
|
|
|
|
|
# hop.
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def traverse trail = [], &block
|
|
|
|
|
trail = trail + [self]
|
|
|
|
|
runtime_dependencies.each do |dep|
|
|
|
|
|
dep.to_specs.each do |dep_spec|
|
|
|
|
|
block[self, dep, dep_spec, trail + [dep_spec]]
|
|
|
|
|
dep_spec.traverse(trail, &block) unless
|
|
|
|
|
trail.map(&:name).include? dep_spec.name
|
|
|
|
|
end
|
|
|
|
|
end
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2008-09-25 14:13:50 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Checks that the specification contains all required fields, and does a
|
|
|
|
|
# very basic sanity check.
|
|
|
|
|
#
|
|
|
|
|
# Raises InvalidSpecificationException if the spec does not pass the
|
|
|
|
|
# checks..
|
2009-06-10 01:38:59 +04:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def validate packaging = true
|
2013-10-16 04:14:16 +04:00
|
|
|
|
@warnings = 0
|
2011-06-01 07:45:05 +04:00
|
|
|
|
require 'rubygems/user_interaction'
|
|
|
|
|
extend Gem::UserInteraction
|
|
|
|
|
normalize
|
|
|
|
|
|
|
|
|
|
nil_attributes = self.class.non_nil_attributes.find_all do |name|
|
|
|
|
|
instance_variable_get("@#{name}").nil?
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
unless nil_attributes.empty? then
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"#{nil_attributes.join ', '} must not be nil"
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
if packaging and rubygems_version != Gem::VERSION then
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"expected RubyGems version #{Gem::VERSION}, was #{rubygems_version}"
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
@@required_attributes.each do |symbol|
|
|
|
|
|
unless self.send symbol then
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"missing value for attribute #{symbol}"
|
2008-09-25 14:13:50 +04:00
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
unless String === name then
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"invalid value for attribute name: \"#{name.inspect}\""
|
2008-09-25 14:13:50 +04:00
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
if @require_paths.empty? then
|
2011-06-01 07:45:05 +04:00
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
'specification must have at least one require_path'
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
@files.delete_if { |x| File.directory?(x) }
|
|
|
|
|
@test_files.delete_if { |x| File.directory?(x) }
|
|
|
|
|
@executables.delete_if { |x| File.directory?(File.join(@bindir, x)) }
|
|
|
|
|
@extra_rdoc_files.delete_if { |x| File.directory?(x) }
|
|
|
|
|
@extensions.delete_if { |x| File.directory?(x) }
|
|
|
|
|
|
|
|
|
|
non_files = files.reject { |x| File.file?(x) }
|
|
|
|
|
|
|
|
|
|
unless not packaging or non_files.empty? then
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"[\"#{non_files.join "\", \""}\"] are not files"
|
|
|
|
|
end
|
|
|
|
|
|
2013-09-19 01:29:41 +04:00
|
|
|
|
if files.include? file_name then
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"#{full_name} contains itself (#{file_name}), check your files list"
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
unless specification_version.is_a?(Fixnum)
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
'specification_version must be a Fixnum (did you mean version?)'
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
case platform
|
|
|
|
|
when Gem::Platform, Gem::Platform::RUBY then # ok
|
2009-06-10 01:38:59 +04:00
|
|
|
|
else
|
2011-06-01 07:45:05 +04:00
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"invalid platform #{platform.inspect}, see Gem::Platform"
|
2009-06-10 01:38:59 +04:00
|
|
|
|
end
|
2007-11-10 10:48:56 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
self.class.array_attributes.each do |field|
|
|
|
|
|
val = self.send field
|
|
|
|
|
klass = case field
|
|
|
|
|
when :dependencies
|
|
|
|
|
Gem::Dependency
|
|
|
|
|
else
|
|
|
|
|
String
|
|
|
|
|
end
|
2011-03-01 12:41:32 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
unless Array === val and val.all? { |x| x.kind_of?(klass) } then
|
|
|
|
|
raise(Gem::InvalidSpecificationException,
|
|
|
|
|
"#{field} must be an Array of #{klass}")
|
|
|
|
|
end
|
|
|
|
|
end
|
2011-03-01 12:41:32 +03:00
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
[:authors].each do |field|
|
|
|
|
|
val = self.send field
|
|
|
|
|
raise Gem::InvalidSpecificationException, "#{field} may not be empty" if
|
|
|
|
|
val.empty?
|
2011-03-01 12:41:32 +03:00
|
|
|
|
end
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
unless Hash === metadata
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
'metadata must be a hash'
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
metadata.keys.each do |k|
|
|
|
|
|
if !k.kind_of?(String)
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
'metadata keys must be a String'
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
if k.size > 128
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"metadata key too large (#{k.size} > 128)"
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
metadata.values.each do |k|
|
|
|
|
|
if !k.kind_of?(String)
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
'metadata values must be a String'
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
if k.size > 1024
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"metadata value too large (#{k.size} > 1024)"
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
licenses.each { |license|
|
|
|
|
|
if license.length > 64
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"each license must be 64 characters or less"
|
2011-03-01 12:41:32 +03:00
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
}
|
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
warning <<-warning if licenses.empty?
|
2013-11-22 03:27:30 +04:00
|
|
|
|
licenses is empty, but is recommended. Use a license abbreviation from:
|
|
|
|
|
http://opensource.org/licenses/alphabetical
|
2013-10-16 04:14:16 +04:00
|
|
|
|
warning
|
2012-11-29 10:52:18 +04:00
|
|
|
|
|
|
|
|
|
validate_permissions
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
# reject lazy developers:
|
|
|
|
|
|
|
|
|
|
lazy = '"FIxxxXME" or "TOxxxDO"'.gsub(/xxx/, '')
|
|
|
|
|
|
|
|
|
|
unless authors.grep(/FI XME|TO DO/x).empty? then
|
|
|
|
|
raise Gem::InvalidSpecificationException, "#{lazy} is not an author"
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
unless Array(email).grep(/FI XME|TO DO/x).empty? then
|
|
|
|
|
raise Gem::InvalidSpecificationException, "#{lazy} is not an email"
|
2011-03-01 12:41:32 +03:00
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
if description =~ /FI XME|TO DO/x then
|
|
|
|
|
raise Gem::InvalidSpecificationException, "#{lazy} is not a description"
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
if summary =~ /FI XME|TO DO/x then
|
|
|
|
|
raise Gem::InvalidSpecificationException, "#{lazy} is not a summary"
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
if homepage and not homepage.empty? and
|
|
|
|
|
homepage !~ /\A[a-z][a-z\d+.-]*:/i then
|
|
|
|
|
raise Gem::InvalidSpecificationException,
|
|
|
|
|
"\"#{homepage}\" is not a URI"
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
# Warnings
|
|
|
|
|
|
|
|
|
|
%w[author description email homepage summary].each do |attribute|
|
|
|
|
|
value = self.send attribute
|
2013-10-16 04:14:16 +04:00
|
|
|
|
warning "no #{attribute} specified" if value.nil? or value.empty?
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
if description == summary then
|
2013-10-16 04:14:16 +04:00
|
|
|
|
warning 'description and summary are identical'
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
# TODO: raise at some given date
|
2013-10-16 04:14:16 +04:00
|
|
|
|
warning "deprecated autorequire specified" if autorequire
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
executables.each do |executable|
|
|
|
|
|
executable_path = File.join(bindir, executable)
|
|
|
|
|
shebang = File.read(executable_path, 2) == '#!'
|
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
warning "#{executable_path} is missing #! line" unless shebang
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
|
|
|
|
|
2013-11-10 21:51:40 +04:00
|
|
|
|
validate_dependencies
|
|
|
|
|
|
|
|
|
|
true
|
|
|
|
|
ensure
|
|
|
|
|
if $! or @warnings > 0 then
|
|
|
|
|
alert_warning "See http://guides.rubygems.org/specification-reference/ for help"
|
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
##
|
|
|
|
|
# Checks that dependencies use requirements as we recommend. Warnings are
|
|
|
|
|
# issued when dependencies are open-ended or overly strict for semantic
|
|
|
|
|
# versioning.
|
|
|
|
|
|
|
|
|
|
def validate_dependencies # :nodoc:
|
|
|
|
|
seen = {}
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
dependencies.each do |dep|
|
2013-11-10 21:51:40 +04:00
|
|
|
|
if prev = seen[dep.name] then
|
|
|
|
|
raise Gem::InvalidSpecificationException, <<-MESSAGE
|
|
|
|
|
duplicate dependency on #{dep}, (#{prev.requirement}) use:
|
|
|
|
|
add_runtime_dependency '#{dep.name}', '#{dep.requirement}', '#{prev.requirement}'
|
|
|
|
|
MESSAGE
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
seen[dep.name] = dep
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
prerelease_dep = dep.requirements_list.any? do |req|
|
|
|
|
|
Gem::Requirement.new(req).prerelease?
|
|
|
|
|
end
|
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
warning "prerelease dependency on #{dep} is not recommended" if
|
2012-11-29 10:52:18 +04:00
|
|
|
|
prerelease_dep
|
|
|
|
|
|
2013-11-10 21:51:40 +04:00
|
|
|
|
overly_strict = dep.requirement.requirements.length == 1 &&
|
|
|
|
|
dep.requirement.requirements.any? do |op, version|
|
|
|
|
|
op == '~>' and
|
|
|
|
|
not version.prerelease? and
|
|
|
|
|
version.segments.length > 2
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
if overly_strict then
|
|
|
|
|
_, dep_version = dep.requirement.requirements.first
|
|
|
|
|
|
|
|
|
|
base = dep_version.segments.first 2
|
|
|
|
|
|
|
|
|
|
warning <<-WARNING
|
|
|
|
|
pessimistic dependency on #{dep} may be overly strict
|
|
|
|
|
if #{dep.name} is semantically versioned, use:
|
|
|
|
|
add_#{dep.type}_dependency '#{dep.name}', '~> #{base.join '.'}', '>= #{dep_version}'
|
|
|
|
|
WARNING
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
open_ended = dep.requirement.requirements.all? do |op, version|
|
|
|
|
|
not version.prerelease? and (op == '>' or op == '>=')
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
if open_ended then
|
|
|
|
|
op, dep_version = dep.requirement.requirements.first
|
|
|
|
|
|
|
|
|
|
base = dep_version.segments.first 2
|
|
|
|
|
|
|
|
|
|
bugfix = if op == '>' then
|
|
|
|
|
", '> #{dep_version}'"
|
|
|
|
|
elsif op == '>=' and base != dep_version.segments then
|
|
|
|
|
", '>= #{dep_version}'"
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
warning <<-WARNING
|
|
|
|
|
open-ended dependency on #{dep} is not recommended
|
|
|
|
|
if #{dep.name} is semantically versioned, use:
|
|
|
|
|
add_#{dep.type}_dependency '#{dep.name}', '~> #{base.join '.'}'#{bugfix}
|
|
|
|
|
WARNING
|
|
|
|
|
end
|
2013-10-16 04:14:16 +04:00
|
|
|
|
end
|
2011-03-01 12:41:32 +03:00
|
|
|
|
end
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
|
|
|
|
# Checks to see if the files to be packaged are world-readable.
|
|
|
|
|
|
|
|
|
|
def validate_permissions
|
2012-12-06 09:13:08 +04:00
|
|
|
|
return if Gem.win_platform?
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
files.each do |file|
|
2012-12-06 09:13:08 +04:00
|
|
|
|
next if File.stat(file).mode & 0444 == 0444
|
2013-10-16 04:14:16 +04:00
|
|
|
|
warning "#{file} is not world-readable"
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
|
|
|
|
|
2012-12-06 09:13:08 +04:00
|
|
|
|
executables.each do |name|
|
|
|
|
|
exec = File.join @bindir, name
|
|
|
|
|
next if File.stat(exec).executable?
|
2013-10-16 04:14:16 +04:00
|
|
|
|
warning "#{exec} is not executable"
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
##
|
|
|
|
|
# Set the version to +version+, potentially also setting
|
|
|
|
|
# required_rubygems_version if +version+ indicates it is a
|
|
|
|
|
# prerelease.
|
|
|
|
|
|
|
|
|
|
def version= version
|
|
|
|
|
@version = Gem::Version.create(version)
|
|
|
|
|
self.required_rubygems_version = '> 1.3.1' if @version.prerelease?
|
2012-11-29 10:52:18 +04:00
|
|
|
|
invalidate_memoized_attributes
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
return @version
|
2011-03-01 12:41:32 +03:00
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
2013-11-10 21:51:40 +04:00
|
|
|
|
def stubbed?
|
|
|
|
|
false
|
|
|
|
|
end
|
|
|
|
|
|
2011-06-01 07:45:05 +04:00
|
|
|
|
def yaml_initialize(tag, vals) # :nodoc:
|
|
|
|
|
vals.each do |ivar, val|
|
2012-04-18 04:04:12 +04:00
|
|
|
|
case ivar
|
|
|
|
|
when "date"
|
|
|
|
|
# Force Date to go through the extra coerce logic in date=
|
|
|
|
|
self.date = val.untaint
|
|
|
|
|
else
|
|
|
|
|
instance_variable_set "@#{ivar}", val.untaint
|
|
|
|
|
end
|
2011-06-01 07:45:05 +04:00
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
@original_platform = @platform # for backwards compatibility
|
|
|
|
|
self.platform = Gem::Platform.new @platform
|
|
|
|
|
end
|
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
##
|
|
|
|
|
# Reset nil attributes to their default values to make the spec valid
|
2012-11-29 12:10:23 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
def reset_nil_attributes_to_default
|
|
|
|
|
nil_attributes = self.class.non_nil_attributes.find_all do |name|
|
|
|
|
|
!instance_variable_defined?("@#{name}") || instance_variable_get("@#{name}").nil?
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
nil_attributes.each do |attribute|
|
|
|
|
|
default = self.default_value attribute
|
|
|
|
|
|
|
|
|
|
value = case default
|
|
|
|
|
when Time, Numeric, Symbol, true, false, nil then default
|
|
|
|
|
else default.dup
|
|
|
|
|
end
|
|
|
|
|
|
|
|
|
|
instance_variable_set "@#{attribute}", value
|
|
|
|
|
end
|
2013-11-10 21:51:40 +04:00
|
|
|
|
|
|
|
|
|
@installed_by_version ||= nil
|
2012-11-29 10:52:18 +04:00
|
|
|
|
end
|
|
|
|
|
|
2013-10-16 04:14:16 +04:00
|
|
|
|
def warning statement # :nodoc:
|
|
|
|
|
@warnings += 1
|
|
|
|
|
|
|
|
|
|
alert_warning statement
|
|
|
|
|
end
|
|
|
|
|
|
2011-10-04 02:15:47 +04:00
|
|
|
|
extend Gem::Deprecate
|
2011-06-01 07:45:05 +04:00
|
|
|
|
|
|
|
|
|
# TODO:
|
|
|
|
|
# deprecate :has_rdoc, :none, 2011, 10
|
|
|
|
|
# deprecate :has_rdoc?, :none, 2011, 10
|
|
|
|
|
# deprecate :has_rdoc=, :none, 2011, 10
|
|
|
|
|
# deprecate :default_executable, :none, 2011, 10
|
|
|
|
|
# deprecate :default_executable=, :none, 2011, 10
|
|
|
|
|
# deprecate :file_name, :cache_file, 2011, 10
|
|
|
|
|
# deprecate :full_gem_path, :cache_file, 2011, 10
|
2007-11-10 10:48:56 +03:00
|
|
|
|
end
|
2011-07-07 01:19:59 +04:00
|
|
|
|
|
2012-11-29 10:52:18 +04:00
|
|
|
|
# DOC: What is this and why is it here, randomly, at the end of this file?
|
2011-07-07 01:19:59 +04:00
|
|
|
|
Gem.clear_paths
|