rubygems-update 1.3.1 → 1.3.2

data/lib/rubygems/specification.rb

@@ -13,6 +13,9 @@ require 'rubygems/platform'
 # Time::today has been deprecated in 0.9.5 and will be removed.
 if RUBY_VERSION < '1.9' then
   def Time.today
+    file, lineno = location_of_caller
+    warn "#{file}:#{lineno}:Warning: Time::today is deprecated and will be removed in RubyGems 1.4."
+
     t = Time.now
     t - ((t.to_f + t.gmt_offset) % 86400)
   end unless defined? Time.today
@@ -22,1240 +25,1412 @@ class Date; end # for ruby_code if date.rb wasn't required
 
 # :startdoc:
 
-module Gem
+##
+# The Specification class contains the metadata for a Gem.  Typically
+# defined in a .gemspec file or a Rakefile, and looks like this:
+#
+#   spec = Gem::Specification.new do |s|
+#     s.name = 'rfoo'
+#     s.version = '1.0'
+#     s.summary = 'Example gem specification'
+#     ...
+#   end
+#
+# For a great way to package gems, use Hoe.
+
+class Gem::Specification
 
   ##
-  # == Gem::Specification
-  #
-  # The Specification class contains the metadata for a Gem.  Typically
-  # defined in a .gemspec file or a Rakefile, and looks like this:
+  # Allows deinstallation of gems with legacy platforms.
+
+  attr_accessor :original_platform # :nodoc:
+
+  ##
+  # The the version number of a specification that does not specify one
+  # (i.e. RubyGems 0.7 or earlier).
+
+  NONEXISTENT_SPECIFICATION_VERSION = -1
+
+  ##
+  # The specification version applied to any new Specification instances
+  # created.  This should be bumped whenever something in the spec format
+  # changes.
+  #--
+  # When updating this number, be sure to also update #to_ruby.
   #
-  #   spec = Gem::Specification.new do |s|
-  #     s.name = 'rfoo'
-  #     s.version = '1.0'
-  #     s.summary = 'Example gem specification'
-  #     ...
-  #   end
+  # NOTE RubyGems < 1.2 cannot load specification versions > 2.
+
+  CURRENT_SPECIFICATION_VERSION = 3
+
+  ##
+  # An informal list of changes to the specification.  The highest-valued
+  # key should be equal to the CURRENT_SPECIFICATION_VERSION.
+
+  SPECIFICATION_VERSION_HISTORY = {
+    -1 => ['(RubyGems versions up to and including 0.7 did not have versioned specifications)'],
+    1  => [
+      'Deprecated "test_suite_file" in favor of the new, but equivalent, "test_files"',
+      '"test_file=x" is a shortcut for "test_files=[x]"'
+    ],
+    2  => [
+      'Added "required_rubygems_version"',
+      'Now forward-compatible with future versions',
+    ],
+    3 => [
+       'Added Fixnum validation to the specification_version'
+    ]
+  }
+
+  # :stopdoc:
+  MARSHAL_FIELDS = { -1 => 16, 1 => 16, 2 => 16, 3 => 17 }
+
+  now = Time.at(Time.now.to_i)
+  TODAY = now - ((now.to_i + now.gmt_offset) % 86400)
+  # :startdoc:
+
+  ##
+  # Optional block used to gather newly defined instances.
+
+  @@gather = nil
+
+  ##
+  # List of attribute names: [:name, :version, ...]
+
+  @@required_attributes = []
+
+  ##
+  # List of _all_ attributes and default values:
   #
-  # There are many <em>gemspec attributes</em>, and the best place to learn
-  # about them in the "Gemspec Reference" linked from the RubyGems wiki.
-
-  class Specification
-
-    ##
-    # Allows deinstallation of gems with legacy platforms.
-
-    attr_accessor :original_platform # :nodoc:
-
-    ##
-    # The the version number of a specification that does not specify one
-    # (i.e. RubyGems 0.7 or earlier).
-
-    NONEXISTENT_SPECIFICATION_VERSION = -1
-
-    ##
-    # The specification version applied to any new Specification instances
-    # created.  This should be bumped whenever something in the spec format
-    # changes.
-    #--
-    # When updating this number, be sure to also update #to_ruby.
-    #
-    # NOTE RubyGems < 1.2 cannot load specification versions > 2.
-
-    CURRENT_SPECIFICATION_VERSION = 2
-
-    ##
-    # An informal list of changes to the specification.  The highest-valued
-    # key should be equal to the CURRENT_SPECIFICATION_VERSION.
-
-    SPECIFICATION_VERSION_HISTORY = {
-      -1 => ['(RubyGems versions up to and including 0.7 did not have versioned specifications)'],
-      1  => [
-        'Deprecated "test_suite_file" in favor of the new, but equivalent, "test_files"',
-        '"test_file=x" is a shortcut for "test_files=[x]"'
-      ],
-      2  => [
-        'Added "required_rubygems_version"',
-        'Now forward-compatible with future versions',
-      ],
-    }
+  #   [[:name, nil],
+  #    [:bindir, 'bin'],
+  #    ...]
 
-    # :stopdoc:
-    MARSHAL_FIELDS = { -1 => 16, 1 => 16, 2 => 16 }
+  @@attributes = []
 
-    now = Time.at(Time.now.to_i)
-    TODAY = now - ((now.to_i + now.gmt_offset) % 86400)
-    # :startdoc:
+  @@nil_attributes = []
+  @@non_nil_attributes = [:@original_platform]
 
-    ##
-    # List of Specification instances.
+  ##
+  # List of array attributes
 
-    @@list = []
+  @@array_attributes = []
 
-    ##
-    # Optional block used to gather newly defined instances.
+  ##
+  # Map of attribute names to default values.
 
-    @@gather = nil
+  @@default_value = {}
 
-    ##
-    # List of attribute names: [:name, :version, ...]
-    @@required_attributes = []
+  ##
+  # Names of all specification attributes
 
-    ##
-    # List of _all_ attributes and default values:
-    #
-    #   [[:name, nil],
-    #    [:bindir, 'bin'],
-    #    ...]
+  def self.attribute_names
+    @@attributes.map { |name, default| name }
+  end
 
-    @@attributes = []
+  ##
+  # Default values for specification attributes
 
-    @@nil_attributes = []
-    @@non_nil_attributes = [:@original_platform]
+  def self.attribute_defaults
+    @@attributes.dup
+  end
 
-    ##
-    # List of array attributes
+  ##
+  # The default value for specification attribute +name+
 
-    @@array_attributes = []
+  def self.default_value(name)
+    @@default_value[name]
+  end
 
-    ##
-    # Map of attribute names to default values.
+  ##
+  # Required specification attributes
 
-    @@default_value = {}
+  def self.required_attributes
+    @@required_attributes.dup
+  end
 
