Gem::Specification

 
               # File rubygems/specification.rb, line 545
def add_development_dependency(gem, *requirements)
  add_dependency_with_type(gem, :development, requirements)
end
            

 
               # File rubygems/specification.rb, line 556
def add_runtime_dependency(gem, *requirements)
  add_dependency_with_type(gem, :runtime, requirements)
end
            

 
               # File rubygems/specification.rb, line 406
def author=(o)
  self.authors = [o]
end
            

 
               # File rubygems/specification.rb, line 575
def executables
  @executables ||= []
end
            

 
               # File rubygems/specification.rb, line 592
def extensions
  @extensions ||= []
end
            

 
               # File rubygems/specification.rb, line 608
def extra_rdoc_files
  @extra_rdoc_files ||= []
end
            

 
               # File rubygems/specification.rb, line 457
def platform=(platform)
  if @original_platform.nil? or
     @original_platform == Gem::Platform::RUBY
    @original_platform = platform
  end

  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
            

 
               # File rubygems/specification.rb, line 638
def rdoc_options
  @rdoc_options ||= []
end
            

 
               # File rubygems/specification.rb, line 508
def require_paths=(val)
  @require_paths = Array(val)
end
            

 
               # File rubygems/specification.rb, line 663
def required_ruby_version=(req)
  @required_ruby_version = Gem::Requirement.create req
end
            

 
               # File rubygems/specification.rb, line 670
def required_rubygems_version=(req)
  @required_rubygems_version = Gem::Requirement.create req
end
            

 
               # File rubygems/specification.rb, line 683
def requirements
  @requirements ||= []
end
            

 
               # File rubygems/specification.rb, line 343
def license=(o)
  self.licenses = [o]
end
            

 
               # File rubygems/specification.rb, line 360
def licenses=(licenses)
  @licenses = Array licenses
end
            

 
               # File rubygems/specification.rb, line 275
def authors=(value)
  @authors = Array(value).flatten.grep(String)
end
            

 
               # File rubygems/specification.rb, line 254
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,
           ].flatten.compact.uniq.sort
end
            

 
               # File rubygems/specification.rb, line 1264
def self._load(str)
  Gem.load_yaml

  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
                  spec.instance_variable_set :@specification_version,
                                             current_version
                  MARSHAL_FIELDS[current_version]
                else
                  MARSHAL_FIELDS[spec.specification_version]
                end

  if array.size < field_count
    raise TypeError, "invalid Gem::Specification format #{array.inspect}"
  end

  # 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 }

  spec.instance_variable_set :@rubygems_version,          array[0]
  # spec version
  spec.instance_variable_set :@name,                      array[2]
  spec.instance_variable_set :@version,                   array[3]
  spec.date =                                             array[4]
  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]
  # offset due to rubyforge_project removal
  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]
  spec.instance_variable_set :@metadata,                  array[18]
  spec.instance_variable_set :@loaded,                    false
  spec.instance_variable_set :@activated,                 false

  spec
end
            

 
               # File rubygems/specification.rb, line 880
def self.all
  warn "NOTE: Specification.all called from #{caller.first}" unless
    Gem::Deprecate.skip
  _all
end
            

 
               # File rubygems/specification.rb, line 898
def self.all=(specs)
  @@stubs_by_name = specs.group_by(&:name)
  @@all = @@stubs = specs
end
            

 
               # File rubygems/specification.rb, line 906
def self.all_names
  self._all.map(&:full_name)
end
            

 
               # File rubygems/specification.rb, line 915
def self.array_attributes
  @@array_attributes.dup
end
            

 
               # File rubygems/specification.rb, line 924
def self.attribute_names
  @@attributes.dup
end
            

 
               # File rubygems/specification.rb, line 827
def self.default_stubs(pattern = "*.gemspec")
  base_dir = Gem.default_dir
  gems_dir = File.join base_dir, "gems"
  gemspec_stubs_in(Gem.default_specifications_dir, pattern) do |path|
    Gem::StubSpecification.default_gemspec_stub(path, base_dir, gems_dir)
  end
end
            

 
               # File rubygems/specification.rb, line 931
