class Gem::Specification

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

# File lib/rubygems/specification.rb, line 136
                  {
  authors: [],
  autorequire: nil,
  bindir: "bin",
  cert_chain: [],
  date: nil,
  dependencies: [],
  description: nil,
  email: nil,
  executables: [],
  extensions: [],
  extra_rdoc_files: [],
  files: [],
  homepage: nil,
  licenses: [],
  metadata: {},
  name: nil,
  platform: Gem::Platform::RUBY,
  post_install_message: nil,
  rdoc_options: [],
  require_paths: ["lib"],
  required_ruby_version: Gem::Requirement.default,
  required_rubygems_version: Gem::Requirement.default,
  requirements: [],
  rubygems_version: Gem::VERSION,
  signing_key: nil,
  specification_version: CURRENT_SPECIFICATION_VERSION,
  summary: nil,
  test_files: [],
  version: nil,
}.freeze

# File lib/rubygems/specification.rb, line 552
def add_dependency(gem, *requirements)
  if requirements.uniq.size != requirements.size
    warn "WARNING: duplicated #{gem} dependency #{requirements}"
  end

  add_dependency_with_type(gem, :runtime, requirements)
end

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

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

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

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

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

# File lib/rubygems/specification.rb, line 472
def platform=(platform)
  @original_platform = platform

  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
end

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

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

# File lib/rubygems/specification.rb, line 668
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 683
def required_rubygems_version=(req)
  @required_rubygems_version = Gem::Requirement.create req
end

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

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

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

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

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

# File lib/rubygems/specification.rb, line 256
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 1250
def self._load(str)
  Gem.load_yaml
  Gem.load_safe_marshal

  yaml_set = false
  retry_count = 0

  array = begin
    Gem::SafeMarshal.safe_load str
  rescue ArgumentError => e
    # Avoid an infinite retry loop when the argument error has nothing to do
    # with the classes not being defined.
    # 1 retry each allowed in case all 3 of
    # - YAML
    # - YAML::Syck::DefaultKey
    # - YAML::PrivateType
    # need to be defined
    raise if retry_count >= 3

    #
    # 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") && !YAML::Syck.const_defined?(:DefaultKey)
    elsif message.include?("YAML::PrivateType") && !YAML.const_defined?(:PrivateType)
      YAML.const_set "PrivateType", Class.new
    end

    retry_count += 1
    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.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]
  # offset due to has_rdoc removal
  spec.instance_variable_set :@licenses,                  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 854
def self.add_spec(spec)
  specification_record.add_spec(spec)
end

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

# File lib/rubygems/specification.rb, line 878
def self.all=(specs)
  specification_record.all = specs
end

# File lib/rubygems/specification.rb, line 885
def self.all_names
  specification_record.all_names
end

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

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

# File lib/rubygems/specification.rb, line 801
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 910
def self.dirs
  @@dirs ||= Gem::SpecificationRecord.dirs_from(gem_path)
end

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

  @@dirs = Gem::SpecificationRecord.dirs_from(Array(dirs))
end

# File lib/rubygems/specification.rb, line 930
def self.each(&block)
  specification_record.each(&block)
end

# File lib/rubygems/specification.rb, line 992
def self.find_active_stub_by_path(path)
  specification_record.find_active_stub_by_path(path)
end

# File lib/rubygems/specification.rb, line 944
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 937
def self.find_all_by_name(name, *requirements)
  specification_record.find_all_by_name(name, *requirements)
end

# File lib/rubygems/specification.rb, line 960
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 952
def self.find_by_name(name, *requirements)
  requirements = Gem::Requirement.default if requirements.empty?

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

# File lib/rubygems/specification.rb, line 967
def self.find_by_path(path)
  specification_record.find_by_path(path)
end

# File lib/rubygems/specification.rb, line 999
def self.find_in_unresolved(path)
  unresolved_specs.find_all {|spec| spec.contains_requirable_file? path }
end

# File lib/rubygems/specification.rb, line 1007
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.conflicts_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 984
def self.find_inactive_by_path(path)
  specification_record.find_inactive_by_path(path)
end

# File lib/rubygems/specification.rb, line 976
def self.find_unloaded_by_path(path)
  specification_record.find_unloaded_by_path(path)
end

# File lib/rubygems/specification.rb, line 1034
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 1066
def self.latest_spec_for(name)
  specification_record.latest_spec_for(name)
end

# File lib/rubygems/specification.rb, line 1059
def self.latest_specs(prerelease = false)
  specification_record.latest_specs(prerelease)
end

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

  spec = @load_cache_mutex.synchronize { @load_cache[file] }
  return spec if spec

  return unless File.file?(file)

  code = Gem.open_file(file, "r:UTF-8:-", &:read)

  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, StandardError => e
    warn "Invalid gemspec in [#{file}]: #{e}"
  end

  nil
end

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

  if (platform = Gem.platforms.last) && platform != Gem::Platform::RUBY && platform != Gem::Platform.local
    self.platform = platform
  end

  yield self if block_given?
end

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

# File lib/rubygems/specification.rb, line 1133
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 1151
def self.outdated
  outdated_and_latest_version.map {|local, _| local.name }
end

# File lib/rubygems/specification.rb, line 1162
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 861
def self.remove_spec(spec)
  specification_record.remove_spec(spec)
end

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

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

# File lib/rubygems/specification.rb, line 1202
def self.reset
  @@dirs = nil
  Gem.pre_reset_hooks.each(&:call)
  @specification_record = nil
  clear_load_cache

  unless unresolved_deps.empty?
    unresolved = unresolved_deps.filter_map do |name, dep|
      matching_versions = find_all_by_name(name)
      next if dep.latest_version? && matching_versions.any?(&:default_gem?)

      [dep, matching_versions.uniq(&:full_name)]
    end.to_h

    unless unresolved.empty?
      warn "WARN: Unresolved or ambiguous specs during Gem::Specification.reset:"
      unresolved.each do |dep, versions|
        warn "      #{dep}"

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

    unresolved_deps.clear
  end
  Gem.post_reset_hooks.each(&:call)
end

# File lib/rubygems/specification.rb, line 1238
def self.specification_record
  @specification_record ||= Gem::SpecificationRecord.new(dirs)
end

# File lib/rubygems/specification.rb, line 794
def self.stubs
  specification_record.stubs
end