-    ##
-    # Names of all specification attributes
+  ##
+  # Is +name+ a required attribute?
 
-    def self.attribute_names
-      @@attributes.map { |name, default| name }
-    end
+  def self.required_attribute?(name)
+    @@required_attributes.include? name.to_sym
+  end
 
-    ##
-    # Default values for specification attributes
+  ##
+  # Specification attributes that are arrays (appendable and so-forth)
 
-    def self.attribute_defaults
-      @@attributes.dup
-    end
+  def self.array_attributes
+    @@array_attributes.dup
+  end
 
-    ##
-    # The default value for specification attribute +name+
+  ##
+  # Specifies the +name+ and +default+ for a specification attribute, and
+  # creates a reader and writer method like Module#attr_accessor.
+  #
+  # The reader method returns the default if the value hasn't been set.
 
-    def self.default_value(name)
-      @@default_value[name]
+  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
 
-    ##
-    # Required specification attributes
+    @@attributes << [name, default]
+    @@default_value[name] = default
+    attr_accessor(name)
+  end
 
-    def self.required_attributes
-      @@required_attributes.dup
-    end
+  ##
+  # Same as :attribute, but ensures that values assigned to the attribute
+  # are array values by applying :to_a to the value.
+
+  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
+    }
 
-    ##
-    # Is +name+ a required attribute?
+    module_eval code, __FILE__, __LINE__ - 9
+  end
 
-    def self.required_attribute?(name)
-      @@required_attributes.include? name.to_sym
-    end
+  ##
+  # Same as attribute above, but also records this attribute as mandatory.
 
-    ##
-    # Specification attributes that are arrays (appendable and so-forth)
+  def self.required_attribute(*args)
+    @@required_attributes << args.first
+    attribute(*args)
+  end
+
+  ##
+  # Sometimes we don't want the world to use a setter method for a
+  # particular attribute.
+  #
+  # +read_only+ makes it private so we can still use it internally.
 
-    def self.array_attributes
-      @@array_attributes.dup
+  def self.read_only(*names)
+    names.each do |name|
+      private "#{name}="
     end
+  end
 
-    ##
-    # A list of Specification instances that have been defined in this Ruby
-    # instance.
+  # Shortcut for creating several attributes at once (each with a default
+  # value of +nil+).
 
-    def self.list
-      @@list
+  def self.attributes(*args)
+    args.each do |arg|
+      attribute(arg, nil)
     end
+  end
 
-    ##
-    # Specifies the +name+ and +default+ for a specification attribute, and
-    # creates a reader and writer method like Module#attr_accessor.
-    #
-    # The reader method returns the default if the value hasn't been set.
+  ##
+  # Some attributes require special behaviour when they are accessed.  This
+  # allows for that.
 
-    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
+  def self.overwrite_accessor(name, &block)
+    remove_method name
+    define_method(name, &block)
+  end
 
-      @@attributes << [name, default]
-      @@default_value[name] = default
-      attr_accessor(name)
-    end
+  ##
+  # Defines a _singular_ version of an existing _plural_ attribute (i.e. one
+  # whose value is expected to be an array).  This means just creating a
+  # helper method that takes a single value and appends it to the array.
+  # These are created for convenience, so that in a spec, one can write
+  #
+  #   s.require_path = 'mylib'
+  #
+  # instead of:
+  #
+  #   s.require_paths = ['mylib']
+  #
+  # That above convenience is available courtesy of:
+  #
+  #   attribute_alias_singular :require_path, :require_paths
 
-    ##
-    # Same as :attribute, but ensures that values assigned to the attribute
-    # are array values by applying :to_a to the value.
+  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
 
-    def self.array_attribute(name)
-      @@non_nil_attributes << ["@#{name}".intern, []]
+  ##
+  # Dump only crucial instance variables.
+  #--
+  # MAINTAIN ORDER!
+
+  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
 
-      @@array_attributes << name
-      @@attributes << [name, []]
-      @@default_value[name] = []
-      code = %{
-        def #{name}
-          @#{name} ||= []
-        end
-        def #{name}=(value)
-          @#{name} = Array(value)
-        end
-      }
+  ##
+  # Load custom marshal format, re-initializing defaults as needed
+
+  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
 
-      module_eval code, __FILE__, __LINE__ - 9
-    end
+  ##
+  # List of depedencies that will automatically be activated at runtime.
 
-    ##
-    # Same as attribute above, but also records this attribute as mandatory.
+  def runtime_dependencies
+    dependencies.select { |d| d.type == :runtime || d.type == nil }
+  end
 
-    def self.required_attribute(*args)
-      @@required_attributes << args.first
-      attribute(*args)
-    end
+  ##
+  # List of dependencies that are used for development
 
-    ##
-    # Sometimes we don't want the world to use a setter method for a
-    # particular attribute.
-    #
-    # +read_only+ makes it private so we can still use it internally.
+  def development_dependencies
+    dependencies.select { |d| d.type == :development }
+  end
 
-    def self.read_only(*names)
-      names.each do |name|
-        private "#{name}="
-      end
+  def test_suite_file # :nodoc:
+    warn 'test_suite_file deprecated, use test_files'
+    test_files.first
+  end
+
+  def test_suite_file=(val) # :nodoc:
+    warn 'test_suite_file= deprecated, use test_files='
+    @test_files = [] unless defined? @test_files
+    @test_files << val
+  end
+
+  ##
+  # true when this gemspec has been loaded from a specifications directory.
+  # This attribute is not persisted.
+
+  attr_accessor :loaded
+
+  ##
+  # Path this gemspec was loaded from.  This attribute is not persisted.
+
+  attr_accessor :loaded_from
+
+  ##
+  # Returns an array with bindir attached to each executable in the
+  # executables list
+
+  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
 
-    # Shortcut for creating several attributes at once (each with a default
-    # value of +nil+).
+  ##
+  # Files in the Gem under one of the require_paths
 
-    def self.attributes(*args)
-      args.each do |arg|
-        attribute(arg, nil)
+  def lib_files
+    @files.select do |file|
+      require_paths.any? do |path|
+        file.index(path) == 0
       end
     end
+  end
 
-    ##
-    # Some attributes require special behaviour when they are accessed.  This
-    # allows for that.
+  ##
+  # True if this gem was loaded from disk
 
-    def self.overwrite_accessor(name, &block)
-      remove_method name
-      define_method(name, &block)
-    end
+  alias :loaded? :loaded
 
-    ##
-    # Defines a _singular_ version of an existing _plural_ attribute (i.e. one
-    # whose value is expected to be an array).  This means just creating a
-    # helper method that takes a single value and appends it to the array.
-    # These are created for convenience, so that in a spec, one can write 
-    #
-    #   s.require_path = 'mylib'
-    #
-    # instead of:
-    #
-    #   s.require_paths = ['mylib']
-    #
-    # That above convenience is available courtesy of:
-    #
-    #   attribute_alias_singular :require_path, :require_paths 
-
-    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
+  ##
+  # True if this gem has files in test_files
 