def self.dirs
  @@dirs ||= Gem.path.collect do |dir|
    File.join dir.dup.tap(&Gem::UNTAINT), "specifications"
  end
end
            

 
               # File rubygems/specification.rb, line 941
def self.dirs=(dirs)
  self.reset

  @@dirs = Array(dirs).map { |dir| File.join dir, "specifications" }
end
            

 
               # File rubygems/specification.rb, line 953
def self.each
  return enum_for(:each) unless block_given?

  self._all.each do |x|
    yield x
  end
end
            

 
               # File rubygems/specification.rb, line 1016
def self.find_active_stub_by_path(path)
  stub = @@active_stub_with_requirable_file[path] ||= (stubs.find do |s|
    s.activated? and s.contains_requirable_file? path
  end || NOT_FOUND)
  stub.this
end
            

 
               # File rubygems/specification.rb, line 975
def self.find_all_by_full_name(full_name)
  stubs.select {|s| s.full_name == full_name }.map(&:to_spec)
end
            

 
               # File rubygems/specification.rb, line 964
def self.find_all_by_name(name, *requirements)
  requirements = Gem::Requirement.default if requirements.empty?

  # TODO: maybe try: find_all { |s| spec === dep }

  Gem::Dependency.new(name, *requirements).matching_specs
end
            

 
               # File rubygems/specification.rb, line 983
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
            

 
               # File rubygems/specification.rb, line 994
def self.find_by_path(path)
  path = path.dup.freeze
  spec = @@spec_with_requirable_file[path] ||= (stubs.find do |s|
    next unless Gem::BundlerVersionFinder.compatible?(s)
    s.contains_requirable_file? path
  end || NOT_FOUND)
  spec.to_spec
end
            

 
               # File rubygems/specification.rb, line 1026
def self.find_in_unresolved(path)
  # TODO: do we need these?? Kill it
  specs = unresolved_deps.values.map { |dep| dep.to_specs }.flatten

  specs.find_all { |spec| spec.contains_requirable_file? path }
end
            

 
               # File rubygems/specification.rb, line 1037
def self.find_in_unresolved_tree(path)
  specs = unresolved_deps.values.map { |dep| dep.to_specs }.flatten

  specs.each do |spec|
    spec.traverse do |from_spec, dep, to_spec, trail|
      if to_spec.has_conflicts? || to_spec.conficts_when_loaded_with?(trail)
        :next
      else
        return trail.reverse if to_spec.contains_requirable_file? path
      end
    end
  end

  []
end
            

 
               # File rubygems/specification.rb, line 1007
def self.find_inactive_by_path(path)
  stub = stubs.find do |s|
    next if s.activated?
    next unless Gem::BundlerVersionFinder.compatible?(s)
    s.contains_requirable_file? path
  end
  stub && stub.to_spec
end
            

 
               # File rubygems/specification.rb, line 1061
def self.from_yaml(input)
  Gem.load_yaml

  input = normalize_yaml_input input
  spec = Gem::SafeYAML.safe_load input

  if spec && spec.class == FalseClass
    raise Gem::EndOfYAMLException
  end

  unless Gem::Specification === spec
    raise Gem::Exception, "YAML data doesn't evaluate to gem specification"
  end

  spec.specification_version ||= NONEXISTENT_SPECIFICATION_VERSION
  spec.reset_nil_attributes_to_default

  spec
end
            

 
               # File rubygems/specification.rb, line 1085
def self.latest_specs(prerelease = false)
  _latest_specs Gem::Specification._all, prerelease
end
            

 
               # File rubygems/specification.rb, line 1109
def self.load(file)
  return unless file

  _spec = LOAD_CACHE_MUTEX.synchronize { LOAD_CACHE[file] }
  return _spec if _spec

  file = file.dup.tap(&Gem::UNTAINT)
  return unless File.file?(file)

  code = File.read file, :mode => 'r:UTF-8:-'

  code.tap(&Gem::UNTAINT)

  begin
    _spec = eval code, binding, file

    if Gem::Specification === _spec
      _spec.loaded_from = File.expand_path file.to_s
      LOAD_CACHE_MUTEX.synchronize do
        prev = LOAD_CACHE[file]
        if prev
          _spec = prev
        else
          LOAD_CACHE[file] = _spec
        end
      end
      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

  nil
