class Gem::Specification

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

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

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

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

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

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

# File lib/rubygems/specification.rb, line 605
def required_ruby_version= req
  @required_ruby_version = Gem::Requirement.create req
end

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

# File lib/rubygems/specification.rb, line 630
def test_files= files
  @test_files = Array files
end

# File lib/rubygems/specification.rb, line 554
def license=o
  self.licenses = [o]
end

# File lib/rubygems/specification.rb, line 572
def licenses= licenses
  @licenses = Array licenses
end

# File lib/rubygems/specification.rb, line 249
def author= o
  self.authors = [o]
end

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

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

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

  # 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]
  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]
  spec.instance_variable_set :@metadata,                  array[18]
  spec.instance_variable_set :@loaded,                    false
  spec.instance_variable_set :@activated,                 false

  spec
end

# File lib/rubygems/specification.rb, line 768
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
  stubs << spec
  _resort!(_all)
  _resort!(stubs)
end

# File lib/rubygems/specification.rb, line 790
def self.add_specs *specs
  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!

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

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

# File lib/rubygems/specification.rb, line 824
def self.all= specs
  @@all = @@stubs = specs
end

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

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

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

# File lib/rubygems/specification.rb, line 856
def self.dirs
  @@dirs ||= Gem.path.collect { |dir|
    File.join dir.dup.untaint, "specifications"
  }
end

# File lib/rubygems/specification.rb, line 866
def self.dirs= dirs
  self.reset

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

# File lib/rubygems/specification.rb, line 878
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 889
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 901
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 912
def self.find_by_path path
  self.find { |spec|
    spec.contains_requirable_file? path
  }
end

# File lib/rubygems/specification.rb, line 932
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 943
def self.find_in_unresolved_tree path
  specs = unresolved_deps.values.map { |dep| dep.to_specs }.flatten

  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

# File lib/rubygems/specification.rb, line 922
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 969
def self.from_yaml(input)
  Gem.load_yaml

  input = normalize_yaml_input input
  spec = YAML.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 993
def self.latest_specs prerelease = false
  result = Hash.new { |h,k| h[k] = {} }
  native = {}

  Gem::Specification.reverse_each do |spec|
    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
  }.sort_by{ |tup| tup.name }
end

# File lib/rubygems/specification.rb, line 1013
def self.load file
  return unless file
  file = file.dup.untaint
  return unless File.file?(file)

  spec = LOAD_CACHE[file]
  return spec if spec

  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 756
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 1801
def initialize name = nil, version = nil
  @loaded = false
  @activated = false
  self.loaded_from = nil
  @original_platform = nil
  @installed_by_version = nil

  @@nil_attributes.each do |key|
    instance_variable_set "@#{key}", nil
  end

  @@non_nil_attributes.each do |key|
    default = default_value(key)
    value = Dupable[key] ? default.dup : default
    instance_variable_set "@#{key}", value
  end

  @new_platform = Gem::Platform::RUBY

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

  yield self if block_given?
end

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

# File lib/rubygems/specification.rb, line 1058
def self.normalize_yaml_input(input)
  result = input.respond_to?(:read) ? input.read : input
  result = "--- " + result unless result =~ /\A--- /
  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 1075
def self.outdated
  outdated_and_latest_version.map { |local, _| local.name }
end

# File lib/rubygems/specification.rb, line 1086
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 1111
def self.remove_spec spec
  _all.delete spec
  stubs.delete_if { |s| s.full_name == spec.full_name }
end

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

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

# File lib/rubygems/specification.rb, line 1134
def self.reset
  @@dirs = nil
  Gem.pre_reset_hooks.each { |hook| hook.call }
  @@all = nil
  @@stubs = nil
  _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 732
def self.stubs
  @@stubs ||= begin
    stubs = {}
    each_stub([default_specifications_dir] + dirs) do |stub|
      stubs[stub.full_name] ||= stub
    end

    stubs = stubs.values
    _resort!(stubs)
    stubs
  end
end

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

# File lib/rubygems/specification.rb, line 1230
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 lib/rubygems/specification.rb, line 1260
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
  @activated = true
  @loaded = true

  return true
end

# File lib/rubygems/specification.rb, line 1280
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 1311
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 1350
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 1370
def author
  val = authors and val.first
end

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

# File lib/rubygems/specification.rb, line 1389
def bin_dir
  @bin_dir ||= File.join gem_dir, bindir # TODO: this is unfortunate
end

# File lib/rubygems/specification.rb, line 1396
def bin_file name
  File.join bin_dir, name
end

# File lib/rubygems/specification.rb, line 1403
def build_args
  if File.exist? build_info_file
    File.readlines(build_info_file).map { |x| x.strip }
  else
    []
  end
end

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

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

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

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

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

# File lib/rubygems/specification.rb, line 1492
def date
  @date ||= TODAY
end

# File lib/rubygems/specification.rb, line 1507
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, Date then
            Time.utc(date.year, date.month, date.day)
          else
            TODAY
          end
end

# File lib/rubygems/specification.rb, line 1552
def default_value name
  @@default_value[name]
end

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

# File lib/rubygems/specification.rb, line 1572
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 1591
def dependent_specs
  runtime_dependencies.map { |dep| dep.to_specs }.flatten
end

# File lib/rubygems/specification.rb, line 1598
def description= str
  @description = str.to_s
end

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

# File lib/rubygems/specification.rb, line 1617
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 1655
def executable
  val = executables and val.first
end

# File lib/rubygems/specification.rb, line 1662
def executable=o
  self.executables = [o]
end

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

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

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

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

# File lib/rubygems/specification.rb, line 1705
def files= files
  @files = Array files