-    ##
-    # Dump only crucial instance variables.
-    #--
-    # MAINTAIN ORDER!
-
-    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,
-      ]
-    end
+  def has_unit_tests?
+    not test_files.empty?
+  end
 
-    ##
-    # Load custom marshal format, re-initializing defaults as needed
+  # :stopdoc:
+  alias has_test_suite? has_unit_tests?
+  # :startdoc:
 
-    def self._load(str)
-      array = Marshal.load str
+  ##
+  # Specification constructor.  Assigns the default values to the attributes
+  # and yields itself for further initialization.
 
-      spec = Gem::Specification.new
-      spec.instance_variable_set :@specification_version, array[1]
+  def initialize
+    @new_platform = nil
+    assign_defaults
+    @loaded = false
+    @loaded_from = nil
 
-      current_version = CURRENT_SPECIFICATION_VERSION
+    yield self if block_given?
 
-      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
+    @@gather.call(self) if @@gather
+  end
 
-      if array.size < field_count then
-        raise TypeError, "invalid Gem::Specification format #{array.inspect}"
-      end
+  ##
+  # Duplicates array_attributes from +other_spec+ so state isn't shared.
 
-      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 :@loaded,                    false
-
-      spec
+  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
 
-    ##
-    # List of depedencies that will automatically be activated at runtime.
+  ##
+  # Each attribute has a default value (possibly nil).  Here, we initialize
+  # all attributes to their default value.  This is done through the
+  # accessor methods, so special behaviours will be honored.  Furthermore,
+  # we take a _copy_ of the default so each specification instance has its
+  # own empty arrays, etc.
 
-    def runtime_dependencies
-      dependencies.select { |d| d.type == :runtime || d.type == nil }
+  def assign_defaults
+    @@nil_attributes.each do |name|
+      instance_variable_set name, nil
     end
 
-    ##
-    # List of dependencies that are used for development
+    @@non_nil_attributes.each do |name, default|
+      value = case default
+              when Time, Numeric, Symbol, true, false, nil then default
+              else default.dup
+              end
 
-    def development_dependencies
-      dependencies.select { |d| d.type == :development }
+      instance_variable_set name, value
     end
 
-    def test_suite_file # :nodoc:
-      warn 'test_suite_file deprecated, use test_files'
-      test_files.first
+    # HACK
+    instance_variable_set :@new_platform, Gem::Platform::RUBY
+  end
+
+  ##
+  # Special loader for YAML files.  When a Specification object is loaded
+  # from a YAML file, it bypasses the normal Ruby object initialization
+  # routine (#initialize).  This method makes up for that and deals with
+  # gems of different ages.
+  #
+  # 'input' can be anything that YAML.load() accepts: String or IO.
+
+  def self.from_yaml(input)
+    input = normalize_yaml_input input
+    spec = YAML.load input
+
+    if spec && spec.class == FalseClass then
+      raise Gem::EndOfYAMLException
     end
 
-    def test_suite_file=(val) # :nodoc:
-      warn 'test_suite_file= deprecated, use test_files='
-      @test_files = [] unless defined? @test_files
-      @test_files << val
+    unless Gem::Specification === spec then
+      raise Gem::Exception, "YAML data doesn't evaluate to gem specification"
     end
 
-    ##
-    # true when this gemspec has been loaded from a specifications directory.
-    # This attribute is not persisted.
+    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
 
-    attr_accessor :loaded
+    spec
+  end
 
-    ##
-    # Path this gemspec was loaded from.  This attribute is not persisted.
+  ##
+  # Loads ruby format gemspec from +filename+
+
+  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
 
-    attr_accessor :loaded_from
+  ##
+  # Make sure the YAML specification is properly formatted with dashes
 
-    ##
-    # Returns an array with bindir attached to each executable in the
-    # executables list
+  def self.normalize_yaml_input(input)
+    result = input.respond_to?(:read) ? input.read : input
+    result = "--- " + result unless result =~ /^--- /
+    result
+  end
 
-    def add_bindir(executables)
-      return nil if executables.nil?
+  ##
+  # Sets the rubygems_version to the current RubyGems version
 
-      if @bindir then
-        Array(executables).map { |e| File.join(@bindir, e) }
-      else
-        executables
-      end
-    rescue
-      return nil
-    end
+  def mark_version
+    @rubygems_version = Gem::RubyGemsVersion
+  end
 
-    ##
-    # Files in the Gem under one of the require_paths
+  ##
+  # Ignore unknown attributes while loading
 
-    def lib_files
-      @files.select do |file|
-        require_paths.any? do |path|
-          file.index(path) == 0
-        end
-      end
+  def method_missing(sym, *a, &b) # :nodoc:
+    if @specification_version > CURRENT_SPECIFICATION_VERSION and
+      sym.to_s =~ /=$/ then
+      warn "ignoring #{sym} loading #{full_name}" if $DEBUG
+    else
+      super
     end
+  end
 
-    ##
-    # True if this gem was loaded from disk
+  ##
+  # Adds a development dependency named +gem+ with +requirements+ to this
+  # Gem.  For example:
+  #
+  #   spec.add_development_dependency 'jabber4r', '> 0.1', '<= 0.5'
+  #
+  # Development dependencies aren't installed by default and aren't
+  # activated when a gem is required.
 
-    alias :loaded? :loaded
+  def add_development_dependency(gem, *requirements)
+    add_dependency_with_type(gem, :development, *requirements)
+  end
 
-    ##
-    # True if this gem has files in test_files
+  ##
+  # Adds a runtime dependency named +gem+ with +requirements+ to this Gem.
+  # For example:
+  #
+  #   spec.add_runtime_dependency 'jabber4r', '> 0.1', '<= 0.5'
 
-    def has_unit_tests?
-      not test_files.empty?
-    end
+  def add_runtime_dependency(gem, *requirements)
+    add_dependency_with_type(gem, :runtime, *requirements)
+  end
+
+  ##
+  # Adds a runtime dependency
+
+  alias add_dependency add_runtime_dependency
 
-    alias has_test_suite? has_unit_tests? # :nodoc: deprecated
-    
-    ##
-    # Specification constructor.  Assigns the default values to the
-    # attributes, adds this spec to the list of loaded specs (see
-    # Specification.list), and yields itself for further initialization.
+  ##
+  # Returns the full name (name-version) of this Gem.  Platform information
+  # is included (name-version-platform) if it is specified and not the
+  # default Ruby platform.
 
