backports 2.1.0 → 2.2.0

data/CHANGELOG.rdoc

@@ -1,5 +1,15 @@
 = Packable --- History
 
+== Version 2.2.0 - May 13th, 2011
+
+* Ruby 1.8.8 was officially cancelled; code was moved to Ruby 1.9.1 and README updated.
+
+* <tt>"".ord</tt> now raises an error.
+
+== Version 2.1.0 - April 16th, 2011
+
+* Proc#curry, #lambda (thanks Konstantine Haase)
+
 == Version 2.0.0 - December 5th, 2010
 
 Change of major version because of two small changes that are not quite compatible and because the minor version was getting quite high!

data/README.rdoc

@@ -10,7 +10,7 @@ The goal of 'backports' is to make it easier to write ruby code that runs across
 
   require 'backports'
   
-This will bring Ruby 1.8.6 or 1.8.7 up to date with the upcoming Ruby 1.8.8, as well as include many features of Ruby 1.9.1 and Ruby 1.9.2!
+This will bring in all the features of 1.8.7 (for Ruby 1.8.6) and many features of Ruby 1.9.1 (for Ruby 1.8.x) and Ruby 1.9.2 (for all earlier versions)!
 
 +Note+: Although I am a Ruby committer, this gem is a personal project and is not endorsed by ruby-core.
 
@@ -25,7 +25,7 @@ Let's be a bit more precise about the breaking code business. It is of course en
 
 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.
 
-All features of 1.8.7 & 1.8.8 are backported (well, almost all, see the exception list bellow), and many of 1.9 are also.
+All features of 1.8.7 are backported (well, almost all, see the exception list bellow), and many of 1.9 are also.
 
 Some generic and self-contained features of active-support are also included. By simple I mean that String#camelcase is there, but #pluralize isn't.
 
@@ -40,7 +40,7 @@ To use:
   require 'rubygems'
   require 'backports'   # or a subset, see next section
 
-Compatible with Ruby 1.8.6, 1.8.7, 1.9.1, JRuby and Rubinius, as well as the upcoming Ruby 1.8.8 and 1.9.2
+Compatible with Ruby 1.8.6, 1.8.7, 1.9.1, 1.9.2, JRuby and Rubinius.
 
 = Complete List of backports
 
@@ -57,24 +57,33 @@ To include _only_ these backports, <tt>require "backports/1.8.7"</tt>
 
 == Ruby 1.8.8
 
-Complete Ruby 1.8.8 backporting (core language). In case you are wondering: no, it's not out yet :-). Refer to the official list of changes[http://svn.ruby-lang.org/repos/ruby/branches/ruby_1_8/NEWS].
-
-Only exception:
-* Enumerator#rewind (incompatible change, so won't be implemented)
-
-To include _only_ these backports and those preceding, <tt>require "backports/1.8.8"</tt>.
+Ruby 1.8.8 has been officially cancelled. As of version 2.2, <tt>require "backports/1.8.8"</tt> does nothing.
 
 == Ruby 1.9.1
 
 Additionally, the following Ruby 1.9 features have been backported:
+* Array
+  * +try_convert+
+
+* Enumerable
+  * +each_with_object+
+
+* Enumerator
+  * +new+ (with block)
 
 * File
   * +binread+
   * +to_path+
-  * All class methods accepting filenames will accept files or anything with a #to_path method.
+  * All class methods accepting filenames will accept files or anything with a <tt>#to_path</tt> method.
+
+* Hash
+  * +try_convert+
+  * <tt>default_proc=</tt>
 
 * IO
   * +bin_read+
+  * +try_convert+
+  * +ungetbyte+
 
 * Kernel
   * +require_relative+
@@ -92,12 +101,22 @@ Additionally, the following Ruby 1.9 features have been backported:
   * +yield+
   * +lambda?+
   * +curry+
+  * <tt>===</tt>
+
+* Range
+  * <tt>cover?</tt>
+
+* Regexp
+  * +try_convert+
 
 * String
   * <tt>ascii_only?</tt>
   * +chr+
   * +clear+
   * +codepoints+, +each_codepoint+
+  * +get_byte+, +set_byte+
+  * +ord+
+  * +try_convert+
 
 +Enumerator+ can be accessed directly (instead of <tt>Enumerable::Enumerator</tt>)
 

data/VERSION.yml

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

data/backports.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{backports}
-  s.version = "2.1.0"
+  s.version = "2.2.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-04-16}
+  s.date = %q{2011-05-13}
   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}
@@ -54,25 +54,22 @@ Gem::Specification.new do |s|
      "lib/backports/1.8.7/struct.rb",
      "lib/backports/1.8.7/symbol.rb",
      "lib/backports/1.8.8.rb",
-     "lib/backports/1.8.8/array.rb",
-     "lib/backports/1.8.8/enumerable.rb",
-     "lib/backports/1.8.8/enumerator.rb",
-     "lib/backports/1.8.8/env.rb",
-     "lib/backports/1.8.8/hash.rb",
-     "lib/backports/1.8.8/io.rb",
-     "lib/backports/1.8.8/proc.rb",
-     "lib/backports/1.8.8/range.rb",
-     "lib/backports/1.8.8/regexp.rb",
-     "lib/backports/1.8.8/string.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",
@@ -121,7 +118,7 @@ Gem::Specification.new do |s|
   s.rdoc_options = ["--charset=UTF-8", "--title", "Backports library", "--main", "README.rdoc", "--line-numbers", "--inline-source"]
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{backports}
-  s.rubygems_version = %q{1.6.0}
+  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",
@@ -144,6 +141,7 @@ Gem::Specification.new do |s|
   ]
 
   if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then