end

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

  spec.files = nil
  spec.test_files = nil

  spec
end

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

# File lib/rubygems/specification.rb, line 1779
def has_unit_tests?
  not test_files.empty?
end

# File lib/rubygems/specification.rb, line 1829
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 1874
def lib_dirs_glob
  dirs = if self.require_paths.size > 1 then
           "{#{self.require_paths.join(',')}}"
         else
           self.require_paths.first
         end

  "#{self.full_gem_path}/#{dirs}"
end

# File lib/rubygems/specification.rb, line 1887
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 1898
def license
  val = licenses and val.first
end

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

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

# File lib/rubygems/specification.rb, line 1933
def matches_for_glob glob # TODO: rename?
  # TODO: do we need these?? Kill it
  glob = File.join(self.lib_dirs_glob, glob)

  Dir[glob].map { |f| f.untaint } # FIX our tests are broken, run w/ SAFE=1
end

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

# File lib/rubygems/specification.rb, line 1958
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 2001
def platform
  @new_platform ||= Gem::Platform::RUBY
end

# File lib/rubygems/specification.rb, line 2038
def raise_if_conflicts
  other = Gem.loaded_specs[self.name]

  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.

    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

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

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

# File lib/rubygems/specification.rb, line 2086
def require_path= path
  self.require_paths = [path]
end

# File lib/rubygems/specification.rb, line 2093
def required_rubygems_version= req
  @required_rubygems_version = Gem::Requirement.create req
end

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

# File lib/rubygems/specification.rb, line 2718
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 2113
def ri_dir
  @ri_dir ||= File.join base_dir, 'ri', full_name
end

# File lib/rubygems/specification.rb, line 2146
def runtime_dependencies
  dependencies.select { |d| d.type == :runtime }
end

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

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

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

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

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

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

# File lib/rubygems/specification.rb, line 2209
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 2217
def test_file
  val = test_files and val.first
end

# File lib/rubygems/specification.rb, line 2224
def test_file= file
  self.test_files = [file]
end

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

# File lib/rubygems/specification.rb, line 2252
def to_ruby
  mark_version
  result = []
  result << "# -*- encoding: utf-8 -*-"
  result << "#{Gem::StubSpecification::PREFIX}#{name} #{version} #{platform} #{@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 then
    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 @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) or
       self.class.required_attribute? attr_name then
      result << "  s.#{attr_name} = #{ruby_code current_value}"
    end
  end

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

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

    result << "    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') 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}>, #{req})"
    end

    result << "    else"

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

    result << '    end'

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

  result << "end"
  result << nil

  result.join "\n"
end

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

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

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

# File lib/rubygems/specification.rb, line 2410
  def validate packaging = true
    @warnings = 0
    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}"
      end
    end

    unless String === name then
      raise Gem::InvalidSpecificationException,
            "invalid value for attribute name: \"#{name.inspect}\""
    end

    if @require_paths.empty? then
      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

    if files.include? file_name then
      raise Gem::InvalidSpecificationException,
            "#{full_name} contains itself (#{file_name}), check your files list"
    end

    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
    else
      raise Gem::InvalidSpecificationException,
            "invalid platform #{platform.inspect}, see Gem::Platform"
    end

    self.class.array_attributes.each do |field|
      val = self.send field
      klass = case field
              when :dependencies
                Gem::Dependency
              else
                String
              end

      unless Array === val and val.all? { |x| x.kind_of?(klass) } then
        raise(Gem::InvalidSpecificationException,
              "#{field} must be an Array of #{klass}")
      end
    end

    [:authors].each do |field|
      val = self.send field
      raise Gem::InvalidSpecificationException, "#{field} may not be empty" if
        val.empty?
    end

    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

    licenses.each { |license|
      if license.length > 64
        raise Gem::InvalidSpecificationException,
          "each license must be 64 characters or less"
      end
    }

    warning "licenses is empty, but is recommended.  Use a license abbreviation from:
http://opensource.org/licenses/alphabetical
" if licenses.empty?

    validate_permissions

    # 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"
    end

    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
      warning "no #{attribute} specified" if value.nil? or value.empty?
    end

    if description == summary then
      warning 'description and summary are identical'
    end

    # TODO: raise at some given date
    warning "deprecated autorequire specified" if autorequire

    executables.each do |executable|
      executable_path = File.join(bindir, executable)
      shebang = File.read(executable_path, 2) == '#!'

      warning "#{executable_path} is missing #! line" unless shebang
    end

    validate_dependencies

    true
  ensure
    if $! or @warnings > 0 then
      alert_warning "See http://guides.rubygems.org/specification-reference/ for help"
    end
  end

# File lib/rubygems/specification.rb, line 2668
def validate_permissions
  return if Gem.win_platform?

  files.each do |file|
    next if File.stat(file).mode & 0444 == 0444
    warning "#{file} is not world-readable"
  end

  executables.each do |name|
    exec = File.join @bindir, name
    next if File.stat(exec).executable?
    warning "#{exec} is not executable"
  end
end

# File lib/rubygems/specification.rb, line 2688
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 1328
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?(:version_requirements)
    dependency = Gem::Dependency.new(dependency.to_s, requirements, type)
  end

  dependencies << dependency
end

# File lib/rubygems/specification.rb, line 1712
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 1855
def invalidate_memoized_attributes
  @full_name = nil
  @cache_file = nil
end

# File lib/rubygems/specification.rb, line 2121
def ruby_code(obj)
  case obj
  when String            then obj.dump
  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 Date              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 2153
def same_attributes? spec
  @@attributes.all? { |name, default| self.send(name) == spec.send(name) }
end