-    def initialize
-      @new_platform = nil
-      assign_defaults
-      @loaded = false
-      @loaded_from = nil
-      @@list << self
+  def full_name
+    if platform == Gem::Platform::RUBY or platform.nil? then
+      "#{@name}-#{@version}"
+    else
+      "#{@name}-#{@version}-#{platform}"
+    end
+  end
 
-      yield self if block_given?
+  ##
+  # Returns the full name (name-version) of this gemspec using the original
+  # platform.  For use with legacy gems.
 
-      @@gather.call(self) if @@gather
+  def original_name # :nodoc:
+    if platform == Gem::Platform::RUBY or platform.nil? then
+      "#{@name}-#{@version}"
+    else
+      "#{@name}-#{@version}-#{@original_platform}"
     end
+  end
 
-    ##
-    # Each attribute has a default value (possibly nil).  Here, we initialize
-    # all attributes to their default value.  This is done through the
-    # accessor methods, so special behaviours will be honored.  Furthermore,
-    # we take a _copy_ of the default so each specification instance has its
-    # own empty arrays, etc.
+  ##
+  # The full path to the gem (install path + full name).
 
-    def assign_defaults
-      @@nil_attributes.each do |name|
-        instance_variable_set name, nil
-      end
+  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
 
-      @@non_nil_attributes.each do |name, default|
-        value = case default
-                when Time, Numeric, Symbol, true, false, nil then default
-                else default.dup
-                end
+  ##
+  # The default (generated) file name of the gem.
 
-        instance_variable_set name, value
-      end
+  def file_name
+    full_name + ".gem"
+  end
 
-      # HACK
-      instance_variable_set :@new_platform, Gem::Platform::RUBY
-    end
+  ##
+  # The directory that this gem was installed into.
 
-    ##
-    # Special loader for YAML files.  When a Specification object is loaded
-    # from a YAML file, it bypasses the normal Ruby object initialization
-    # routine (#initialize).  This method makes up for that and deals with
-    # gems of different ages.
-    #
-    # 'input' can be anything that YAML.load() accepts: String or IO. 
+  def installation_path
+    File.expand_path(File.dirname(File.dirname(@loaded_from)))
+  end
 
-    def self.from_yaml(input)
-      input = normalize_yaml_input input
-      spec = YAML.load input
+  ##
+  # Checks if this specification meets the requirement of +dependency+.
 
-      if spec && spec.class == FalseClass then
-        raise Gem::EndOfYAMLException
-      end
+  def satisfies_requirement?(dependency)
+    return @name == dependency.name &&
+      dependency.version_requirements.satisfied_by?(@version)
+  end
 
-      unless Gem::Specification === spec then
-        raise Gem::Exception, "YAML data doesn't evaluate to gem specification"
-      end
+  ##
+  # Returns an object you can use to sort specifications in #sort_by.
 
-      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
+  def sort_obj
+    [@name, @version, @new_platform == Gem::Platform::RUBY ? -1 : 1]
+  end
 
-      spec
-    end 
-
-    ##
-    # Loads ruby format gemspec from +filename+
-
-    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
+  def <=>(other) # :nodoc:
+    sort_obj <=> other.sort_obj
+  end
 
-    ##
-    # Make sure the YAML specification is properly formatted with dashes
+  ##
+  # Tests specs for equality (across all attributes).
 
-    def self.normalize_yaml_input(input)
-      result = input.respond_to?(:read) ? input.read : input
-      result = "--- " + result unless result =~ /^--- /
-      result
-    end
-    
-    ##
-    # Sets the rubygems_version to the current RubyGems version
+  def ==(other) # :nodoc:
+    self.class === other && same_attributes?(other)
+  end
+
+  alias eql? == # :nodoc:
 
-    def mark_version
-      @rubygems_version = RubyGemsVersion
+  ##
+  # True if this gem has the same attributes as +other+.
+
+  def same_attributes?(other)
+    @@attributes.each do |name, default|
+      return false unless self.send(name) == other.send(name)
     end
+    true
+  end
 
-    ##
-    # Ignore unknown attributes while loading
+  private :same_attributes?
 
-    def method_missing(sym, *a, &b) # :nodoc:
-      if @specification_version > CURRENT_SPECIFICATION_VERSION and
-         sym.to_s =~ /=$/ then
-        warn "ignoring #{sym} loading #{full_name}" if $DEBUG
-      else
-        super
+  def hash # :nodoc:
+    @@attributes.inject(0) { |hash_code, (name, default_value)|
+      n = self.send(name).hash
+      hash_code + n
+    }
+  end
+
+  def to_yaml(opts = {}) # :nodoc:
+    mark_version
+
+    attributes = @@attributes.map { |name,| name.to_s }.sort
+    attributes = attributes - %w[name version platform]
+
+    yaml = YAML.quick_emit object_id, opts do |out|
+      out.map taguri, to_yaml_style do |map|
+        map.add 'name', @name
+        map.add 'version', @version
+        platform = case @original_platform
+                   when nil, '' then
+                     'ruby'
+                   when String then
+                     @original_platform
+                   else
+                     @original_platform.to_s
+                   end
+        map.add 'platform', platform
+
+        attributes.each do |name|
+          map.add name, instance_variable_get("@#{name}")
+        end
       end
     end
+  end
 
-    ##
-    # Adds a development dependency named +gem+ with +requirements+ to this
-    # Gem.  For example:
-    #
-    #   spec.add_development_dependency 'jabber4r', '> 0.1', '<= 0.5'
-    #
-    # Development dependencies aren't installed by default and aren't
-    # activated when a gem is required.
-
-    def add_development_dependency(gem, *requirements)
-      add_dependency_with_type(gem, :development, *requirements)
+  def yaml_initialize(tag, vals) # :nodoc:
+    vals.each do |ivar, val|
+      instance_variable_set "@#{ivar}", val
     end
 
-    ##
-    # Adds a runtime dependency named +gem+ with +requirements+ to this Gem.
-    # For example:
-    #
-    #   spec.add_runtime_dependency 'jabber4r', '> 0.1', '<= 0.5'
+    @original_platform = @platform # for backwards compatibility
+    self.platform = Gem::Platform.new @platform
+  end
 
-    def add_runtime_dependency(gem, *requirements)
-      add_dependency_with_type(gem, :runtime, *requirements)
+  ##
+  # Returns a Ruby code representation of this specification, such that it
+  # can be eval'ed and reconstruct the same specification later.  Attributes
+  # that still have their default values are omitted.
+
+  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
 
-    ##
-    # Adds a runtime dependency
+    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
 
-    alias add_dependency add_runtime_dependency
+    result << "    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then"
 
-    ##
-    # Returns the full name (name-version) of this Gem.  Platform information
-    # is included (name-version-platform) if it is specified and not the
-    # default Ruby platform.
-
-    def full_name
-      if platform == Gem::Platform::RUBY or platform.nil? then
-        "#{@name}-#{@version}"
-      else
-        "#{@name}-#{@version}-#{platform}"
+    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
 