end
            

 
               # File rubygems/specification.rb, line 868
def self.load_defaults
  each_spec([Gem.default_specifications_dir]) do |spec|
    # #load returns nil if the spec is bad, so we just ignore
    # it at this stage
    Gem.register_default_spec(spec)
  end
end
            

 
               # File rubygems/specification.rb, line 1990
def initialize(name = nil, version = nil)
  super()
  @gems_dir              = nil
  @base_dir              = nil
  @loaded = false
  @activated = false
  @loaded_from = nil
  @original_platform = nil
  @installed_by_version = nil

  set_nil_attributes_to_nil
  set_not_nil_attributes_to_default_values

  @new_platform = Gem::Platform::RUBY

  self.name = name if name
  self.version = version if version

  yield self if block_given?
end
            

 
               # File rubygems/specification.rb, line 1151
def self.non_nil_attributes
  @@non_nil_attributes.dup
end
            

 
               # File rubygems/specification.rb, line 1158
def self.normalize_yaml_input(input)
  result = input.respond_to?(:read) ? input.read : input
  result = "--- " + result unless result =~ /\A--- /
  result = result.dup
  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
end
            

 
               # File rubygems/specification.rb, line 1176
def self.outdated
  outdated_and_latest_version.map { |local, _| local.name }
end
            

 
               # File rubygems/specification.rb, line 1187
def self.outdated_and_latest_version
  return enum_for __method__ unless block_given?

  # TODO: maybe we should switch to rubygems' version service?
  fetcher = Gem::SpecFetcher.fetcher

  latest_specs(true).each do |local_spec|
    dependency =
      Gem::Dependency.new local_spec.name, ">= #{local_spec.version}"

    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
  end

  nil
end
            

 
               # File rubygems/specification.rb, line 1212
def self.required_attribute?(name)
  @@required_attributes.include? name.to_sym
end
            

 
               # File rubygems/specification.rb, line 1219
def self.required_attributes
  @@required_attributes.dup
end
            

 
               # File rubygems/specification.rb, line 1227
def self.reset
  @@dirs = nil
  Gem.pre_reset_hooks.each { |hook| hook.call }
  @@all = nil
  @@stubs = nil
  @@stubs_by_name = {}
  @@spec_with_requirable_file = {}
  @@active_stub_with_requirable_file = {}
  _clear_load_cache
  unresolved = unresolved_deps
  unless unresolved.empty?
    w = "W" + "ARN"
    warn "#{w}: Unresolved or ambiguous specs during Gem::Specification.reset:"
    unresolved.values.each do |dep|
      warn "      #{dep}"

      versions = find_all_by_name(dep.name)
      unless versions.empty?
        warn "      Available/installed versions of this gem:"
        versions.each { |s| warn "      - #{s.version}" }
      end
    end
    warn "#{w}: Clearing out unresolved specs. Try 'gem cleanup <gem>'"
    warn "Please report a bug if this causes problems."
    unresolved.clear
  end
  Gem.post_reset_hooks.each { |hook| hook.call }
end
            

 
               # File rubygems/specification.rb, line 812
def self.stubs
  @@stubs ||= begin
    pattern = "*.gemspec"
    stubs = Gem.loaded_specs.values + installed_stubs(dirs, pattern) + default_stubs(pattern)
    stubs = uniq_by(stubs) { |stub| stub.full_name }

    _resort!(stubs)
    @@stubs_by_name = stubs.select { |s| Gem::Platform.match s.platform }.group_by(&:name)
    stubs
  end
end
            

 
               # File rubygems/specification.rb, line 841
def self.stubs_for(name)
  if @@stubs
    @@stubs_by_name[name] || []
  else
    pattern = "#{name}-*.gemspec"
    stubs = Gem.loaded_specs.values +
      installed_stubs(dirs, pattern).select { |s| Gem::Platform.match s.platform } +
      default_stubs(pattern)
    stubs = uniq_by(stubs) { |stub| stub.full_name }.group_by(&:name)
    stubs.each_value { |v| _resort!(v) }

    @@stubs_by_name.merge! stubs
    @@stubs_by_name[name] ||= EMPTY
  end
