Gem::Specification

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

    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.instance_variable_set :@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 :@loaded,                    false

    spec
  end

# File lib/rubygems/specification.rb, line 175
  def self.array_attribute(name)
    @@non_nil_attributes << ["@#{name}".intern, []]

    @@array_attributes << name
    @@attributes << [name, []]
    @@default_value[name] = []
    code = %{
      def #{name}
        @#{name} ||= []
      end
      def #{name}=(value)
        @#{name} = Array(value)
      end
    }

    module_eval code, __FILE__, __LINE__ - 9
  end

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

# File lib/rubygems/specification.rb, line 158
  def self.attribute(name, default=nil)
    ivar_name = "@#{name}".intern
    if default.nil? then
      @@nil_attributes << ivar_name
    else
      @@non_nil_attributes << [ivar_name, default]
    end

    @@attributes << [name, default]
    @@default_value[name] = default
    attr_accessor(name)
  end

# File lib/rubygems/specification.rb, line 247
  def self.attribute_alias_singular(singular, plural)
    define_method("#{singular}=") { |val|
      send("#{plural}=", [val])
    }
    define_method("#{singular}") {
      val = send("#{plural}")
      val.nil? ? nil : val.first
    }
  end

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

# File lib/rubygems/specification.rb, line 113
  def self.attribute_names
    @@attributes.map { |name, default| name }
  end

# File lib/rubygems/specification.rb, line 216
  def self.attributes(*args)
    args.each do |arg|
      attribute(arg, nil)
    end
  end

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

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

    unless (spec.instance_variables.include? '@specification_version' or
            spec.instance_variables.include? :@specification_version) and
           spec.instance_variable_get :@specification_version
      spec.instance_variable_set :@specification_version,
                                 NONEXISTENT_SPECIFICATION_VERSION
    end

    spec
  end

# File lib/rubygems/specification.rb, line 499
  def self.load(filename)
    gemspec = nil
    fail "NESTED Specification.load calls not allowed!" if @@gather
    @@gather = proc { |gs| gemspec = gs }
    data = File.read(filename)
    eval(data)
    gemspec
  ensure
    @@gather = nil
  end

# File lib/rubygems/specification.rb, line 415
  def initialize
    @new_platform = nil
    assign_defaults
    @loaded = false
    @loaded_from = nil

    yield self if block_given?

    @@gather.call(self) if @@gather
  end

# File lib/rubygems/specification.rb, line 513
  def self.normalize_yaml_input(input)
    result = input.respond_to?(:read) ? input.read : input
    result = "--- " + result unless result =~ /^--- /
    result
  end

# File lib/rubygems/specification.rb, line 226
  def self.overwrite_accessor(name, &block)
    remove_method name
    define_method(name, &block)
  end

# File lib/rubygems/specification.rb, line 207
  def self.read_only(*names)
    names.each do |name|
      private "#{name}="
    end
  end

# File lib/rubygems/specification.rb, line 196
  def self.required_attribute(*args)
    @@required_attributes << args.first
    attribute(*args)
  end

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

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

# File lib/rubygems/specification.rb, line 262
  def _dump(limit)
    Marshal.dump [
      @rubygems_version,
      @specification_version,
      @name,
      @version,
      (Time === @date ? @date : (require 'time'; Time.parse(@date.to_s))),
      @summary,
      @required_ruby_version,
      @required_rubygems_version,
      @original_platform,
      @dependencies,
      @rubyforge_project,
      @email,
      @authors,
      @description,
      @homepage,
      @has_rdoc,
      @new_platform,
      @licenses
    ]
  end

# File lib/rubygems/specification.rb, line 372
  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 547
  def add_development_dependency(gem, *requirements)
    add_dependency_with_type(gem, :development, *requirements)
  end

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

# File lib/rubygems/specification.rb, line 448
  def assign_defaults
    @@nil_attributes.each do |name|
      instance_variable_set name, nil
    end

    @@non_nil_attributes.each do |name, default|
      value = case default
              when Time, Numeric, Symbol, true, false, nil then default
              else default.dup
              end

      instance_variable_set name, value
    end

    # HACK
    instance_variable_set :@new_platform, Gem::Platform::RUBY
  end

# File lib/rubygems/specification.rb, line 1284
  attribute_alias_singular :author, :authors

# File lib/rubygems/specification.rb, line 929
  def dependent_gems
    out = []
    Gem.source_index.each do |name,gem|
      gem.dependencies.each do |dep|
        if self.satisfies_requirement?(dep) then
          sats = []
          find_all_satisfiers(dep) do |sat|
            sats << sat
          end
          out << [gem, dep, sats]
        end
      end
    end
    out
  end

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

# File lib/rubygems/specification.rb, line 1279
  attribute_alias_singular :executable, :executables

# File lib/rubygems/specification.rb, line 603
  def file_name
    full_name + ".gem"
  end

# File lib/rubygems/specification.rb, line 594
  def full_gem_path
    path = File.join installation_path, 'gems', full_name
    return path if File.directory? path
    File.join installation_path, 'gems', original_name
  end

# File lib/rubygems/specification.rb, line 571
  def full_name
    if platform == Gem::Platform::RUBY or platform.nil? then
      "#{@name}-#{@version}"
    else
      "#{@name}-#{@version}-#{platform}"
    end
  end

# File lib/rubygems/specification.rb, line 1304
  overwrite_accessor :has_rdoc do

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