-    ##
-    # Returns the full name (name-version) of this gemspec using the original
-    # platform.  For use with legacy gems.
+    result << "    else"
 
-    def original_name # :nodoc:
-      if platform == Gem::Platform::RUBY or platform.nil? then
-        "#{@name}-#{@version}"
-      else
-        "#{@name}-#{@version}-#{@original_platform}"
+    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
 
-    ##
-    # The full path to the gem (install path + full name).
+    result << '    end'
 
-    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
+    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"
 
-    ##
-    # The default (generated) file name of the gem.
+    result << "end"
+    result << nil
 
-    def file_name
-      full_name + ".gem"
-    end
+    result.join "\n"
+  end
+
+  ##
+  # Checks that the specification contains all required fields, and does a
+  # very basic sanity check.
+  #
+  # Raises InvalidSpecificationException if the spec does not pass the
+  # checks..
 
-    ##
-    # The directory that this gem was installed into.
+  def validate
+    extend Gem::UserInteraction
+    normalize
 
-    def installation_path
-      path = File.dirname(@loaded_from).split(File::SEPARATOR)[0..-2]
-      path = path.join File::SEPARATOR
-      File.expand_path path
+    if rubygems_version != Gem::RubyGemsVersion then
+      raise Gem::InvalidSpecificationException,
+            "expected RubyGems version #{Gem::RubyGemsVersion}, was #{rubygems_version}"
     end
 
-    ##
-    # Checks if this specification meets the requirement of +dependency+.
-
-    def satisfies_requirement?(dependency)
-      return @name == dependency.name && 
-        dependency.version_requirements.satisfied_by?(@version)
+    @@required_attributes.each do |symbol|
+      unless self.send symbol then
+        raise Gem::InvalidSpecificationException,
+              "missing value for attribute #{symbol}"
+      end
     end
 
-    ##
-    # Returns an object you can use to sort specifications in #sort_by.
+    unless String === name then
+      raise Gem::InvalidSpecificationException,
+            "invalid value for attribute name: \"#{name.inspect}\""
+    end
 
-    def sort_obj
-      [@name, @version.to_ints, @new_platform == Gem::Platform::RUBY ? -1 : 1]
+    if require_paths.empty? then
+      raise Gem::InvalidSpecificationException,
+            'specification must have at least one require_path'
     end
 
-    def <=>(other) # :nodoc:
-      sort_obj <=> other.sort_obj
+    @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 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
 
-    ##
-    # Tests specs for equality (across all attributes).
+    unless non_files.empty? then
+      non_files = non_files.map { |file| file.inspect }
+      raise Gem::InvalidSpecificationException,
+            "[#{non_files.join ", "}] are not files"
+    end
 
-    def ==(other) # :nodoc:
-      self.class === other && same_attributes?(other)
+    unless specification_version.is_a?(Fixnum)
+      raise Gem::InvalidSpecificationException,
+            'specification_version must be a Fixnum (did you mean version?)'
     end
 
-    alias eql? == # :nodoc:
+    case platform
+    when Gem::Platform, Gem::Platform::RUBY then # ok
+    else
+      raise Gem::InvalidSpecificationException,
+            "invalid platform #{platform.inspect}, see Gem::Platform"
+    end
 
-    ##
-    # True if this gem has the same attributes as +other+.
+    unless Array === authors and
+           authors.all? { |author| String === author } then
+      raise Gem::InvalidSpecificationException,
+            'authors must be Array of Strings'
+    end
 
-    def same_attributes?(other)
-      @@attributes.each do |name, default|
-        return false unless self.send(name) == other.send(name)
+    licenses.each{ |license|
+      if license.length > 64
+        raise Gem::InvalidSpecificationException,
+          "each license must be 64 characters or less"
       end
-      true
+    }
+
+    # 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
 
-    private :same_attributes?
+    if description =~ /FIXME|TODO/ then
+      raise Gem::InvalidSpecificationException,
+            '"FIXME" or "TODO" is not a description'
+    end
 
-    def hash # :nodoc:
-      @@attributes.inject(0) { |hash_code, (name, default_value)|
-        n = self.send(name).hash
-        hash_code + n
-      }
+    if summary =~ /FIXME|TODO/ then
+      raise Gem::InvalidSpecificationException,
+            '"FIXME" or "TODO" is not a summary'
     end
 
-    def to_yaml(opts = {}) # :nodoc:
-      mark_version
-
-      attributes = @@attributes.map { |name,| name.to_s }.sort
-      attributes = attributes - %w[name version platform]
-
-      yaml = YAML.quick_emit object_id, opts do |out|
-        out.map taguri, to_yaml_style do |map|
-          map.add 'name', @name
-          map.add 'version', @version
-          platform = case @original_platform
-                     when nil, '' then
-                       'ruby'
-                     when String then
-                       @original_platform
-                     else
-                       @original_platform.to_s
-                     end
-          map.add 'platform', platform
-
-          attributes.each do |name|
-            map.add name, instance_variable_get("@#{name}")
-          end
-        end
-      end
+    unless homepage.empty? or homepage =~ /\A[a-z][a-z\d+.-]*:/i then
+      raise Gem::InvalidSpecificationException,
+            "\"#{homepage}\" is not a URI"
     end
 
-    def yaml_initialize(tag, vals) # :nodoc:
-      vals.each do |ivar, val|
-        instance_variable_set "@#{ivar}", val
-      end
+    # Warnings
 
-      @original_platform = @platform # for backwards compatibility
-      self.platform = Gem::Platform.new @platform
+    %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
 
-    ##
-    # Returns a Ruby code representation of this specification, such that it
-    # can be eval'ed and reconstruct the same specification later.  Attributes
-    # that still have their default values are omitted.
-
-    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,
-      ]
+    if summary and not summary.empty? and description == summary then
+      alert_warning 'description and summary are identical'
+    end
 
-      attributes = @@attributes.sort_by { |attr_name,| attr_name.to_s }
+    alert_warning "RDoc will not be generated (has_rdoc == false)" unless
+      has_rdoc
 
-      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
+    alert_warning "deprecated autorequire specified" if autorequire
 
-      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
+    executables.each do |executable|
+      executable_path = File.join bindir, executable
+      shebang = File.read(executable_path, 2) == '#!'
 
-      result << "    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then"
+      alert_warning "#{executable_path} is missing #! line" unless shebang
+    end
 
-      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
+    true
+  end
 
-      result << "    else"
+  ##
+  # Normalize the list of files so that:
+  # * All file lists have redundancies removed.
+  # * Files referenced in the extra_rdoc_files are included in the package
+  #   file list.
+
+  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
 
