Class: Gem::Specification

# File 'lib/rubygems/specification.rb', line 948

def self.all= specs
  @@stubs_by_name = specs.group_by(&:name)
  @@all = @@stubs = specs
end

# File 'lib/rubygems/specification.rb', line 981

def self.dirs
  @@dirs ||= Gem.path.collect { |dir|
    File.join dir.dup.untaint, "specifications"
  }
end

# File 'lib/rubygems/specification.rb', line 991

def self.dirs= dirs
  self.reset

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

# File 'lib/rubygems/specification.rb', line 885

def self.add_spec spec
  warn "Gem::Specification.add_spec is deprecated and will be removed in Rubygems 3.0" unless Gem::Deprecate.skip
  # 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
  stubs << spec
  (@@stubs_by_name[spec.name] ||= []) << spec
  sort_by!(@@stubs_by_name[spec.name]) { |s| s.version }
  _resort!(_all)
  _resort!(stubs)
end

# File 'lib/rubygems/specification.rb', line 910

def self.add_specs *specs
  warn "Gem::Specification.add_specs is deprecated and will be removed in Rubygems 3.0" unless Gem::Deprecate.skip

  raise "nil spec!" if specs.any?(&:nil?) # TODO: remove once we're happy

  # TODO: this is much more efficient, but we need the extra checks for now
  # _all.concat specs
  # _resort!

  Gem::Deprecate.skip_during do
    specs.each do |spec| # TODO: slow
      add_spec spec
    end
  end
end

# File 'lib/rubygems/specification.rb', line 956

def self.all_names
  self._all.map(&:full_name)
end

# File 'lib/rubygems/specification.rb', line 965

def self.array_attributes
  @@array_attributes.dup
end

# File 'lib/rubygems/specification.rb', line 974

def self.attribute_names
  @@attributes.dup
end

# File 'lib/rubygems/specification.rb', line 756

def self.default_stubs pattern
  base_dir = Gem.default_dir
  gems_dir = File.join base_dir, "gems"
  gemspec_stubs_in(default_specifications_dir, pattern) do |path|
    Gem::StubSpecification.default_gemspec_stub(path, base_dir, gems_dir)
  end
end

# File 'lib/rubygems/specification.rb', line 1003

def self.each
  return enum_for(:each) unless block_given?

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

# File 'lib/rubygems/specification.rb', line 1056

def self.find_active_stub_by_path path
  stub = @@active_stub_with_requirable_file[path] ||= (stubs.find { |s|
    s.activated? and s.contains_requirable_file? path
  } || NOT_FOUND)
  stub.this
end

# File 'lib/rubygems/specification.rb', line 1014

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 'lib/rubygems/specification.rb', line 1026

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 'lib/rubygems/specification.rb', line 1037

def self.find_by_path path
  path = path.dup.freeze
  spec = @@spec_with_requirable_file[path] ||= (stubs.find { |s|
    s.contains_requirable_file? path
  } || NOT_FOUND)
  spec.to_spec
end

# File 'lib/rubygems/specification.rb', line 1066

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 'lib/rubygems/specification.rb', line 1077

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 'lib/rubygems/specification.rb', line 1049

def self.find_inactive_by_path path
  stub = stubs.find { |s|
    s.contains_requirable_file? path unless s.activated?
  }
  stub && stub.to_spec
end

# File 'lib/rubygems/specification.rb', line 1101

def self.from_yaml(input)
  Gem.load_yaml

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

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

  unless Gem::Specification === spec then
    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 'lib/rubygems/specification.rb', line 751

def self.gemspec_stubs_in dir, pattern
  Dir[File.join(dir, pattern)].map { |path| yield path }.select(&:valid?)
end

# File 'lib/rubygems/specification.rb', line 765

def self.installed_stubs dirs, pattern
  map_stubs(dirs, pattern) do |path, base_dir, gems_dir|
    Gem::StubSpecification.gemspec_stub(path, base_dir, gems_dir)
  end
end

# File 'lib/rubygems/specification.rb', line 1125

def self.latest_specs prerelease = false
  _latest_specs Gem::Specification._all, prerelease
end

