Class: Gem::Specification

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

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

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

def self.dirs
  @@dirs ||= Gem.path.collect do |dir|
    File.join dir.dup.tap(&Gem::UNTAINT), "specifications"
  end
end

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

def self.dirs=(dirs)
  self.reset

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

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

def self._latest_specs(specs, prerelease = false) # :nodoc:
  result = {}

  specs.reverse_each do |spec|
    next if spec.version.prerelease? unless prerelease

    result[spec.name] = spec
  end

  result.map(&:last).flatten.sort_by {|tup| tup.name }
end

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

def self._load(str)
  Gem.load_yaml

  yaml_set = false

  array = begin
    Marshal.load str
  rescue ArgumentError => e
    #
    # Some very old marshaled specs included references to `YAML::PrivateType`
    # and `YAML::Syck::DefaultKey` constants due to bugs in the old emitter
    # that generated them. Workaround the issue by defining the necessary
    # constants and retrying.
    #
    message = e.message
    raise unless message.include?("YAML::")

    unless Object.const_defined?(:YAML)
      Object.const_set "YAML", Psych
      yaml_set = true
    end

    if message.include?("YAML::Syck::")
      YAML.const_set "Syck", YAML unless YAML.const_defined?(:Syck)

      YAML::Syck.const_set "DefaultKey", Class.new if message.include?("YAML::Syck::DefaultKey")
    elsif message.include?("YAML::PrivateType")
      YAML.const_set "PrivateType", Class.new
    end

    retry
  ensure
    Object.__send__(:remove_const, "YAML") if yaml_set
  end

  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

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

def self._resort!(specs) # :nodoc:
  specs.sort! do |a, b|
    names = a.name <=> b.name
    next names if names.nonzero?
    versions = b.version <=> a.version
    next versions if versions.nonzero?
    Gem::Platform.sort_priority(b.platform)
  end
end

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

def self.add_spec(spec)
  return if _all.include? spec

  _all << spec
  stubs << spec
  (@@stubs_by_name[spec.name] ||= []) << spec

  _resort!(@@stubs_by_name[spec.name])
  _resort!(stubs)
end

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

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

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

def self.array_attributes
  @@array_attributes.dup
end

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

def self.attribute_names
  @@attributes.dup
end

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

def self.clear_load_cache # :nodoc:
  @load_cache_mutex.synchronize do
    @load_cache.clear
  end
end

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

def self.clear_specs # :nodoc:
  @@all = nil
  @@stubs = nil
  @@stubs_by_name = {}
  @@spec_with_requirable_file = {}
  @@active_stub_with_requirable_file = {}
end

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

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

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 778

def self.each_gemspec(dirs) # :nodoc:
  dirs.each do |dir|
    Gem::Util.glob_files_in_dir("*.gemspec", dir).each do |path|
      yield path.tap(&Gem::UNTAINT)
    end
  end
end

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

def self.each_spec(dirs) # :nodoc:
  each_gemspec(dirs) do |path|
    spec = self.load path
    yield spec if spec
  end
end

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

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

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

def self.find_all_by_full_name(full_name)
  stubs.select {|s| s.full_name == full_name }.map(&:to_spec)
end

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

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 1027

def self.find_by_full_name(full_name)
  stubs.find {|s| s.full_name == full_name }&.to_spec
end

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

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 1034

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

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

def self.find_in_unresolved(path)
  unresolved_specs.find_all {|spec| spec.contains_requirable_file? path }
end

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

def self.find_in_unresolved_tree(path)
  unresolved_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 1046

def self.find_inactive_by_path(path)
  stub = stubs.find do |s|
    next if s.activated?
    s.contains_requirable_file? path
  end
  stub&.to_spec
end

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

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.flatten_require_paths

  spec
end

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

def self.gemspec_stubs_in(dir, pattern)
  Gem::Util.glob_files_in_dir(pattern, dir).map {|path| yield path }.select(&:valid?)
end

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

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 1131

def self.latest_spec_for(name)
  latest_specs(true).find {|installed_spec| installed_spec.name == name }
end

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

def self.latest_specs(prerelease = false)
  _latest_specs Gem::Specification.stubs, prerelease
end

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

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 = Gem.open_file(file, "r:UTF-8:-", &:read)

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

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

def self.map_stubs(dirs, pattern) # :nodoc:
  dirs.flat_map do |dir|
    base_dir = File.dirname dir
    gems_dir = File.join base_dir, "gems"
    gemspec_stubs_in(dir, pattern) {|path| yield path, base_dir, gems_dir }
  end
end

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

def self.non_nil_attributes
  @@non_nil_attributes.dup
end

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

def self.normalize_yaml_input(input)
  result = input.respond_to?(:read) ? input.read : input
  result = "--- " + result unless result.start_with?("--- ")
  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 1217

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

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

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 && local_spec.version < latest_remote
  end

  nil
end

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

def self.remove_spec(spec)
  _all.delete spec.to_spec
  stubs.delete spec
  (@@stubs_by_name[spec.name] || []).delete spec
end

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

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

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

def self.required_attributes
  @@required_attributes.dup
end

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

def self.reset
  @@dirs = nil
  Gem.pre_reset_hooks.each {|hook| hook.call }
  clear_specs
  clear_load_cache
  unresolved = unresolved_deps
  unless unresolved.empty?
    warn "WARN: 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 "WARN: 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 'lib/rubygems/specification.rb', line 817