-      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})"
+  ##
+  # Return a list of all gems that have a dependency on this gemspec.  The
+  # list is structured with entries that conform to:
+  #
+  #   [depending_gem, dependency, [list_of_gems_that_satisfy_dependency]]
+
+  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
 
-      result << '    end'
+  def to_s # :nodoc:
+    "#<Gem::Specification name=#{@name} version=#{@version}>"
+  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"
+  def pretty_print(q) # :nodoc:
+    q.group 2, 'Gem::Specification.new do |s|', 'end' do
+      q.breakable
 
-      result << "end"
-      result << nil
+      attributes = @@attributes.sort_by { |attr_name,| attr_name.to_s }
 
-      result.join "\n"
-    end
+      attributes.each do |attr_name, default|
+        current_value = self.send attr_name
+        if current_value != default or
+           self.class.required_attribute? attr_name then
 
-    ##
-    # Checks that the specification contains all required fields, and does a
-    # very basic sanity check.
-    #
-    # Raises InvalidSpecificationException if the spec does not pass the
-    # checks..
+          q.text "s.#{attr_name} = "
 
-    def validate
-      extend Gem::UserInteraction
-      normalize
+          if attr_name == :date then
+            current_value = current_value.utc
 
-      if rubygems_version != RubyGemsVersion then
-        raise Gem::InvalidSpecificationException,
-              "expected RubyGems version #{RubyGemsVersion}, was #{rubygems_version}"
-      end
+            q.text "Time.utc(#{current_value.year}, #{current_value.month}, #{current_value.day})"
+          else
+            q.pp current_value
+          end
 
-      @@required_attributes.each do |symbol|
-        unless self.send symbol then
-          raise Gem::InvalidSpecificationException,
-                "missing value for attribute #{symbol}"
+          q.breakable
         end
-      end 
-
-      if require_paths.empty? then
-        raise Gem::InvalidSpecificationException,
-              "specification must have at least one require_path"
-      end
-
-      case platform
-      when Gem::Platform, Platform::RUBY then # ok
-      else
-        raise Gem::InvalidSpecificationException,
-              "invalid platform #{platform.inspect}, see Gem::Platform"
       end
+    end
+  end
 
-      unless Array === authors and
-             authors.all? { |author| String === author } then
-        raise Gem::InvalidSpecificationException,
-              'authors must be Array of Strings'
-      end
+  ##
+  # Adds a dependency on gem +dependency+ with type +type+ that requires
+  # +requirements+.  Valid types are currently <tt>:runtime</tt> and
+  # <tt>:development</tt>.
 
-      # Warnings
+  def add_dependency_with_type(dependency, type, *requirements)
+    requirements = if requirements.empty? then
+                     Gem::Requirement.default
+                   else
+                     requirements.flatten
+                   end
 
-      %w[author email homepage rubyforge_project summary].each do |attribute|
-        value = self.send attribute
-        alert_warning "no #{attribute} specified" if value.nil? or value.empty?
-      end
+    unless dependency.respond_to?(:name) &&
+      dependency.respond_to?(:version_requirements)
 
-      alert_warning "RDoc will not be generated (has_rdoc == false)" unless
-        has_rdoc
+      dependency = Gem::Dependency.new(dependency, requirements, type)
+    end
 
-      alert_warning "deprecated autorequire specified" if autorequire
+    dependencies << dependency
+  end
 
-      executables.each do |executable|
-        executable_path = File.join bindir, executable
-        shebang = File.read(executable_path, 2) == '#!'
+  private :add_dependency_with_type
 
-        alert_warning "#{executable_path} is missing #! line" unless shebang
-      end
+  ##
+  # Finds all gems that satisfy +dep+
 
-      true
+  def find_all_satisfiers(dep)
+    Gem.source_index.each do |_, gem|
+      yield gem if gem.satisfies_requirement? dep
     end
+  end
 
-    ##
-    # Normalize the list of files so that:
-    # * All file lists have redundancies removed.
-    # * Files referenced in the extra_rdoc_files are included in the package
-    #   file list. 
-    #
-    # Also, the summary and description are converted to a normal format. 
-
-    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
+  private :find_all_satisfiers
 
-    ##
-    # Return a list of all gems that have a dependency on this gemspec.  The
-    # list is structured with entries that conform to:
-    #
-    #   [depending_gem, dependency, [list_of_gems_that_satisfy_dependency]]
-
-    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
+  ##
+  # Return a string containing a Ruby code representation of the given
+  # object.
+
+  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
 
-    def to_s
-      "#<Gem::Specification name=#{@name} version=#{@version}>"
-    end
+  private :ruby_code
 
-    def add_dependency_with_type(dependency, type, *requirements)
-      requirements = if requirements.empty? then
-                       Gem::Requirement.default
-                     else
-                       requirements.flatten
-                     end
+  # :section: Required gemspec attributes
 
-      unless dependency.respond_to?(:name) &&
-        dependency.respond_to?(:version_requirements)
+  ##
+  # :attr_accessor: rubygems_version
+  #
+  # The version of RubyGems used to create this gem
 
-        dependency = Dependency.new(dependency, requirements, type)
-      end
+  required_attribute :rubygems_version, Gem::RubyGemsVersion
 
-      dependencies << dependency
-    end
+  ##
+  # :attr_accessor: specification_version
+  #
+  # The Gem::Specification version of this gemspec
 
-    private :add_dependency_with_type
+  required_attribute :specification_version, CURRENT_SPECIFICATION_VERSION
 
-    def find_all_satisfiers(dep)
-      Gem.source_index.each do |name,gem|
-        if(gem.satisfies_requirement?(dep)) then
-          yield gem
-        end
-      end
-    end
+  ##
+  # :attr_accessor: name
+  #
+  # This gem's name
 
-    private :find_all_satisfiers
-
-    ##
-    # Return a string containing a Ruby code representation of the given
-    # object.
-
-    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 Exception, "ruby_code case not handled: #{obj.class}"
-      end
-    end
-    
-    private :ruby_code
+  required_attribute :name
+
+  ##
+  # :attr_accessor: version
+  #
+  # This gem's version
 
-    # :section: Required gemspec attributes
-    
-    ##
-    # The version of RubyGems used to create this gem
+  required_attribute :version
 
-    required_attribute :rubygems_version, Gem::RubyGemsVersion
+  ##
+  # :attr_accessor: date
+  #
+  # The date this gem was created
 
-    ##
-    # The Gem::Specification version of this gemspec
+  required_attribute :date, TODAY
 
-    required_attribute :specification_version, CURRENT_SPECIFICATION_VERSION
+  ##
+  # :attr_accessor: summary
+  #
+  # A short summary of this gem's description.  Displayed in `gem list -d`.
 
-    ##
-    # This gem's name
+  required_attribute :summary
 
-    required_attribute :name
+  ##
+  # :attr_accessor: require_paths
+  #
+  # Paths in the gem to add to $LOAD_PATH when this gem is activated
 