# File 'lib/rubygems/specification.rb', line 1152

def self.load file
  return unless file

  _spec = LOAD_CACHE[file]
  return _spec if _spec

  file = file.dup.untaint
  return unless File.file?(file)

  code = if defined? Encoding
           File.read file, :mode => 'r:UTF-8:-'
         else
           File.read file
         end

  code.untaint

  begin
    _spec = eval code, binding, file

    if Gem::Specification === _spec
      _spec.loaded_from = File.expand_path file.to_s
      LOAD_CACHE[file] = _spec
      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 'lib/rubygems/specification.rb', line 873

def self.load_defaults
  each_spec([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 'lib/rubygems/specification.rb', line 1191

def self.non_nil_attributes
  @@non_nil_attributes.dup
end

# File 'lib/rubygems/specification.rb', line 1198

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 'lib/rubygems/specification.rb', line 1216

def self.outdated
  outdated_and_latest_version.map { |local, _| local.name }
end

# File 'lib/rubygems/specification.rb', line 1227

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 'lib/rubygems/specification.rb', line 1252

def self.remove_spec spec
  warn "Gem::Specification.remove_spec is deprecated and will be removed in Rubygems 3.0" unless Gem::Deprecate.skip
  _all.delete spec
  stubs.delete_if { |s| s.full_name == spec.full_name }
  (@@stubs_by_name[spec.name] || []).delete_if { |s| s.full_name == spec.full_name }
  reset
end

# File 'lib/rubygems/specification.rb', line 1263

def self.required_attribute?(name)
  @@required_attributes.include? name.to_sym
end

# File 'lib/rubygems/specification.rb', line 1270

def self.required_attributes
  @@required_attributes.dup
end

# File 'lib/rubygems/specification.rb', line 1278

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? 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
  Gem.post_reset_hooks.each { |hook| hook.call }
end

# File 'lib/rubygems/specification.rb', line 815

def self.sort_by! list, &block
  list.sort_by!(&block)
end

# File 'lib/rubygems/specification.rb', line 831

def self.stubs
  @@stubs ||= begin
    pattern = "*.gemspec"
    stubs = default_stubs(pattern).concat installed_stubs(dirs, pattern)
    stubs = uniq_by(stubs) { |stub| stub.full_name }

    _resort!(stubs)
    @@stubs_by_name = stubs.group_by(&:name)
    stubs
  end
end

# File 'lib/rubygems/specification.rb', line 848

def self.stubs_for name
  if @@stubs
    @@stubs_by_name[name] || []
  else
    pattern = "#{name}-*.gemspec"
    stubs = default_stubs(pattern) + installed_stubs(dirs, 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 'lib/rubygems/specification.rb', line 1302

def self.unresolved_deps
  @unresolved_deps ||= Hash.new { |h, n| h[n] = Gem::Dependency.new n }
end

# File 'lib/rubygems/specification.rb', line 1565

def author
  val = authors and val.first
end

# File 'lib/rubygems/specification.rb', line 258

def author= o
  self.authors = [o]
end

# File 'lib/rubygems/specification.rb', line 1574

def authors
  @authors ||= []
end

# File 'lib/rubygems/specification.rb', line 269

def authors= value
  @authors = Array(value).flatten.grep(String)
end

# File 'lib/rubygems/specification.rb', line 373

attr_accessor :bindir

# File 'lib/rubygems/specification.rb', line 1661

def bundled_gem_in_old_ruby?
  !default_gem? &&
    RUBY_VERSION < "2.0.0" &&
    summary == "This #{name} is bundled with Ruby"
end

# File 'lib/rubygems/specification.rb', line 379

attr_accessor :cert_chain

# File 'lib/rubygems/specification.rb', line 1728

def date
  @date ||= TODAY
end

# File 'lib/rubygems/specification.rb', line 1748

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 then
              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 then
              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 'lib/rubygems/specification.rb', line 704

attr_writer :default_executable

# File 'lib/rubygems/specification.rb', line 395

attr_reader :description

# File 'lib/rubygems/specification.rb', line 1839

def description= str
  @description = str.to_s
end

# File 'lib/rubygems/specification.rb', line 407

attr_accessor :email

# File 'lib/rubygems/specification.rb', line 1896

def executable
  val = executables and val.first
end

# File 'lib/rubygems/specification.rb', line 1903

def executable=o
  self.executables = [o]
end

# File 'lib/rubygems/specification.rb', line 506

def executables
  @executables ||= []
end

# File 'lib/rubygems/specification.rb', line 1911

def executables= value
  # TODO: warn about setting instead of pushing
  @executables = Array(value)
end

# File 'lib/rubygems/specification.rb', line 523

def extensions
  @extensions ||= []
end

# File 'lib/rubygems/specification.rb', line 1920

def extensions= extensions
  # TODO: warn about setting instead of pushing
  @extensions = Array extensions
end

# File 'lib/rubygems/specification.rb', line 539

def extra_rdoc_files
  @extra_rdoc_files ||= []
end

# File 'lib/rubygems/specification.rb', line 1929

def extra_rdoc_files= files
  # TODO: warn about setting instead of pushing
  @extra_rdoc_files = Array files
end

# File 'lib/rubygems/specification.rb', line 352

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 'lib/rubygems/specification.rb', line 1946

def files= files
  @files = Array files
end

# File 'lib/rubygems/specification.rb', line 1711

def has_conflicts?
  return true unless Gem.env_requirement(name).satisfied_by?(version)
  self.dependencies.any? { |dep|
    if dep.runtime? then
      spec = Gem.loaded_specs[dep.name]
      spec and not spec.satisfies_requirement? dep
    else
      false
    end
  }
end

# File 'lib/rubygems/specification.rb', line 418

attr_accessor :homepage

# File 'lib/rubygems/specification.rb', line 2129

def license
  licenses.first
end

# File 'lib/rubygems/specification.rb', line 588

def license=o
  self.licenses = [o]
end

# File 'lib/rubygems/specification.rb', line 2138

def licenses
  @licenses ||= []
end

# File 'lib/rubygems/specification.rb', line 606

def licenses= licenses
  @licenses = Array licenses
end

# File 'lib/rubygems/specification.rb', line 463

attr_accessor :metadata

# File 'lib/rubygems/specification.rb', line 2176

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 'lib/rubygems/specification.rb', line 197

attr_accessor :name

# File 'lib/rubygems/specification.rb', line 2234

def platform
  @new_platform ||= Gem::Platform::RUBY
end

# File 'lib/rubygems/specification.rb', line 296

def platform= platform
  if @original_platform.nil? or
     @original_platform == Gem::Platform::RUBY then
    @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 'lib/rubygems/specification.rb', line 427

attr_accessor :post_install_message

# File 'lib/rubygems/specification.rb', line 619

def rdoc_options
  @rdoc_options ||= []
end

# File 'lib/rubygems/specification.rb', line 2302

def rdoc_options= options
  # TODO: warn about setting instead of pushing
  @rdoc_options = Array options
end

# File 'lib/rubygems/specification.rb', line 2310

def require_path
  val = require_paths and val.first
end

# File 'lib/rubygems/specification.rb', line 2317

def require_path= path
  self.require_paths = Array(path)
end

# File 'lib/rubygems/specification.rb', line 229

def require_paths=(val)
  @require_paths = Array(val)
end

# File 'lib/rubygems/specification.rb', line 432

attr_reader :required_ruby_version

# File 'lib/rubygems/specification.rb', line 646

def required_ruby_version= req
  @required_ruby_version = Gem::Requirement.create req
end

# File 'lib/rubygems/specification.rb', line 437

attr_reader :required_rubygems_version

# File 'lib/rubygems/specification.rb', line 653

def required_rubygems_version= req
  @required_rubygems_version = Gem::Requirement.create req
end

# File 'lib/rubygems/specification.rb', line 666

def requirements
  @requirements ||= []
end

# File 'lib/rubygems/specification.rb', line 2325

def requirements= req
  # TODO: warn about setting instead of pushing
  @requirements = Array req
end

# File 'lib/rubygems/specification.rb', line 717

attr_accessor :rubyforge_project

# File 'lib/rubygems/specification.rb', line 238

attr_accessor :rubygems_version

# File 'lib/rubygems/specification.rb', line 442

attr_accessor :signing_key

# File 'lib/rubygems/specification.rb', line 724

attr_accessor :specification_version

# File 'lib/rubygems/specification.rb', line 2975

def stubbed?
  false
end

# File 'lib/rubygems/specification.rb', line 249

attr_reader :summary

# File 'lib/rubygems/specification.rb', line 2433

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

# File 'lib/rubygems/specification.rb', line 210

attr_reader :version

# File 'lib/rubygems/specification.rb', line 2967

def version= version
  @version = Gem::Version.create(version)
  self.required_rubygems_version = '> 1.3.1' if @version.prerelease?
  invalidate_memoized_attributes

  return @version
end

# File 'lib/rubygems/specification.rb', line 1464

def abbreviate
  self.files = []
  self.test_files = []
  self.rdoc_options = []
  self.extra_rdoc_files = []
  self.cert_chain = []
end

# File 'lib/rubygems/specification.rb', line 1407

def activate
  other = Gem.loaded_specs[self.name]
  if other then
    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 'lib/rubygems/specification.rb', line 1431

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 then
      specs.first.activate
    else
      name = spec_dep.name
      unresolved[name] = unresolved[name].merge spec_dep
    end
  end

  unresolved.delete self.name
end

# File 'lib/rubygems/specification.rb', line 688

attr_accessor :activated

# File 'lib/rubygems/specification.rb', line 1506

def add_bindir(executables)
  return nil if executables.nil?

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

# File 'lib/rubygems/specification.rb', line 1540

alias add_dependency add_runtime_dependency

# File 'lib/rubygems/specification.rb', line 1523

def add_dependency_with_type(dependency, type, *requirements)
  requirements = if requirements.empty? then
                   Gem::Requirement.default
                 else
                   requirements.flatten
                 end

  unless dependency.respond_to?(:name) &&
         dependency.respond_to?(:requirement)
    dependency = Gem::Dependency.new(dependency.to_s, requirements, type)
  end

  dependencies << dependency
end

# File 'lib/rubygems/specification.rb', line 476

def add_development_dependency(gem, *requirements)
  add_dependency_with_type(gem, :development, *requirements)
end

# File 'lib/rubygems/specification.rb', line 487

def add_runtime_dependency(gem, *requirements)
  add_dependency_with_type(gem, :runtime, *requirements)
end

# File 'lib/rubygems/specification.rb', line 1545

def add_self_to_load_path
  return if default_gem?

  paths = full_require_paths

  # gem directories must come after -I and ENV['RUBYLIB']
  insert_index = Gem.load_path_insert_index

  if insert_index then
    # gem directories must come after -I and ENV['RUBYLIB']
    $LOAD_PATH.insert(insert_index, *paths)
  else
    # we are probably testing in core, -I and RUBYLIB don't apply
    $LOAD_PATH.unshift(*paths)
  end
end

# File 'lib/rubygems/specification.rb', line 2087

def base_dir
  return Gem.dir unless loaded_from
  @base_dir ||= if default_gem? then
                  File.dirname File.dirname File.dirname loaded_from
                else
                  File.dirname File.dirname loaded_from
                end
end

# File 'lib/rubygems/specification.rb', line 1584

def bin_dir
  @bin_dir ||= File.join gem_dir, bindir # TODO: this is unfortunate
end

# File 'lib/rubygems/specification.rb', line 1591

def bin_file name
  File.join bin_dir, name
end

# File 'lib/rubygems/specification.rb', line 1598

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 'lib/rubygems/specification.rb', line 1645

def build_info_dir
  File.join base_dir, "build_info"
end

# File 'lib/rubygems/specification.rb', line 1653

def build_info_file
  File.join build_info_dir, "#{full_name}.info"
end

# File 'lib/rubygems/specification.rb', line 1671

def cache_dir
  @cache_dir ||= File.join base_dir, "cache"
end

# File 'lib/rubygems/specification.rb', line 1678

def cache_file
  @cache_file ||= File.join cache_dir, "#{full_name}.gem"
end

# File 'lib/rubygems/specification.rb', line 1685

def conflicts
  conflicts = {}
  self.runtime_dependencies.each { |dep|
    spec = Gem.loaded_specs[dep.name]
    if spec and not spec.satisfies_requirement? dep
      (conflicts[spec] ||= []) << dep
    end
  }
  env_req = Gem.env_requirement(name)
  (conflicts[self] ||= []) << env_req unless env_req.satisfied_by? version
  conflicts
end

# File 'lib/rubygems/specification.rb', line 1793

def default_value name
  @@default_value[name]
end

# File 'lib/rubygems/specification.rb', line 1803

def dependencies
  @dependencies ||= []
end

# File 'lib/rubygems/specification.rb', line 1813

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

# File 'lib/rubygems/specification.rb', line 1832

def dependent_specs
  runtime_dependencies.map { |dep| dep.to_specs }.flatten
end

# File 'lib/rubygems/specification.rb', line 1846

def development_dependencies
  dependencies.select { |d| d.type == :development }
end

# File 'lib/rubygems/specification.rb', line 1858

def doc_dir type = nil
  @doc_dir ||= File.join base_dir, 'doc', full_name

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

# File 'lib/rubygems/specification.rb', line 1939

def file_name
  "#{full_name}.gem"
end

# File 'lib/rubygems/specification.rb', line 1953

def find_all_satisfiers dep
  Gem::Specification.each do |spec|
    yield spec if spec.satisfies_requirement? dep
  end
end

# File 'lib/rubygems/specification.rb', line 1964

def for_cache
  spec = dup

  spec.files = nil
  spec.test_files = nil

  spec
end

# File 'lib/rubygems/specification.rb', line 1973

def full_name
  @full_name ||= super
end

# File 'lib/rubygems/specification.rb', line 1984

def gems_dir
  # TODO: this logic seems terribly broken, but tests fail if just base_dir
  @gems_dir ||= File.join(loaded_from && base_dir || Gem.dir, "gems")
end

# File 'lib/rubygems/specification.rb', line 2065

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 then
        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 'lib/rubygems/specification.rb', line 2100

def invalidate_memoized_attributes
  @full_name = nil
  @cache_file = nil
end

# File 'lib/rubygems/specification.rb', line 2118

def lib_files
  @files.select do |file|
    require_paths.any? do |path|
      file.start_with? path
    end
  end
end

# File 'lib/rubygems/specification.rb', line 2156

def mark_version
  @rubygems_version = Gem::VERSION
end

# File 'lib/rubygems/specification.rb', line 2208

def name_tuple
  Gem::NameTuple.new name, version, original_platform
end

# File 'lib/rubygems/specification.rb', line 2191

def normalize
  if defined?(@extra_rdoc_files) and @extra_rdoc_files then
    @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 'lib/rubygems/specification.rb', line 2997

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 'lib/rubygems/specification.rb', line 2337

def ri_dir
  @ri_dir ||= File.join base_dir, 'ri', full_name
end

# File 'lib/rubygems/specification.rb', line 2345

def ruby_code(obj)
  case obj
  when String            then obj.dump + ".freeze"
  when Array             then '[' + obj.map { |x| ruby_code x }.join(", ") + ']'
  when Hash              then
    seg = obj.keys.sort.map { |k| "#{k.to_s.dump} => #{obj[k].to_s.dump}" }
    "{ #{seg.join(', ')} }"
  when Gem::Version      then obj.to_s.dump
  when DateLike          then obj.strftime('%Y-%m-%d').dump
  when Time              then obj.strftime('%Y-%m-%d').dump
  when Numeric           then obj.inspect
  when true, false, nil  then obj.inspect
  when Gem::Platform     then "Gem::Platform.new(#{obj.to_a.inspect})"
  when Gem::Requirement  then
    list = obj.as_list
    "Gem::Requirement.new(#{ruby_code(list.size == 1 ? obj.to_s : list)})"
  else raise Gem::Exception, "ruby_code case not handled: #{obj.class}"
  end
end

# File 'lib/rubygems/specification.rb', line 2370

def runtime_dependencies
  dependencies.select(&:runtime?)
end