def self.stubs
  @@stubs ||= begin
    pattern = "*.gemspec"
    stubs = stubs_for_pattern(pattern, false)

    @@stubs_by_name = stubs.select {|s| Gem::Platform.match_spec? s }.group_by(&:name)
    stubs
  end
end

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

def self.stubs_for(name)
  if @@stubs
    @@stubs_by_name[name] || []
  else
    @@stubs_by_name[name] ||= stubs_for_pattern("#{name}-*.gemspec").select do |s|
      s.name == name
    end
  end
end

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

def self.stubs_for_pattern(pattern, match_platform = true) # :nodoc:
  installed_stubs = installed_stubs(Gem::Specification.dirs, pattern)
  installed_stubs.select! {|s| Gem::Platform.match_spec? s } if match_platform
  stubs = installed_stubs + default_stubs(pattern)
  stubs = stubs.uniq {|stub| stub.full_name }
  _resort!(stubs)
  stubs
end

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

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

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

def self.unresolved_specs
  unresolved_deps.values.map {|dep| dep.to_specs }.flatten
end

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

def author
  (val = authors) && val.first
end

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

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

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

def authors
  @authors ||= []
end

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

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

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

attr_accessor :autorequire # :nodoc:

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

attr_accessor :bindir

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

attr_accessor :cert_chain

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

def date
  @date ||= Time.utc(*Gem.source_date_epoch.utc.to_a[3..5].reverse)
end

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

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)
    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 1774

def default_executable # :nodoc:
  if defined?(@default_executable) && @default_executable
    result = @default_executable
  elsif @executables && @executables.size == 1
    result = Array(@executables).first
  else
    result = nil
  end
  result
end

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

attr_writer :default_executable

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

attr_reader :description

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

def description=(str)
  @description = str.to_s
end

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

attr_accessor :email

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

def executable
  (val = executables) && val.first
end

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

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

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

def executables
  @executables ||= []
end

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

def executables=(value)
  @executables = Array(value)
end

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

def extensions
  @extensions ||= []
end

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

def extensions=(extensions)
  @extensions = Array extensions
end

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

def extra_rdoc_files
  @extra_rdoc_files ||= []
end

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

def extra_rdoc_files=(files)
  @extra_rdoc_files = Array files
end

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

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 1937

def files=(files)
  @files = Array files
end

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

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 && !spec.satisfies_requirement?(dep)
    else
      false
    end
  end
end

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

def has_rdoc=(ignored) # :nodoc:
  @has_rdoc = true
end

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

alias :has_rdoc? :has_rdoc # :nodoc:

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

alias has_test_suite? has_unit_tests?

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

def has_unit_tests? # :nodoc:
  !test_files.empty?
end

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

attr_accessor :homepage

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

def installed_by_version # :nodoc:
  @installed_by_version ||= Gem::Version.new(0)
end

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

def installed_by_version=(version) # :nodoc:
  @installed_by_version = Gem::Version.new version
end

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

def license
  licenses.first
end

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

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

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

def licenses
  @licenses ||= []
end

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

def licenses=(licenses)
  @licenses = Array licenses
end

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

attr_accessor :metadata

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

def missing_extensions?
  return false if extensions.empty?
  return false if default_gem?
  return false if File.exist? gem_build_complete_path

  true
end

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

attr_accessor :name

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

def original_platform # :nodoc:
  @original_platform ||= platform
end

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

attr_writer :original_platform # :nodoc:

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

def platform
  @new_platform ||= Gem::Platform::RUBY # rubocop:disable Naming/MemoizedInstanceVariableName
end

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

def platform=(platform)
  if @original_platform.nil? ||
     @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 'lib/rubygems/specification.rb', line 451

attr_accessor :post_install_message

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

def rdoc_options
  @rdoc_options ||= []
end

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

def rdoc_options=(options)
  @rdoc_options = Array options
end

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

def require_path
  (val = require_paths) && val.first
end

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

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

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

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

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

attr_reader :required_ruby_version

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

def required_ruby_version=(req)
  @required_ruby_version = Gem::Requirement.create req

  @required_ruby_version.requirements.map! do |op, v|
    if v >= LATEST_RUBY_WITHOUT_PATCH_VERSIONS && v.release.segments.size == 4
      [op == "~>" ? "=" : op, Gem::Version.new(v.segments.tap {|s| s.delete_at(3) }.join("."))]
    else
      [op, v]
    end
  end
end

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

attr_reader :required_rubygems_version

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

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

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

def requirements
  @requirements ||= []
end

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

def requirements=(req)
  @requirements = Array req
end

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

attr_accessor :rubygems_version

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

attr_accessor :signing_key

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

attr_accessor :specification_version

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

def stubbed?
  false
end

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

attr_reader :summary

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

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 2446

def test_file # :nodoc:
  (val = test_files) && val.first
end

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

def test_file=(file) # :nodoc:
  self.test_files = [file]
end

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

def test_files # :nodoc:
  # 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
    @test_files = [@test_suite_file].flatten
    @test_suite_file = nil
  end
  if defined?(@test_files) && @test_files
    @test_files
  else
    @test_files = []
  end
end

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

def test_files=(files) # :nodoc:
  @test_files = Array files
end

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

attr_reader :version

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

def version=(version)
  @version = Gem::Version.create(version)
  return if @version.nil?

  # 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

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

def ==(other) # :nodoc:
  self.class === other &&
    name == other.name &&
    version == other.version &&
    platform == other.platform
end

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

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