-    ##
-    # This gem's version
+  required_attribute :require_paths, ['lib']
 
-    required_attribute :version
+  # :section: Optional gemspec attributes
 
-    ##
-    # The date this gem was created
+  ##
+  # :attr_accessor: email
+  #
+  # A contact email for this gem
 
-    required_attribute :date, TODAY
+  attribute :email
 
-    ##
-    # A short summary of this gem's description.  Displayed in `gem list -d`.
+  ##
+  # :attr_accessor: homepage
+  #
+  # The URL of this gem's home page
 
-    required_attribute :summary
+  attribute :homepage
 
-    ##
-    # Paths in the gem to add to $LOAD_PATH when this gem is activated
+  ##
+  # :attr_accessor: rubyforge_project
+  #
+  # The rubyforge project this gem lives under.  i.e. RubyGems'
+  # rubyforge_project is "rubygems".
 
-    required_attribute :require_paths, ['lib']
+  attribute :rubyforge_project
 
-    # :section: Optional gemspec attributes
+  ##
+  # :attr_accessor: description
+  #
+  # A long description of this gem
 
-    ##
-    # A contact email for this gem
-    
-    attribute :email
+  attribute :description
 
-    ##
-    # The URL of this gem's home page
+  ##
+  # :attr_accessor: autorequire
+  #
+  # Autorequire was used by old RubyGems to automatically require a file.
+  # It no longer is supported.
 
-    attribute :homepage
+  attribute :autorequire
 
-    ##
-    # The rubyforge project this gem lives under.  i.e. RubyGems'
-    # rubyforge_project is "rubygems".
-    
-    attribute :rubyforge_project
+  ##
+  # :attr_accessor: default_executable
+  #
+  # The default executable for this gem.
 
-    ##
-    # A long description of this gem
+  attribute :default_executable
 
-    attribute :description
+  ##
+  # :attr_accessor: bindir
+  #
+  # The path in the gem for executable scripts
 
-    ##
-    # Autorequire was used by old RubyGems to automatically require a file.
-    # It no longer is supported.
+  attribute :bindir, 'bin'
 
-    attribute :autorequire
+  ##
+  # :attr_accessor: has_rdoc
+  #
+  # True if this gem is RDoc-compliant
 
-    ##
-    # The default executable for this gem.
+  attribute :has_rdoc, false
 
-    attribute :default_executable
+  ##
+  # True if this gem supports RDoc
 
-    ##
-    # The path in the gem for executable scripts
+  alias :has_rdoc? :has_rdoc
 
-    attribute :bindir, 'bin'
+  ##
+  # :attr_accessor: required_ruby_version
+  #
+  # The ruby of version required by this gem
 
-    ##
-    # True if this gem is RDoc-compliant
+  attribute :required_ruby_version, Gem::Requirement.default
 
-    attribute :has_rdoc, false
+  ##
+  # :attr_accessor: required_rubygems_version
+  #
+  # The RubyGems version required by this gem
 
-    ##
-    # True if this gem supports RDoc
+  attribute :required_rubygems_version, Gem::Requirement.default
 
-    alias :has_rdoc? :has_rdoc
+  ##
+  # :attr_accessor: platform
+  #
+  # The platform this gem runs on.  See Gem::Platform for details.
 
-    ##
-    # The ruby of version required by this gem
+  attribute :platform, Gem::Platform::RUBY
 
-    attribute :required_ruby_version, Gem::Requirement.default
+  ##
+  # :attr_accessor: signing_key
+  #
+  # The key used to sign this gem.  See Gem::Security for details.
 
-    ##
-    # The RubyGems version required by this gem
+  attribute :signing_key, nil
 
-    attribute :required_rubygems_version, Gem::Requirement.default
+  ##
+  # :attr_accessor: cert_chain
+  #
+  # The certificate chain used to sign this gem.  See Gem::Security for
+  # details.
 
-    ##
-    # The platform this gem runs on.  See Gem::Platform for details.
+  attribute :cert_chain, []
 
-    attribute :platform, Gem::Platform::RUBY
+  ##
+  # :attr_accessor: post_install_message
+  #
+  # A message that gets displayed after the gem is installed
 
-    ##
-    # The key used to sign this gem.  See Gem::Security for details.
+  attribute :post_install_message, nil
 
-    attribute :signing_key, nil
+  ##
+  # :attr_accessor: authors
+  #
+  # The list of authors who wrote this gem
 
-    ##
-    # The certificate chain used to sign this gem.  See Gem::Security for
-    # details.
+  array_attribute :authors
 
-    attribute :cert_chain, []
+  ##
+  # :attr_accessor: licenses
+  #
+  # The license(s) for the library.  Each license must be a short name, no
+  # more than 64 characters.
 
-    ##
-    # A message that gets displayed after the gem is installed
+  array_attribute :licenses
 
-    attribute :post_install_message, nil
+  ##
+  # :attr_accessor: files
+  #
+  # Files included in this gem.  You cannot append to this accessor, you must
+  # assign to it.
+  #
+  # Only add files you can require to this list, not directories, etc.
+  #
+  # Directories are automatically stripped from this list when building a gem,
+  # other non-files cause an error.
 
-    ##
-    # The list of authors who wrote this gem
+  array_attribute :files
 
-    array_attribute :authors
+  ##
+  # :attr_accessor: test_files
+  #
+  # Test files included in this gem.  You cannot append to this accessor, you
+  # must assign to it.
 
-    ##
-    # Files included in this gem
+  array_attribute :test_files
+
+  ##
+  # :attr_accessor: rdoc_options
+  #
+  # An ARGV-style array of options to RDoc
 
-    array_attribute :files
+  array_attribute :rdoc_options
 
-    ##
-    # Test files included in this gem
+  ##
+  # :attr_accessor: extra_rdoc_files
+  #
+  # Extra files to add to RDoc
 
-    array_attribute :test_files
+  array_attribute :extra_rdoc_files
 
-    ##
-    # An ARGV-style array of options to RDoc
+  ##
+  # :attr_accessor: executables
+  #
+  # Executables included in the gem
 
-    array_attribute :rdoc_options
+  array_attribute :executables
 
-    ##
-    # Extra files to add to RDoc
+  ##
+  # :attr_accessor: extensions
+  #
+  # Extensions to build when installing the gem.  See
+  # Gem::Installer#build_extensions for valid values.
 
-    array_attribute :extra_rdoc_files
+  array_attribute :extensions
 
-    ##
-    # Executables included in the gem
+  ##
+  # :attr_accessor: requirements
+  #
+  # An array or things required by this gem.  Not used by anything
+  # presently.
 
-    array_attribute :executables
+  array_attribute :requirements
 