end
            

 
               # File rubygems/specification.rb, line 1257
def self.unresolved_deps
  @unresolved_deps ||= Hash.new { |h, n| h[n] = Gem::Dependency.new n }
end
            

 
               # File rubygems/specification.rb, line 1334
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,
    @licenses,
    @metadata
  ]
end
            

 
               # File rubygems/specification.rb, line 1421
def abbreviate
  self.files = []
  self.test_files = []
  self.rdoc_options = []
  self.extra_rdoc_files = []
  self.cert_chain = []
end
            

 
               # File rubygems/specification.rb, line 1364
def activate
  other = Gem.loaded_specs[self.name]
  if other
    check_version_conflict other
    return false
  end

  raise_if_conflicts

  activate_dependencies
  add_self_to_load_path

  Gem.loaded_specs[self.name] = self
  @activated = true
  @loaded = true

  return true
end
            

 
               # File rubygems/specification.rb, line 1388
def activate_dependencies
  unresolved = Gem::Specification.unresolved_deps

  self.runtime_dependencies.each do |spec_dep|
    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

    specs = spec_dep.to_specs

    if specs.size == 1
      specs.first.activate
    else
      name = spec_dep.name
      unresolved[name] = unresolved[name].merge spec_dep
    end
  end

  unresolved.delete self.name
end
            

 
               # File rubygems/specification.rb, line 1463
def add_bindir(executables)
  return nil if executables.nil?

  if @bindir
    Array(executables).map { |e| File.join(@bindir, e) }
  else
    executables
  end
rescue
  return nil
end
            

 
               # File rubygems/specification.rb, line 1502
def add_self_to_load_path
  return if default_gem?

  paths = full_require_paths

  Gem.add_to_load_path(*paths)
end
            

 
               # File rubygems/specification.rb, line 1513
def author
  val = authors and val.first
end
            

 
               # File rubygems/specification.rb, line 1522
def authors
  @authors ||= []
end
            

 
               # File rubygems/specification.rb, line 2036
def base_dir
  return Gem.dir unless loaded_from
  @base_dir ||= if default_gem?
                  File.dirname File.dirname File.dirname loaded_from
                else
                  File.dirname File.dirname loaded_from
                end
end
            

 
               # File rubygems/specification.rb, line 1532
def bin_dir
  @bin_dir ||= File.join gem_dir, bindir
end
            

 
               # File rubygems/specification.rb, line 1539
def bin_file(name)
  File.join bin_dir, name
end
            

 
               # File rubygems/specification.rb, line 1546
def build_args
  if File.exist? build_info_file
    build_info = File.readlines build_info_file
    build_info = build_info.map { |x| x.strip }
    build_info.delete ""
    build_info
  else
    []
  end
end
            

 
               # File rubygems/specification.rb, line 1593
def build_info_dir
  File.join base_dir, "build_info"
end
            

 
               # File rubygems/specification.rb, line 1601
def build_info_file
  File.join build_info_dir, "#{full_name}.info"
end
            

 
               # File rubygems/specification.rb, line 1609
def cache_dir
  @cache_dir ||= File.join base_dir, "cache"
end
            

 
               # File rubygems/specification.rb, line 1616
def cache_file
  @cache_file ||= File.join cache_dir, "#{full_name}.gem"
end
            

 
               # File rubygems/specification.rb, line 1623
def conflicts
  conflicts = {}
  self.runtime_dependencies.each do |dep|
    spec = Gem.loaded_specs[dep.name]
    if spec and not spec.satisfies_requirement? dep
      (conflicts[spec] ||= []) << dep
    end
  end
  env_req = Gem.env_requirement(name)
  (conflicts[self] ||= []) << env_req unless env_req.satisfied_by? version
  conflicts
end
            

 
               # File rubygems/specification.rb, line 1669
def date
  @date ||= Time.utc(*Gem.source_date_epoch.utc.to_a[3..5].reverse)
end
            

 
               # File rubygems/specification.rb, line 1689
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
            if DateTimeFormat =~ date
              Time.utc($1.to_i, $2.to_i, $3.to_i)

            # 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
              Time.utc($1.to_i, $2.to_i, $3.to_i)
            else
              raise(Gem::InvalidSpecificationException,
                    "invalid date format in specification: #{date.inspect}")
            end
          when Time, DateLike then
            Time.utc(date.year, date.month, date.day)
          else
            TODAY
          end