data/lib/backports/1.9.1/io.rb

@@ -6,5 +6,12 @@ class IO
         f.read(*arg)
       end
     end unless method_defined? :binread
+
+    def try_convert(obj)
+      return nil unless obj.respond_to?(:to_io)
+      Backports.coerce_to(obj, IO, :to_io)
+    end unless method_defined? :try_convert
   end
+
+  Backports.alias_method self, :ungetbyte, :ungetc
 end

data/lib/backports/1.9.1/proc.rb

@@ -49,4 +49,6 @@ class Proc
       end
     end
   end unless method_defined? :curry
+
+  alias_method :===, :call unless Proc.new{true} === 42
 end

data/lib/backports/1.9.1/string.rb

@@ -1,5 +1,13 @@
 class String
 
+  class << self
+    # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
+    def try_convert(x)
+      return nil unless x.respond_do(:to_str)
+      x.to_str
+    end unless method_defined? :try_convert
+  end
+
   # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
   def ascii_only?
     !(self =~ /[^\x00-\x7f]/)
@@ -17,9 +25,26 @@ class String
   end unless method_defined? :clear
 
   # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
-  public :codepoints  # Definition in 1.8.8/string.rb
+  def codepoints
+    return to_enum(:codepoints) unless block_given?
+    each_char do |s|
+      utf8 = s.each_byte.to_a
+      utf8[0] &= 0xff >> utf8.size # clear high bits (1 to 4, depending of number of bytes used)
+      yield utf8.inject{|result, b| (result << 6) + (b & 0x3f) }
+    end
+  end unless method_defined? :codepoints
 
   # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
   Backports.alias_method self, :each_codepoint, :codepoints
 
-end
+  # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
+  def ord
+    codepoints.first or raise ArgumentError, "empty string"
+  end unless method_defined? :ord
+
+  # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
+  Backports.alias_method self, :getbyte, :[]
+
+  # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
+  Backports.alias_method self, :setbyte, :[]=
+end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: backports
 version: !ruby/object:Gem::Version 
-  hash: 11
-  prerelease: 
+  hash: 7
+  prerelease: false
   segments: 
   - 2
-  - 1
+  - 2
   - 0
-  version: 2.1.0
+  version: 2.2.0
 platform: ruby
 authors: 
 - "Marc-Andr\xC3\xA9 Lafortune"
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-04-16 00:00:00 -04:00
+date: 2011-05-13 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -65,25 +65,22 @@ files:
 - lib/backports/1.8.7/struct.rb
 - lib/backports/1.8.7/symbol.rb
 - lib/backports/1.8.8.rb
-- lib/backports/1.8.8/array.rb
-- lib/backports/1.8.8/enumerable.rb
-- lib/backports/1.8.8/enumerator.rb
-- lib/backports/1.8.8/env.rb
-- lib/backports/1.8.8/hash.rb
-- lib/backports/1.8.8/io.rb
-- lib/backports/1.8.8/proc.rb
-- lib/backports/1.8.8/range.rb
-- lib/backports/1.8.8/regexp.rb
-- lib/backports/1.8.8/string.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
@@ -163,7 +160,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: backports
-rubygems_version: 1.6.0
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Backports of Ruby 1.8.7+ for older ruby.

data/lib/backports/1.8.8/io.rb

@@ -1,11 +0,0 @@
-class IO
-  # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/IO.html]
-  class << self
-    def try_convert(obj)
-      return nil unless obj.respond_to?(:to_io)
-      Backports.coerce_to(obj, IO, :to_io)
-    end unless method_defined? :try_convert
-  end
-
-  Backports.alias_method self, :ungetbyte, :ungetc
-end

data/lib/backports/1.8.8/proc.rb

@@ -1,3 +0,0 @@
-class Proc
-  alias_method :===, :call unless Proc.new{true} === 42
-end

data/lib/backports/1.8.8/string.rb

@@ -1,33 +0,0 @@
-class String
-  class << self
-    # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
-    def try_convert(x)
-      return nil unless x.respond_do(:to_str)
-      x.to_str
-    end unless method_defined? :try_convert
-  end
-
-  # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
-  Backports.alias_method self, :getbyte, :[]
-
-  # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
-  Backports.alias_method self, :setbyte, :[]=
-
-  # Let's define this here, we can use it for ord:
-  unless method_defined? :codepoints
-    def codepoints
-      return to_enum(:codepoints) unless block_given?
-      each_char do |s|
-        utf8 = s.each_byte.to_a
-        utf8[0] &= 0xff >> utf8.size # clear high bits (1 to 4, depending of number of bytes used)
-        yield utf8.inject{|result, b| (result << 6) + (b & 0x3f) }
-      end
-    end
-    private :codepoints # Will be made available in 1.9.1/string.rb, if included
-  end
-
-  # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
-  def ord
-    codepoints.first
-  end unless method_defined? :ord
-end