-    ##
-    # Extensions to build when installing the gem.  See
-    # Gem::Installer#build_extensions for valid values.
+  ##
+  # :attr_reader: dependencies
+  #
+  # A list of Gem::Dependency objects this gem depends on.
 
-    array_attribute :extensions
+  array_attribute :dependencies
 
-    ##
-    # An array or things required by this gem.  Not used by anything
-    # presently.
+  read_only :dependencies
 
-    array_attribute :requirements
+  # :section: Aliased gemspec attributes
 
-    ##
-    # A list of Gem::Dependency objects this gem depends on.  Only appendable.
+  ##
+  # Singular accessor for #executables
 
-    array_attribute :dependencies
+  attribute_alias_singular :executable, :executables
 
-    read_only :dependencies
+  ##
+  # Singular accessor for #authors
 
-    # :section: Aliased gemspec attributes
+  attribute_alias_singular :author, :authors
 
-    ##
-    # Singular accessor for executables
-    
-    attribute_alias_singular :executable, :executables
+  ##
+  # Singular accessor for #licenses
 
-    ##
-    # Singular accessor for authors
+  attribute_alias_singular :license, :licenses
 
-    attribute_alias_singular :author, :authors
+  ##
+  # Singular accessor for #require_paths
 
-    ##
-    # Singular accessor for require_paths
+  attribute_alias_singular :require_path, :require_paths
 
-    attribute_alias_singular :require_path, :require_paths
+  ##
+  # Singular accessor for #test_files
 
-    ##
-    # Singular accessor for test_files
+  attribute_alias_singular :test_file, :test_files
 
-    attribute_alias_singular :test_file, :test_files
+  overwrite_accessor :version= do |version|
+    @version = Gem::Version.create(version)
+    self.required_rubygems_version = '> 1.3.1' if @version.prerelease?
+    return @version
+  end
 
-    overwrite_accessor :version= do |version|
-      @version = Version.create(version)
-    end
+  overwrite_accessor :platform do
+    @new_platform
+  end
 
-    overwrite_accessor :platform do
-      @new_platform
+  overwrite_accessor :platform= do |platform|
+    if @original_platform.nil? or
+       @original_platform == Gem::Platform::RUBY then
+      @original_platform = platform
     end
 
-    overwrite_accessor :platform= do |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
+    case platform
+    when Gem::Platform::CURRENT then
+      @new_platform = Gem::Platform.local
+      @original_platform = @new_platform.to_s
 
-      @platform = @new_platform.to_s
+    when Gem::Platform then
+      @new_platform = platform
 
-      @new_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
 
-    overwrite_accessor :required_ruby_version= do |value|
-      @required_ruby_version = Gem::Requirement.create(value)
-    end
+    @platform = @new_platform.to_s
 
-    overwrite_accessor :required_rubygems_version= do |value|
-      @required_rubygems_version = Gem::Requirement.create(value)
-    end
+    @new_platform
+  end
 
-    overwrite_accessor :date= do |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.
-      case date
-      when String then
-        @date = if /\A(\d{4})-(\d{2})-(\d{2})\Z/ =~ date then
-                  Time.local($1.to_i, $2.to_i, $3.to_i)
-                else
-                  require 'time'
-                  Time.parse date
-                end
-      when Time then
-        @date = Time.local(date.year, date.month, date.day)
-      when Date then
-        @date = Time.local(date.year, date.month, date.day)
-      else
-        @date = TODAY
-      end
-    end
+  overwrite_accessor :required_ruby_version= do |value|
+    @required_ruby_version = Gem::Requirement.create(value)
+  end
 
-    overwrite_accessor :date do
-      self.date = nil if @date.nil?  # HACK Sets the default value for date
-      @date
-    end
+  overwrite_accessor :required_rubygems_version= do |value|
+    @required_rubygems_version = Gem::Requirement.create(value)
+  end
 
-    overwrite_accessor :summary= do |str|
-      @summary = if str then
-                   str.strip.
-                   gsub(/(\w-)\n[ \t]*(\w)/, '\1\2').
-                   gsub(/\n[ \t]*/, " ")
-                 end
+  overwrite_accessor :date= do |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.
+    case date
+    when String then
+      @date = if /\A(\d{4})-(\d{2})-(\d{2})\Z/ =~ date then
+                Time.local($1.to_i, $2.to_i, $3.to_i)
+              else
+                require 'time'
+                Time.parse date
+              end
+    when Time then
+      @date = Time.local(date.year, date.month, date.day)
+    when Date then
+      @date = Time.local(date.year, date.month, date.day)
+    else
+      @date = TODAY
     end
+  end
 
-    overwrite_accessor :description= do |str|
-      @description = if str then
-                       str.strip.
-                       gsub(/(\w-)\n[ \t]*(\w)/, '\1\2').
-                       gsub(/\n[ \t]*/, " ")
-                     end
-    end
+  overwrite_accessor :date do
+    self.date = nil if @date.nil?  # HACK Sets the default value for date
+    @date
+  end
 
-    overwrite_accessor :default_executable do
-      begin
-        if defined?(@default_executable) and @default_executable
-          result = @default_executable
-        elsif @executables and @executables.size == 1
-          result = Array(@executables).first
-        else
-          result = nil
-        end
-        result
-      rescue
-        nil
-      end
-    end
+  overwrite_accessor :summary= do |str|
+    @summary = if str then
+                 str.strip.
+                 gsub(/(\w-)\n[ \t]*(\w)/, '\1\2').
+                 gsub(/\n[ \t]*/, " ")
+               end
+  end
 
-    overwrite_accessor :test_files do
-      # 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
+  overwrite_accessor :description= do |str|
+    @description = str.to_s
+  end
+
+  overwrite_accessor :default_executable do
+    begin
+      if defined?(@default_executable) and @default_executable
+        result = @default_executable
+      elsif @executables and @executables.size == 1
+        result = Array(@executables).first
       else
-        @test_files = []
+        result = nil
       end
+      result
+    rescue
+      nil
     end
+  end
 
-    overwrite_accessor :files do
-      result = []
-      result.push(*@files) if defined?(@files)
-      result.push(*@test_files) if defined?(@test_files)
-      result.push(*(add_bindir(@executables)))
-      result.push(*@extra_rdoc_files) if defined?(@extra_rdoc_files)
-      result.push(*@extensions) if defined?(@extensions)
-      result.uniq.compact
+  overwrite_accessor :test_files do
+    # 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
 
+  overwrite_accessor :files do
+    result = []
+    result.push(*@files) if defined?(@files)
+    result.push(*@test_files) if defined?(@test_files)
+    result.push(*(add_bindir(@executables)))
+    result.push(*@extra_rdoc_files) if defined?(@extra_rdoc_files)
+    result.push(*@extensions) if defined?(@extensions)
+    result.uniq.compact
   end
 
 end