# File lib/rubygems/specification.rb, line 429
  def initialize_copy(other_spec)
    other_ivars = other_spec.instance_variables
    other_ivars = other_ivars.map { |ivar| ivar.intern } if # for 1.9
      other_ivars.any? { |ivar| String === ivar }

    self.class.array_attributes.each do |name|
      name = :"@#{name}"
      next unless other_ivars.include? name
      instance_variable_set name, other_spec.instance_variable_get(name).dup
    end
  end

# File lib/rubygems/specification.rb, line 610
  def installation_path
    unless @loaded_from then
      raise Gem::Exception, "spec #{full_name} is not from an installed gem"
    end

    File.expand_path File.dirname(File.dirname(@loaded_from))
  end

# File lib/rubygems/specification.rb, line 387
  def lib_files
    @files.select do |file|
      require_paths.any? do |path|
        file.index(path) == 0
      end
    end
  end

# File lib/rubygems/specification.rb, line 1289
  attribute_alias_singular :license, :licenses

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

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

# File lib/rubygems/specification.rb, line 1294
  attribute_alias_singular :require_path, :require_paths

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

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

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

# File lib/rubygems/specification.rb, line 1299
  attribute_alias_singular :test_file, :test_files

# File lib/rubygems/specification.rb, line 706
  def to_ruby
    mark_version
    result = []
    result << "# -*- encoding: utf-8 -*-"
    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="

    handled = [
      :dependencies,
      :name,
      :platform,
      :required_rubygems_version,
      :specification_version,
      :version,
    ]

    attributes = @@attributes.sort_by { |attr_name,| attr_name.to_s }

    attributes.each do |attr_name, default|
      next if handled.include? attr_name
      current_value = self.send(attr_name)
      if current_value != default or
         self.class.required_attribute? attr_name then
        result << "  s.#{attr_name} = #{ruby_code current_value}"
      end
    end

    result << nil
    result << "  if s.respond_to? :specification_version then"
    result << "    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION"
    result << "    s.specification_version = #{specification_version}"
    result << nil

    result << "    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then"

    unless dependencies.empty? then
      dependencies.each do |dep|
        version_reqs_param = dep.requirements_list.inspect
        dep.instance_variable_set :@type, :runtime if dep.type.nil? # HACK
        result << "      s.add_#{dep.type}_dependency(%q<#{dep.name}>, #{version_reqs_param})"
      end
    end

    result << "    else"

    unless dependencies.empty? then
      dependencies.each do |dep|
        version_reqs_param = dep.requirements_list.inspect
        result << "      s.add_dependency(%q<#{dep.name}>, #{version_reqs_param})"
      end
    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"

    result << "end"
    result << nil

    result.join "\n"
  end

# File lib/rubygems/specification.rb, line 788
  def validate
    extend Gem::UserInteraction
    normalize

    if rubygems_version != Gem::RubyGemsVersion then
      raise Gem::InvalidSpecificationException,
            "expected RubyGems version #{Gem::RubyGemsVersion}, 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            do |file| File.directory? file end
    @test_files.delete_if       do |file| File.directory? file end
    @executables.delete_if      do |file|
      File.directory? File.join(bindir, file)
    end
    @extra_rdoc_files.delete_if do |file| File.directory? file end
    @extensions.delete_if       do |file| File.directory? file end

    non_files = files.select do |file|
      !File.file? file
    end

    unless non_files.empty? then
      non_files = non_files.map { |file| file.inspect }
      raise Gem::InvalidSpecificationException,
            "[#{non_files.join ", "}] are not files"
    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

    unless Array === authors and
           authors.all? { |author| String === author } then
      raise Gem::InvalidSpecificationException,
            'authors must be Array of Strings'
    end

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

    # reject FIXME and TODO

    unless authors.grep(/FIXME|TODO/).empty? then
      raise Gem::InvalidSpecificationException,
            '"FIXME" or "TODO" is not an author'
    end

    unless Array(email).grep(/FIXME|TODO/).empty? then
      raise Gem::InvalidSpecificationException,
            '"FIXME" or "TODO" is not an email address'
    end

    if description =~ /FIXME|TODO/ then
      raise Gem::InvalidSpecificationException,
            '"FIXME" or "TODO" is not a description'
    end

    if summary =~ /FIXME|TODO/ then
      raise Gem::InvalidSpecificationException,
            '"FIXME" or "TODO" 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 rubyforge_project summary].each do |attribute|
      value = self.send attribute
      alert_warning "no #{attribute} specified" if value.nil? or value.empty?
    end

    if summary and not summary.empty? and description == summary then
      alert_warning 'description and summary are identical'
    end

    alert_warning "deprecated autorequire specified" if autorequire

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

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

    true
  end

# File lib/rubygems/specification.rb, line 981
  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, requirements, type)
    end

    dependencies << dependency
  end

# File lib/rubygems/specification.rb, line 1002
  def find_all_satisfiers(dep)
    Gem.source_index.each do |_, gem|
      yield gem if gem.satisfies_requirement? dep
    end
  end

# File lib/rubygems/specification.rb, line 1014
  def ruby_code(obj)
    case obj
    when String            then '%q{' + obj + '}'
    when Array             then obj.inspect
    when Gem::Version      then obj.to_s.inspect
    when Date              then '%q{' + obj.strftime('%Y-%m-%d') + '}'
    when Time              then '%q{' + obj.strftime('%Y-%m-%d') + '}'
    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 "Gem::Requirement.new(#{obj.to_s.inspect})"
    else raise Gem::Exception, "ruby_code case not handled: #{obj.class}"
    end
  end

# File lib/rubygems/specification.rb, line 649
  def same_attributes?(other)
    @@attributes.each do |name, default|
      return false unless self.send(name) == other.send(name)
    end
    true
  end