end
            

 
               # File rubygems/specification.rb, line 1735
def default_value(name)
  @@default_value[name]
end
            

 
               # File rubygems/specification.rb, line 1745
def dependencies
  @dependencies ||= []
end
            

 
               # File rubygems/specification.rb, line 1755
def dependent_gems
  out = []
  Gem::Specification.each do |spec|
    spec.dependencies.each do |dep|
      if self.satisfies_requirement?(dep)
        sats = []
        find_all_satisfiers(dep) do |sat|
          sats << sat
        end
        out << [spec, dep, sats]
      end
    end
  end
  out
end
            

 
               # File rubygems/specification.rb, line 1774
def dependent_specs
  runtime_dependencies.map { |dep| dep.to_specs }.flatten
end
            

 
               # File rubygems/specification.rb, line 1781
def description=(str)
  @description = str.to_s
end
            

 
               # File rubygems/specification.rb, line 1788
def development_dependencies
  dependencies.select { |d| d.type == :development }
end
            

 
               # File rubygems/specification.rb, line 1800
def doc_dir(type = nil)
  @doc_dir ||= File.join base_dir, 'doc', full_name

  if type
    File.join @doc_dir, type
  else
    @doc_dir
  end
end
            

 
               # File rubygems/specification.rb, line 1838
def executable
  val = executables and val.first
end
            

 
               # File rubygems/specification.rb, line 1845
def executable=(o)
  self.executables = [o]
end
            

 
               # File rubygems/specification.rb, line 1853
def executables=(value)
  # TODO: warn about setting instead of pushing
  @executables = Array(value)
end
            

 
               # File rubygems/specification.rb, line 1862
def extensions=(extensions)
  # TODO: warn about setting instead of pushing
  @extensions = Array extensions
end
            

 
               # File rubygems/specification.rb, line 1871
def extra_rdoc_files=(files)
  # TODO: warn about setting instead of pushing
  @extra_rdoc_files = Array files
end
            

 
               # File rubygems/specification.rb, line 1881
def file_name
  "#{full_name}.gem"
end
            

 
               # File rubygems/specification.rb, line 1888
def files=(files)
  @files = Array files
end
            

 
               # File rubygems/specification.rb, line 1906
def for_cache
  spec = dup

  spec.files = nil
  spec.test_files = nil

  spec
end
            

 
               # File rubygems/specification.rb, line 1915
def full_name
  @full_name ||= super
end
            

 
               # File rubygems/specification.rb, line 1926
def gems_dir
  @gems_dir ||= File.join(base_dir, "gems")
end
            

 
               # File rubygems/specification.rb, line 1649
def has_conflicts?
  return true unless Gem.env_requirement(name).satisfied_by?(version)
  self.dependencies.any? do |dep|
    if dep.runtime?
      spec = Gem.loaded_specs[dep.name]
      spec and not spec.satisfies_requirement? dep
    else
      false
    end
  end
end
            

 
               # File rubygems/specification.rb, line 2014
def initialize_copy(other_spec)
  self.class.array_attributes.each do |name|
    name = :"@#{name}"
    next unless other_spec.instance_variable_defined? name

    begin
      val = other_spec.instance_variable_get(name)
      if val
        instance_variable_set name, val.dup
      elsif Gem.configuration.really_verbose
        warn "WARNING: #{full_name} has an invalid nil value for #{name}"
      end
    rescue TypeError
      e = Gem::FormatException.new \
        "#{full_name} has an invalid value for #{name}"

      e.file_path = loaded_from
      raise e
    end
  end
end
            

 
               # File rubygems/specification.rb, line 2593
def keep_only_files_and_directories
  @executables.delete_if      { |x| File.directory?(File.join(@bindir, x)) }
  @extensions.delete_if       { |x| File.directory?(x) && !File.symlink?(x) }
  @extra_rdoc_files.delete_if { |x| File.directory?(x) && !File.symlink?(x) }
  @files.delete_if            { |x| File.directory?(x) && !File.symlink?(x) }
  @test_files.delete_if       { |x| File.directory?(x) && !File.symlink?(x) }
