backports 2.3.0 → 2.4.0

data/.irbrc

@@ -0,0 +1 @@
+$:.unshift "./lib"

data/README.rdoc

@@ -23,7 +23,7 @@ Features in this gem:
 
 Let's be a bit more precise about the breaking code business. It is of course entirely possible that code will break, for example some core methods are monkeypatched or if the code relies on a certain call raising an exception. Example: <tt>[42].sample rescue "dum example"</tt> will return <tt>"dum example"</tt> without this gem and <tt>42</tt> with it.
 
-A real incompatibility is, for example, <tt>Module::instance_methods</tt> which returns strings in 1.8 and symbols in 1.9. No change can be made without the risk of breaking existing code. Such incompatibilities are left unchanged.
+A real incompatibility is, for example, <tt>Module::instance_methods</tt> which returns strings in 1.8 and symbols in 1.9. No change can be made without the risk of breaking existing code. Such incompatibilities are left unchanged, although you can require some of these changes in addition (see below)
 
 All features of 1.8.7 are backported (well, almost all, see the exception list bellow), and many of 1.9 are also.
 
@@ -75,15 +75,25 @@ Additionally, the following Ruby 1.9 features have been backported:
   * +binread+
   * +to_path+
   * All class methods accepting filenames will accept files or anything with a <tt>#to_path</tt> method.
+  * <tt>File.open</tt> accepts an options hash.
+
+* Float
+  * +round+
 
 * Hash
+  * +assoc+, +rassoc+
   * +try_convert+
   * <tt>default_proc=</tt>
 
+* Integer
+  * +magnitude+
+  * +round+
+
 * IO
   * +bin_read+
   * +try_convert+
   * +ungetbyte+
+  * <tt>IO.open</tt> accepts an options hash.
 
 * Kernel
   * +require_relative+
@@ -92,6 +102,9 @@ Additionally, the following Ruby 1.9 features have been backported:
   * +log+ (with base)
   * +log2+
 
+* Numeric
+  * +round+
+
 * Object
   * +define_singleton_method+
   * +public_method+
@@ -139,6 +152,9 @@ Finally, most of Ruby 1.9.2 features have been backported:
   * <tt>sort_by!</tt>
   * <tt>uniq, uniq!</tt> (with block)
 
+* Complex
+  * +to_r+
+
 * Dir
   * +home+
 
@@ -160,6 +176,13 @@ Finally, most of Ruby 1.9.2 features have been backported:
 
 To include all Ruby backports but not those of Rails, <tt>require "backports/1.9.2"</tt> (or "backports/1.9")
 
+== Ruby 1.9.3
+
+Some features of Ruby 1.9.3 have been backported:
+
+* IO
+  * +write+, +binwrite+
+
 == Rails
 
 Some generic methods from Rails methods have been copied:
@@ -187,11 +210,40 @@ To include _only_ these Rails backports but not those of Ruby, <tt>require "back
 
 == Libraries
 