end
            

 
               # File rubygems/specification.rb, line 2067
def lib_files
  @files.select do |file|
    require_paths.any? do |path|
      file.start_with? path
    end
  end
end
            

 
               # File rubygems/specification.rb, line 2078
def license
  licenses.first
end
            

 
               # File rubygems/specification.rb, line 2087
def licenses
  @licenses ||= []
end
            

 
               # File rubygems/specification.rb, line 2105
def mark_version
  @rubygems_version = Gem::VERSION
end
            

 
               # File rubygems/specification.rb, line 2125
def missing_extensions?
  return false if default_gem?
  return false if extensions.empty?
  return false if installed_by_version < Gem::Version.new('2.2.0.preview.2')
  return false if File.exist? gem_build_complete_path

  true
end
            

 
               # File rubygems/specification.rb, line 2157
def name_tuple
  Gem::NameTuple.new name, version, original_platform
end
            

 
               # File rubygems/specification.rb, line 2140
def normalize
  if defined?(@extra_rdoc_files) and @extra_rdoc_files
    @extra_rdoc_files.uniq!
    @files ||= []
    @files.concat(@extra_rdoc_files)
  end

  @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
            

 
               # File rubygems/specification.rb, line 2183
def platform
  @new_platform ||= Gem::Platform::RUBY
end
            

 
               # File rubygems/specification.rb, line 2251
def rdoc_options=(options)
  # TODO: warn about setting instead of pushing
  @rdoc_options = Array options
end
            

 
               # File rubygems/specification.rb, line 2259
def require_path
  val = require_paths and val.first
end
            

 
               # File rubygems/specification.rb, line 2266
def require_path=(path)
  self.require_paths = Array(path)
end
            

 
               # File rubygems/specification.rb, line 2274
def requirements=(req)
  # TODO: warn about setting instead of pushing
  @requirements = Array req
end
            

 
               # File rubygems/specification.rb, line 2658
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

  @installed_by_version ||= nil
end
            

 
               # File rubygems/specification.rb, line 2286
def ri_dir
  @ri_dir ||= File.join base_dir, 'ri', full_name
end
            

 
               # File rubygems/specification.rb, line 2319
def runtime_dependencies
  dependencies.select(&:runtime?)
end
            

 
               # File rubygems/specification.rb, line 1434
def sanitize
  self.summary              = sanitize_string(summary)
  self.description          = sanitize_string(description)
  self.post_install_message = sanitize_string(post_install_message)
  self.authors              = authors.collect { |a| sanitize_string(a) }
end
            

 
               # File rubygems/specification.rb, line 1444
def sanitize_string(string)
  return string unless string

  # HACK the #to_s is in here because RSpec has an Array of Arrays of
  # Strings for authors.  Need a way to disallow bad values on gemspec
  # generation.  (Probably won't happen.)
  string = string.to_s

  begin
    Builder::XChar.encode string
  rescue NameError, NoMethodError
    string.to_xs
  end
end
            

 
               # File rubygems/specification.rb, line 2335
def satisfies_requirement?(dependency)
  return @name == dependency.name &&
    dependency.requirement.satisfied_by?(@version)
end
            

 
               # File rubygems/specification.rb, line 2343
def sort_obj
  [@name, @version, @new_platform == Gem::Platform::RUBY ? -1 : 1]
end
            

 
               # File rubygems/specification.rb, line 2358
def spec_dir
  @spec_dir ||= File.join base_dir, "specifications"
end
            

 
               # File rubygems/specification.rb, line 2366
def spec_file
  @spec_file ||= File.join spec_dir, "#{full_name}.gemspec"
end
            

 
               # File rubygems/specification.rb, line 2375
def spec_name
  "#{full_name}.gemspec"
end
            

 
               # File rubygems/specification.rb, line 2636
def stubbed?
  false
end
            

 
               # File rubygems/specification.rb, line 2382
def summary=(str)
  @summary = str.to_s.strip.
    gsub(/(\w-)\n[ \t]*(\w)/, '\1\2').gsub(/\n[ \t]*/, " ") # so. weird.