-Libraries have not been backported. I am aware of the following backport gems:
+Libraries are slowly being backported. You simply require them as usual, ideally (but not necessarily) after requiring backports.
+
+  require "backports"
+  require "prime"
+  42.prime? # => false, even in Ruby 1.8.x
+
+The following libraries are up to date with Ruby 1.9.3:
+
+* Matrix
+* Prime
+* Set
+
+I am aware of the following backport gem which will hopefully be part of backports soon:
 
 * Net::SMTP for Ruby 1.8.6: smtp_tls[http://seattlerb.rubyforge.org/smtp_tls/]
 
-* Let me know of others...
+== Forcing incompatibilities
+
+Some backports would create incompatibilities in their current Ruby version but could be useful in some projects. It is possible to request such incompatible changes. Backports currently supports the following:
+
+* Hash
+  * +select+ (returns a Hash instead of an Array)
+
+* Enumerable / Array
+  * +map+ (returns an enumerator when called without a block)
+
+* String
+  * +length+, +size+ (for UTF-8 support)
+
+These must be imported in addition to the backports gem, for example:
+
+  require "backports"
+  require "backports/force/hash_select"
+  {}.select{} # => {}, even in Ruby 1.8
 
 == Thanks
 

data/Rakefile

@@ -49,6 +49,7 @@ task :default => :test
 
 require 'rake/rdoctask'
 Rake::RDocTask.new do |rdoc|
+  require 'yaml'
   if File.exist?('VERSION.yml')
     config = YAML.load(File.read('VERSION.yml'))
     version = "#{config[:major]}.#{config[:minor]}.#{config[:patch]}"

data/VERSION.yml

@@ -1,5 +1,5 @@
 --- 
 :build: 
 :major: 2
-:minor: 3
+:minor: 4
 :patch: 0

data/backports.gemspec

@@ -1,144 +1,125 @@
 # Generated by jeweler
 # DO NOT EDIT THIS FILE DIRECTLY
-# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
 
 Gem::Specification.new do |s|
   s.name = %q{backports}
-  s.version = "2.3.0"
+  s.version = "2.4.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Marc-Andr\303\251 Lafortune"]
-  s.date = %q{2011-06-23}
+  s.date = %q{2012-03-24}
   s.description = %q{      Essential backports that enable some of the really nice features of ruby 1.8.7, ruby 1.9 and rails from ruby 1.8.6 and earlier.
 }
   s.email = %q{github@marc-andre.ca}
   s.extra_rdoc_files = [
     "LICENSE",
-     "README.rdoc"
+    "README.rdoc"
   ]
   s.files = [
     ".document",
-     ".gitignore",
-     "CHANGELOG.rdoc",
-     "LICENSE",
-     "README.rdoc",
-     "Rakefile",
-     "VERSION.yml",
-     "backports.gemspec",
-     "lib/backports.rb",
-     "lib/backports/1.8.7.rb",
-     "lib/backports/1.8.7/argf.rb",
-     "lib/backports/1.8.7/array.rb",
-     "lib/backports/1.8.7/binding.rb",
-     "lib/backports/1.8.7/dir.rb",
-     "lib/backports/1.8.7/enumerable.rb",
-     "lib/backports/1.8.7/enumerator.rb",
-     "lib/backports/1.8.7/env.rb",
-     "lib/backports/1.8.7/fixnum.rb",
-     "lib/backports/1.8.7/float.rb",
-     "lib/backports/1.8.7/gc.rb",
-     "lib/backports/1.8.7/hash.rb",
-     "lib/backports/1.8.7/integer.rb",
-     "lib/backports/1.8.7/io.rb",
-     "lib/backports/1.8.7/kernel.rb",
-     "lib/backports/1.8.7/method.rb",
-     "lib/backports/1.8.7/module.rb",
-     "lib/backports/1.8.7/numeric.rb",
-     "lib/backports/1.8.7/object_space.rb",
-     "lib/backports/1.8.7/proc.rb",
-     "lib/backports/1.8.7/process.rb",
-     "lib/backports/1.8.7/range.rb",
-     "lib/backports/1.8.7/regexp.rb",
-     "lib/backports/1.8.7/string.rb",
-     "lib/backports/1.8.7/struct.rb",
-     "lib/backports/1.8.7/symbol.rb",
-     "lib/backports/1.8.8.rb",
-     "lib/backports/1.8.rb",
-     "lib/backports/1.9.1.rb",
-     "lib/backports/1.9.1/array.rb",
-     "lib/backports/1.9.1/dir.rb",
-     "lib/backports/1.9.1/enumerable.rb",
-     "lib/backports/1.9.1/enumerator.rb",
-     "lib/backports/1.9.1/env.rb",
-     "lib/backports/1.9.1/file.rb",
-     "lib/backports/1.9.1/hash.rb",
-     "lib/backports/1.9.1/integer.rb",
-     "lib/backports/1.9.1/io.rb",
-     "lib/backports/1.9.1/kernel.rb",
-     "lib/backports/1.9.1/math.rb",
-     "lib/backports/1.9.1/proc.rb",
-     "lib/backports/1.9.1/range.rb",
-     "lib/backports/1.9.1/regexp.rb",
-     "lib/backports/1.9.1/string.rb",
-     "lib/backports/1.9.1/symbol.rb",
-     "lib/backports/1.9.2.rb",
-     "lib/backports/1.9.2/array.rb",
-     "lib/backports/1.9.2/dir.rb",
-     "lib/backports/1.9.2/enumerable.rb",
-     "lib/backports/1.9.2/float.rb",
-     "lib/backports/1.9.2/hash.rb",
-     "lib/backports/1.9.2/kernel.rb",
-     "lib/backports/1.9.2/match_data.rb",
-     "lib/backports/1.9.2/random.rb",
-     "lib/backports/1.9.2/random/MT19937.rb",
-     "lib/backports/1.9.2/random/bits_and_bytes.rb",
-     "lib/backports/1.9.2/random/implementation.rb",
-     "lib/backports/1.9.2/random/load.rb",
-     "lib/backports/1.9.rb",
-     "lib/backports/basic_object.rb",
-     "lib/backports/rails.rb",
-     "lib/backports/rails/array.rb",
-     "lib/backports/rails/enumerable.rb",
-     "lib/backports/rails/hash.rb",
-     "lib/backports/rails/kernel.rb",
-     "lib/backports/rails/module.rb",
-     "lib/backports/rails/string.rb",
-     "lib/backports/tools.rb",
-     "test/_README",
-     "test/array_test.rb",
-     "test/basic_object_test.rb",
-     "test/binding_test.rb",
-     "test/enumerable_test.rb",
-     "test/enumerator_test.rb",
-     "test/hash_test.rb",
-     "test/kernel_test.rb",
-     "test/math_test.rb",
-     "test/method_missing_test.rb",
-     "test/method_test.rb",
-     "test/module_test.rb",
-     "test/object_test.rb",
-     "test/proc_test.rb",
-     "test/regexp_test.rb",
-     "test/string_test.rb",
-     "test/symbol_test.rb",
-     "test/test_helper.rb"
+    ".irbrc",
+    "CHANGELOG.rdoc",
+    "LICENSE",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION.yml",
+    "backports.gemspec",
+    "lib/backports.rb",
+    "lib/backports/1.8.7.rb",
+    "lib/backports/1.8.7/argf.rb",
+    "lib/backports/1.8.7/array.rb",
+    "lib/backports/1.8.7/binding.rb",
+    "lib/backports/1.8.7/dir.rb",
+    "lib/backports/1.8.7/enumerable.rb",
+    "lib/backports/1.8.7/enumerator.rb",
+    "lib/backports/1.8.7/env.rb",
+    "lib/backports/1.8.7/fixnum.rb",
+    "lib/backports/1.8.7/float.rb",
+    "lib/backports/1.8.7/gc.rb",
+    "lib/backports/1.8.7/hash.rb",
+    "lib/backports/1.8.7/integer.rb",
+    "lib/backports/1.8.7/io.rb",
+    "lib/backports/1.8.7/kernel.rb",
+    "lib/backports/1.8.7/method.rb",
+    "lib/backports/1.8.7/module.rb",
+    "lib/backports/1.8.7/numeric.rb",
+    "lib/backports/1.8.7/object_space.rb",
+    "lib/backports/1.8.7/proc.rb",
+    "lib/backports/1.8.7/process.rb",
+    "lib/backports/1.8.7/range.rb",
+    "lib/backports/1.8.7/regexp.rb",
+    "lib/backports/1.8.7/string.rb",
+    "lib/backports/1.8.7/struct.rb",
+    "lib/backports/1.8.7/symbol.rb",
+    "lib/backports/1.8.8.rb",
+    "lib/backports/1.8.rb",
+    "lib/backports/1.9.1.rb",
+    "lib/backports/1.9.1/array.rb",
+    "lib/backports/1.9.1/dir.rb",
+    "lib/backports/1.9.1/enumerable.rb",
+    "lib/backports/1.9.1/enumerator.rb",
+    "lib/backports/1.9.1/env.rb",
+    "lib/backports/1.9.1/file.rb",
+    "lib/backports/1.9.1/float.rb",
+    "lib/backports/1.9.1/hash.rb",
+    "lib/backports/1.9.1/integer.rb",
+    "lib/backports/1.9.1/io.rb",
+    "lib/backports/1.9.1/kernel.rb",
+    "lib/backports/1.9.1/math.rb",
+    "lib/backports/1.9.1/numeric.rb",
+    "lib/backports/1.9.1/proc.rb",
+    "lib/backports/1.9.1/range.rb",
+    "lib/backports/1.9.1/regexp.rb",
+    "lib/backports/1.9.1/stdlib.rb",
+    "lib/backports/1.9.1/stdlib/prime.rb",
+    "lib/backports/1.9.1/string.rb",
+    "lib/backports/1.9.1/symbol.rb",
+    "lib/backports/1.9.2.rb",
+    "lib/backports/1.9.2/array.rb",
+    "lib/backports/1.9.2/complex.rb",
+    "lib/backports/1.9.2/dir.rb",
+    "lib/backports/1.9.2/enumerable.rb",
+    "lib/backports/1.9.2/float.rb",
+    "lib/backports/1.9.2/hash.rb",
+    "lib/backports/1.9.2/kernel.rb",
+    "lib/backports/1.9.2/match_data.rb",
+    "lib/backports/1.9.2/random.rb",
+    "lib/backports/1.9.2/random/MT19937.rb",
+    "lib/backports/1.9.2/random/bits_and_bytes.rb",
+    "lib/backports/1.9.2/random/implementation.rb",
+    "lib/backports/1.9.2/random/load.rb",
+    "lib/backports/1.9.2/stdlib.rb",
+    "lib/backports/1.9.2/stdlib/matrix.rb",
+    "lib/backports/1.9.2/stdlib/matrix/eigenvalue_decomposition.rb",
+    "lib/backports/1.9.2/stdlib/matrix/lup_decomposition.rb",
+    "lib/backports/1.9.2/stdlib/set.rb",
+    "lib/backports/1.9.3.rb",
+    "lib/backports/1.9.3/io.rb",
+    "lib/backports/1.9.rb",
+    "lib/backports/basic_object.rb",
+    "lib/backports/force/array_map.rb",
+    "lib/backports/force/enumerable_map.rb",
+    "lib/backports/force/hash_select.rb",
+    "lib/backports/force/string_length.rb",
+    "lib/backports/force/string_size.rb",
+    "lib/backports/rails.rb",
+    "lib/backports/rails/array.rb",
+    "lib/backports/rails/enumerable.rb",
+    "lib/backports/rails/hash.rb",
+    "lib/backports/rails/kernel.rb",
+    "lib/backports/rails/module.rb",
+    "lib/backports/rails/string.rb",
+    "lib/backports/tools.rb",
+    "test/README"
   ]
   s.homepage = %q{http://github.com/marcandre/backports}
-  s.rdoc_options = ["--charset=UTF-8", "--title", "Backports library", "--main", "README.rdoc", "--line-numbers", "--inline-source"]
+  s.rdoc_options = ["--title", "Backports library", "--main", "README.rdoc", "--line-numbers", "--inline-source"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{backports}
   s.rubygems_version = %q{1.3.7}
   s.summary = %q{Backports of Ruby 1.8.7+ for older ruby.}
-  s.test_files = [
-    "test/array_test.rb",
-     "test/basic_object_test.rb",
-     "test/binding_test.rb",
-     "test/enumerable_test.rb",
-     "test/enumerator_test.rb",
-     "test/hash_test.rb",
-     "test/kernel_test.rb",
-     "test/math_test.rb",
-     "test/method_missing_test.rb",
-     "test/method_test.rb",
-     "test/module_test.rb",
-     "test/object_test.rb",
-     "test/proc_test.rb",
-     "test/regexp_test.rb",
-     "test/string_test.rb",
-     "test/symbol_test.rb",
-     "test/test_helper.rb"
-  ]
 
   if s.respond_to? :specification_version then
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION

data/lib/backports/1.8.7/string.rb

@@ -17,7 +17,7 @@ class String
   unless method_defined? :each_char
     def each_char
       return to_enum(:each_char) unless block_given?
-      scan(/./) {|c| yield c}
+      scan(/./m) {|c| yield c}
     end
 
     Backports.alias_method self, :chars, :each_char

data/lib/backports/1.9.1/array.rb

@@ -2,8 +2,7 @@ class Array
   # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/Array.html]
   class << self
     def try_convert(obj)
-      return nil unless obj.respond_to?(:to_ary)
-      Backports.coerce_to_ary(obj)
+      Backports.try_convert(obj, Array, :to_ary)
     end unless method_defined? :try_convert
   end
 end

data/lib/backports/1.9.1/file.rb

@@ -19,5 +19,25 @@ class File
         :split, :stat, :sticky?, :symlink, :symlink?, :truncate, :writable?,
         :writable_real?, :zero?
     end
+
+    begin
+      File.open(__FILE__, :mode => 'r').close
+    rescue StandardError
+      def open_with_options_hash(file, mode = nil, perm = Backports::Undefined, options = Backports::Undefined)
+        mode, perm = Backports.combine_mode_perm_and_option(mode, perm, options)
+        if block_given?
+          open_without_options_hash(file, mode, perm){|f| yield f}
+        else
+          open_without_options_hash(file, mode, perm)
+        end
+      end
+
+      Backports.alias_method_chain self, :open, :options_hash
+    end
+  end
+
+  module Constants
+    # In Ruby 1.8, it is defined only on Windows
+    BINARY = 0 unless const_defined?(:BINARY)
   end
 end

data/lib/backports/1.9.1/float.rb

@@ -0,0 +1,19 @@
+class Float
+  if instance_method(:round).arity.zero?
+    def round_with_digits(ndigits=0)
+      ndigits = Backports::coerce_to_int(ndigits)
+      case
+      when ndigits.zero?
+        round_without_digits
+      when ndigits < 0
+        p = 10 ** -ndigits
+        p > abs ? 0 : (self / p).round * p
+      else
+        p = 10 ** ndigits
+        prod = self * p
+        prod.infinite? ? self : prod.round.fdiv(p)
+      end
+    end
+    Backports.alias_method_chain self, :round, :digits
+  end
+end

data/lib/backports/1.9.1/hash.rb

@@ -2,8 +2,7 @@ class Hash
   # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/Hash.html]
   class << self
     def try_convert(x)
-      return nil unless x.respond_to? :to_hash
-      x.to_hash
+      Backports.try_convert(x, Hash, :to_hash)
     end unless method_defined? :try_convert
   end
 
@@ -11,4 +10,22 @@ class Hash
   def default_proc=(proc)
     replace(Hash.new(&Backports.coerce_to(proc, Proc, :to_proc)).merge!(self))
   end unless method_defined? :default_proc=
-end
+
+  # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Hash.html]
+  def assoc(key)
+    val = fetch(key) do
+      return find do |k, v|
+        [k, v] if k == key
+      end
+    end
+    [key, val]
+  end unless method_defined? :assoc
+
+
+  # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Hash.html]
+  def rassoc(value)
+    k = key(value)
+    v = fetch(k){return nil}
+    [k, fetch(k)] if k || v == value
+  end unless method_defined? :rassoc
+end

data/lib/backports/1.9.1/integer.rb

@@ -1,3 +1,22 @@
 class Integer
   Backports.alias_method self, :magnitude, :abs
+
+  if instance_method(:round).arity.zero?
+    def round_with_digits(ndigits=0)
+      ndigits = Backports::coerce_to_int(ndigits)
+      case
+      when ndigits.zero?
+        self
+      when ndigits > 0
+        Float(self)
+      else
+        pow = 10 ** (-ndigits)
+        remain = self % pow
+        comp = self < 0 ? :<= : :<
+        remain -= pow unless remain.send(comp, pow / 2)
+        self - remain
+      end
+    end
+    Backports.alias_method_chain self, :round, :digits
+  end
 end

data/lib/backports/1.9.1/io.rb

@@ -8,10 +8,25 @@ class IO
     end unless method_defined? :binread
 
     def try_convert(obj)
-      return nil unless obj.respond_to?(:to_io)
-      Backports.coerce_to(obj, IO, :to_io)
+      Backports.try_convert(obj, IO, :to_io)
     end unless method_defined? :try_convert
+
+    begin
+      File.open(__FILE__) { |f| IO.open(f.fileno, :mode => 'r').close }
+    rescue StandardError
+      def open_with_options_hash(fd, mode = nil, options = Backports::Undefined)
+        mode = Backports.combine_mode_and_option(mode, options)
+        # Can't backport autoclose, {internal|external|}encoding
+        if block_given?
+          open_without_options_hash(fd, mode){|f| yield f}
+        else
+          open_without_options_hash(fd, mode)
+        end
+      end
+
+      Backports.alias_method_chain self, :open, :options_hash
+    end
   end
 
   Backports.alias_method self, :ungetbyte, :ungetc
-end
+end

data/lib/backports/1.9.1/numeric.rb

@@ -0,0 +1,9 @@
+class Numeric
+  if instance_method(:round).arity.zero?
+    def round_with_digits(ndigits=0)
+      ndigits = Backports::coerce_to_int(ndigits)
+      ndigits.zero? ? round_without_digits : Float(self).round(ndigits)
+    end
+    Backports.alias_method_chain self, :round, :digits
+  end
+end

data/lib/backports/1.9.1/regexp.rb

@@ -2,12 +2,7 @@ class Regexp
   # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/Array.html]
   class << self
     def try_convert(obj)
-      case
-        when obj.is_a?(Regexp)
-          obj
-        when obj.respond_to?(:to_regexp)
-          Backports.coerce_to(obj, Regexp, :to_regexp)
-      end
+      Backports.try_convert(obj, Regexp, :to_regexp)
     end unless method_defined? :try_convert
   end
 end