end
            

 
               # File rubygems/specification.rb, line 2425
def to_ruby
  require 'openssl'
  mark_version
  result = []
  result << "# -*- encoding: utf-8 -*-"
  result << "#{Gem::StubSpecification::PREFIX}#{name} #{version} #{platform} #{raw_require_paths.join("\0")}"
  result << "#{Gem::StubSpecification::PREFIX}#{extensions.join "\0"}" unless
    extensions.empty?
  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
    result << "  s.platform = #{ruby_code original_platform}"
  end
  result << ""
  result << "  s.required_rubygems_version = #{ruby_code required_rubygems_version} if s.respond_to? :required_rubygems_version="

  if metadata and !metadata.empty?
    result << "  s.metadata = #{ruby_code metadata} if s.respond_to? :metadata="
  end
  result << "  s.require_paths = #{ruby_code raw_require_paths}"

  handled = [
    :dependencies,
    :name,
    :platform,
    :require_paths,
    :required_rubygems_version,
    :specification_version,
    :version,
    :has_rdoc,
    :default_executable,
    :metadata
  ]

  @@attributes.each do |attr_name|
    next if handled.include? attr_name
    current_value = self.send(attr_name)
    if current_value != default_value(attr_name) || self.class.required_attribute?(attr_name)
      result << "  s.#{attr_name} = #{ruby_code current_value}" unless current_value.is_a?(OpenSSL::PKey::RSA)
    end
  end

  if @installed_by_version
    result << nil
    result << "  s.installed_by_version = \"#{Gem::VERSION}\" if s.respond_to? :installed_by_version"
  end

  unless dependencies.empty?
    result << nil
    result << "  if s.respond_to? :specification_version then"
    result << "    s.specification_version = #{specification_version}"
    result << "  end"
    result << nil

    result << "  if s.respond_to? :add_runtime_dependency then"

    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}>.freeze, #{req})"
    end

    result << "  else"
    dependencies.each do |dep|
      version_reqs_param = dep.requirements_list.inspect
      result << "    s.add_dependency(%q<#{dep.name}>.freeze, #{version_reqs_param})"
    end
    result << "  end"
  end

  result << "end"
  result << nil

  result.join "\n"
end
            

 
               # File rubygems/specification.rb, line 2510
def to_ruby_for_cache
  for_cache.to_ruby
end
            

 
               # File rubygems/specification.rb, line 2521
def to_spec
  self
end
            

 
               # File rubygems/specification.rb, line 2552
def traverse(trail = [], visited = {}, &block)
  trail.push(self)
  begin
    dependencies.each do |dep|
      next unless dep.runtime?
      dep.to_specs.each do |dep_spec|
        next if visited.has_key?(dep_spec)
        visited[dep_spec] = true
        trail.push(dep_spec)
        begin
          result = block[self, dep, dep_spec, trail]
        ensure
          trail.pop
        end
        unless result == :next
          spec_name = dep_spec.name
          dep_spec.traverse(trail, visited, &block) unless
            trail.any? { |s| s.name == spec_name }
        end
      end
    end
  ensure
    trail.pop
  end
end
            

 
               # File rubygems/specification.rb, line 2585
def validate(packaging = true, strict = false)
  normalize

  validation_policy = Gem::SpecificationPolicy.new(self)
  validation_policy.packaging = packaging
  validation_policy.validate(strict)
end
            

 
               # File rubygems/specification.rb, line 2609
def validate_dependencies
  Gem::SpecificationPolicy.new(self).validate_dependencies
end
            

 
               # File rubygems/specification.rb, line 2601
def validate_metadata
  Gem::SpecificationPolicy.new(self).validate_metadata
end
            

 
               # File rubygems/specification.rb, line 2615
def validate_permissions
  Gem::SpecificationPolicy.new(self).validate_permissions
end
            

 
               # File rubygems/specification.rb, line 2624
def version=(version)
  @version = Gem::Version.create(version)
  # skip to set required_ruby_version when pre-released rubygems.
  # It caused to raise CircularDependencyError
  if @version.prerelease? && (@name.nil? || @name.strip != "rubygems")
    self.required_rubygems_version = '> 1.3.1'
  end
  invalidate_memoized_attributes

  return @version
end