backports 1.11.2 → 1.12.0

data/CHANGELOG.rdoc

@@ -1,5 +1,15 @@
 = Packable --- History
 
+== Version 1.12.0 - December 4th, 2009
+
+* Finer grain includes (see README)
+  require "backports/1.9"    # requires all ruby backports
+  require "backports/1.9.1"  # requires all ruby backports up to 1.9.1 (but not 1.9.2)
+
+* Backported all builtin methods of 1.8.8 (most of which where moved from the 1.9 backports)
+
+* Refreshed README
+
 == Version 1.11.0 - November 4th, 2009
 
 * Added Enumerable#flat_map / collect_concat (Ruby 1.9)

data/README.rdoc

@@ -1,84 +1,76 @@
 = Backports Library
 
-Would you like to use features of Ruby 1.8.7 without the need of having 1.8.7 installed? Simply
+Can't remember if you can use Array#sample? One of your client is stuck with Ruby 1.8.6 but you want to use a gem using some features of 1.8.7? This gem is for you!
 
-  require 'backports/1.8.7'
+The goal of 'backports' is to make it easier to write ruby code that runs across different versions of Ruby. All you need to bring any version of Ruby up to today's standards:
 
-All 1.8.7 features are now available! Many of the features of 1.9 are also available with
-
-  require 'backports/1.9'
-
-Finally, some features of rails' active-support are also available with
-
-  require 'backports/rails'
+  require 'backports'
   
-If you want them all:
+Actually, it's tomorrow's standard, since 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 the upcoming Ruby 1.9.2!
 
-  require 'backports'
++Note+: Although I am a Ruby committer, this gem is a personal project and is not endorsed by ruby-core.
 
 == What's inside
 
-All features of 1.8.7 are backported (well, almost all, see the exception list bellow).
-
-Conditions for inclusion of ruby 1.9 and activesupport features:
+Features in this gem:
 1. Won't break older code
-2. Simple and self-contained
+2. Pure Ruby (no C extensions)
+3. Pass RubySpec[http://github.com/rubyspec/rubyspec]
+
+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.
 
-For example, <tt>Module::instance_methods</tt> returns strings in 1.8 and symbols in 1.9; no change can be made without the risk of breaking existing code. Such incompatibilities between 1.8 and 1.9 methods 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.
 
-More complex features of active-support (even things like <tt>String::pluralize</tt>), won't be included. <tt>require 'activesupport'</tt> if you need them and are not in rails!
+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.
+
+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.
 
 == Installation & compatibility
 
-+backports+ is mirrored on Rubyforge and can thus be installed with:
++backports+ is can be installed with:
 
-  sudo gem install backports
+  (sudo) gem install backports
 
 To use:
 
   require 'rubygems'
-  require 'backports'   # or a subset like "backports/1.8.7"
-  # and off you go!
+  require 'backports'   # or a subset, see next section
 
-Compatible with Ruby 1.8 & 1.9, jruby and rubinius.
+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
 
 = Complete List of backports
 
 == Ruby 1.8.7
 
-Complete Ruby 1.8.7 backporting (core language). Refer to the official list of changes[http://svn.ruby-lang.org/repos/ruby/tags/v1_8_7/NEWS].
+Complete Ruby 1.8.7 backporting (core language). Refer to the official list of changes[http://svn.ruby-lang.org/repos/ruby/branches/ruby_1_8_7/NEWS].
 
 Only exceptions:
-* String#gsub
-* GC.stress=
-* Array#choice (use Array#sample instead)
-* recursive data handling (Array, Hash, ...)
+* String#gsub (the form returning an enumerator)
+* GC.stress=  (not implemented)
+* Array#choice (removed in 1.8.8, use Array#sample instead)
 
-Libraries have not been backported. See at the end for list of known library backports
+To include _only_ these backports, <tt>require "backports/1.8.7"</tt>
 
-== Ruby 1.9
+== Ruby 1.8.8
 
-Additionally, the following Ruby 1.9 have been backported:
+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].
 
-* Array
-  * +try_convert+
+Only exception:
+* Enumerator#rewind (incompatible change, so won't be implemented)
 
-* Enumerable
-  * +each_with_object+
-  * +chunk+
+To include _only_ these backports and those preceeding, <tt>require "backports/1.8.8"</tt>.
 
-* Enumerator
-  * +new+ (with block)
-  * +flat_map+, +collect_concat+
+== Ruby 1.9.1
+
+Additionally, the following Ruby 1.9 features have been backported:
 
 * File
   * +binread+
   * +to_path+
   * All class methods accepting filenames will accept files or anything with a #to_path method.
 
-* Hash
-  * +try_convert+
-  * <tt>default_proc=</tt>
+* IO
+  * +bin_read+
 
 * Kernel
   * +require_relative+
@@ -87,13 +79,11 @@ Additionally, the following Ruby 1.9 have been backported:
   * +define_singleton_method+
   * +public_method+
   * +public_send+
-  * <tt>respond_to_missing?</tt>
 
 * Proc
   * +yield+
 
 * String
-  * +try_convert+
   * <tt>ascii_only?</tt>
   * +chr+
   * +clear+
@@ -101,11 +91,26 @@ Additionally, the following Ruby 1.9 have been backported:
 
 +Enumerator+ can be accessed directly (instead of <tt>Enumerable::Enumerator</tt>)
 
+To include _only_ these backports and those of the 1.8 line, <tt>require "backports/1.9.1"</tt>.
+
 Moreover, a pretty good imitation of BasicObject is available,
 but since it is only an imitation, it must be required explicitly:
 
   require 'backports/basic_object'
 
+== Ruby 1.9.2
+
+  Finally, some Ruby 1.9.2 features have been backported. As this version has not been feature frozen yet, changes are still possible.
+
+* Enumerable
+  * +flat_map+, +collect_concat+
+  * +chunk+
+
+* Object
+  * <tt>respond_to_missing?</tt>
+
+To include all Ruby backports but not those of Rails, <tt>require "backports/1.9.2"</tt>.
+
 == Rails
 
 Some generic methods from Rails methods have been copied:
@@ -129,9 +134,11 @@ Some generic methods from Rails methods have been copied:
   * +dasherize+, +demodulize+
   * +constantize+
 
+To include _only_ these Rails backports but not those of Ruby, <tt>require "backports/rails"</tt>.
+
 == Libraries
 
-Libraries have not been backported. I am aware of following the backport gems:
+Libraries have not been backported. I am aware of the following backport gems:
 
 * Net::SMTP for Ruby 1.8.6: smtp_tls[http://seattlerb.rubyforge.org/smtp_tls/]
 

data/Rakefile

@@ -6,12 +6,10 @@ begin
   require 'jeweler'
   Jeweler::Tasks.new do |gem|
     gem.name = "backports"
-    gem.summary = "Backports or ruby 1.8.7+ & rails for older ruby."
+    gem.summary = "Backports of Ruby 1.8.7+ for older ruby."
     gem.email = "github@marc-andre.ca"
     gem.homepage = "http://github.com/marcandre/backports"
     gem.authors = ["Marc-André Lafortune"]
-    gem.rubyforge_project = "backports"
-  
     gem.description = <<-EOS
       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.
     EOS
@@ -21,11 +19,9 @@ begin
                            '--line-numbers' << '--inline-source'
 
     # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+    gem.rubyforge_project = "backports"
     Jeweler::GemcutterTasks.new
   end
-  Jeweler::RubyforgeTasks.new do |rubyforge|
-    rubyforge.doc_task = "rdoc"
-  end
 rescue LoadError
   puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
 end

data/VERSION.yml

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

data/backports.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{backports}
-  s.version = "1.11.2"
+  s.version = "1.12.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{2009-12-01}
+  s.date = %q{2009-12-05}
   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}
@@ -53,19 +53,30 @@ Gem::Specification.new do |s|
      "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.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/dir.rb",
+     "lib/backports/1.9.1/file.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/string.rb",
+     "lib/backports/1.9.1/symbol.rb",
+     "lib/backports/1.9.2.rb",
+     "lib/backports/1.9.2/enumerable.rb",
+     "lib/backports/1.9.2/method.rb",
      "lib/backports/1.9.rb",
-     "lib/backports/1.9/array.rb",
-     "lib/backports/1.9/dir.rb",
-     "lib/backports/1.9/enumerable.rb",
-     "lib/backports/1.9/enumerator.rb",
-     "lib/backports/1.9/file.rb",
-     "lib/backports/1.9/hash.rb",
-     "lib/backports/1.9/integer.rb",
-     "lib/backports/1.9/io.rb",
-     "lib/backports/1.9/kernel.rb",
-     "lib/backports/1.9/method.rb",
-     "lib/backports/1.9/string.rb",
-     "lib/backports/1.9/symbol.rb",
      "lib/backports/basic_object.rb",
      "lib/backports/rails.rb",
      "lib/backports/rails/array.rb",
@@ -96,7 +107,7 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
   s.rubyforge_project = %q{backports}
   s.rubygems_version = %q{1.3.5}
-  s.summary = %q{Backports or ruby 1.8.7+ & rails for older ruby.}
+  s.summary = %q{Backports of Ruby 1.8.7+ for older ruby.}
   s.test_files = [
     "test/array_test.rb",
      "test/basic_object_test.rb",

data/lib/backports.rb

@@ -1,4 +1,3 @@
 require File.expand_path(File.dirname(__FILE__) + "/backports/tools")
-Backports.require_relative "backports/1.8.7"
 Backports.require_relative "backports/1.9"
-Backports.require_relative "backports/rails"
+Backports.require_relative "backports/rails"

data/lib/backports/1.8.7.rb

@@ -1,4 +1,4 @@
+# require this file to load all the backports of Ruby 1.8.7
+
 require File.expand_path(File.dirname(__FILE__) + "/tools")
-%w(module kernel array enumerable enumerator string symbol integer numeric fixnum hash proc binding dir io method range regexp struct float object_space argf gc env process).each do |lib|
-  Backports.require_relative "1.8.7/#{lib}"
-end
+Backports.require_relative_dir "1.8.7"

data/lib/backports/1.8.7/array.rb

@@ -134,6 +134,7 @@ class Array
   end
 
   # Standard in Ruby 1.8.7+. See official documentation[http://ruby-doc.org/core-1.9/classes/Array.html]
+  # Note: was named #choice in 1.8.7 and renamed in later versions
   def sample(n = Backports::Undefined)
     return self[rand(size)] if n == Backports::Undefined
     n = Backports.coerce_to(n, Fixnum, :to_int)

data/lib/backports/1.8.7/kernel.rb

@@ -12,7 +12,7 @@ module Kernel
   end unless method_defined? :instance_exec
 
   # Loop. Standard in ruby 1.8.7+. See official documentation[http://ruby-doc.org/core-1.9/classes/Object.html]
-  unless Object.const_defined? :StopIteration
+  unless const_defined? :StopIteration
     class StopIteration < IndexError; end
 
     def loop_with_stop_iteration(&block)

data/lib/backports/1.8.8.rb

@@ -0,0 +1,5 @@
+# require this file to load all the backports up to Ruby 1.8.8
+
+require File.expand_path(File.dirname(__FILE__) + "/tools")
+Backports.require_relative "1.8.7"
+Backports.require_relative_dir "1.8.8"

data/lib/backports/1.8.8/array.rb

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

data/lib/backports/1.8.8/enumerable.rb

@@ -0,0 +1,8 @@
+module Enumerable
+  # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
+  def each_with_object(memo, &block)
+    return to_enum(:each_with_object, memo) unless block_given?
+    each {|obj| block.call(obj, memo)}
+    memo
+  end unless method_defined? :each_with_object
+end

data/lib/backports/{1.9 → 1.8.8}/enumerator.rb

@@ -1,5 +1,5 @@
 # Must be defined outside of Kernel for jruby, see http://jira.codehaus.org/browse/JRUBY-3609
-Enumerator = Enumerable::Enumerator unless Kernel.const_defined? :Enumerator # Standard in ruby 1.9
+Enumerator = Enumerable::Enumerator unless Object.const_defined? :Enumerator # Standard in ruby 1.9
 
 class Enumerator
   # new with block, standard in Ruby 1.9

data/lib/backports/1.8.8/env.rb

@@ -0,0 +1,3 @@
+class << ENV
+  alias_method :key, :index unless method_defined? :key
+end

data/lib/backports/{1.9 → 1.8.8}/hash.rb

@@ -1,13 +1,12 @@
 class Hash
-  # New Ruby 1.8.7+ constructor -- not documented, see redmine # 1385
-  # <tt>Hash[[[:foo, :bar],[:hello, "world"]]] ==> {:foo => :bar, :hello => "world"}</tt>
+  # 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
     end unless method_defined? :try_convert
   end
-  
+
   # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Hash.html]
   def default_proc=(proc)
     replace(Hash.new(&Backports.coerce_to(proc, Proc, :to_proc)).merge!(self))

data/lib/backports/1.8.8/io.rb

@@ -0,0 +1,11 @@
+class IO
+  # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/IO.html]
+  class << self
+    def self.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
+
+  alias_method :ungetbyte, :ungetc unless method_defined? :ungetbyte
+end

data/lib/backports/1.8.8/proc.rb

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

data/lib/backports/1.8.8/range.rb

@@ -0,0 +1,3 @@
+class Range
+  alias_method :cover?, :include? unless method_defined? :cover?
+end

data/lib/backports/1.8.8/regexp.rb

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

data/lib/backports/1.8.8/string.rb

@@ -0,0 +1,33 @@
+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]
+  alias_method :getbyte, :[] unless method_defined? :getbyte
+
+  # Standard in Ruby 1.8.8. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
+  alias_method :setbyte, :[]= unless method_defined? :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

data/lib/backports/1.8.rb

@@ -0,0 +1,4 @@
+# require this file to load all the backports of the Ruby 1.8.x line
+
+require File.expand_path(File.dirname(__FILE__) + "/tools")
+Backports.require_relative "1.8.8"

data/lib/backports/1.9.1.rb

@@ -0,0 +1,5 @@
+# require this file to load all the backports up to Ruby 1.9.1 (including all of 1.8.8 and below)
+
+require File.expand_path(File.dirname(__FILE__) + "/tools")
+Backports.require_relative "1.8"
+Backports.require_relative_dir "1.9.1"

data/lib/backports/{1.9 → 1.9.1}/kernel.rb

@@ -11,9 +11,9 @@ module Kernel
   # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Object.html]
   def require_relative(relative_feature)
     file = caller.first.split(/:\d/,2).first
-    if /\A\((.*)\)/ =~ file # eval, etc. 
-      raise LoadError, "require_relative is called in #{$1}" 
-    end 
+    if /\A\((.*)\)/ =~ file # eval, etc.
+      raise LoadError, "require_relative is called in #{$1}"
+    end
     require File.expand_path(relative_feature, File.dirname(file))
   end unless method_defined? :require_relative
   private :require_relative

data/lib/backports/1.9.1/string.rb

@@ -0,0 +1,20 @@
+class String
+
+  # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
+  def ascii_only?
+    !(self =~ /[^\x00-\x7f]/)
+  end unless method_defined? :ascii_only?
+
+  # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
+  def clear
+    self[0,length] = ""
+    self
+  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
+
+  # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
+  alias_method :each_codepoint, :codepoints unless method_defined? :each_codepoint
+
+end

data/lib/backports/{1.9 → 1.9.1}/symbol.rb

@@ -28,5 +28,5 @@ class Symbol
     include Comparable
     alias_method :==,  :dont_override_equal_please
   end
-    
+  
 end

data/lib/backports/1.9.2.rb

@@ -0,0 +1,5 @@
+# require this file to load all the backports up to Ruby 1.9.2
+
+require File.expand_path(File.dirname(__FILE__) + "/tools")
+Backports.require_relative "1.9.1"
+Backports.require_relative_dir "1.9.2"

data/lib/backports/{1.9 → 1.9.2}/enumerable.rb

@@ -1,11 +1,4 @@
 module Enumerable
-  # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
-  def each_with_object(memo, &block)
-    return to_enum(:each_with_object, memo) unless block_given?
-    each {|obj| block.call(obj, memo)}
-    memo
-  end unless method_defined? :each_with_object
-
   # Standard in Ruby 1.9.2 See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
   def chunk(initial_state = nil, &original_block)
     raise ArgumentError, "no block given" unless block_given?

data/lib/backports/{1.9 → 1.9.2}/method.rb

@@ -1,4 +1,4 @@
-# Standard in Ruby 1.9.2. How do you call the backport of a future feature?
+# Standard in Ruby 1.9.2.
 unless Kernel.method_defined? :respond_to_missing?
   module MissingMethod
     attr_reader :name

data/lib/backports/1.9.rb

@@ -1,5 +1,4 @@
+# require this file to load all the backports of Ruby
+
 require File.expand_path(File.dirname(__FILE__) + "/tools")
-Backports.require_relative "1.8.7"
-%w(array dir enumerable enumerator hash file integer io kernel method string symbol).each do |lib|
-  Backports.require_relative "1.9/#{lib}"
-end
+Backports.require_relative "1.9.2"

data/lib/backports/basic_object.rb

@@ -49,4 +49,4 @@ class BasicObject
       end
     end
   end
-end unless Kernel.const_defined? :BasicObject
+end unless Kernel.const_defined? :BasicObject

data/lib/backports/rails.rb

@@ -1,4 +1,4 @@
 require File.expand_path(File.dirname(__FILE__) + "/tools")
 %w(array enumerable hash kernel module string).each do |lib|
   Backports.require_relative "rails/#{lib}"
-end
+end

data/lib/backports/tools.rb

@@ -10,6 +10,17 @@ module Backports
     require File.expand_path(relative_feature, File.dirname(file))
   end
 
+  def self.require_relative_dir(relative_dir)
+    dir = File.expand_path(relative_dir, File.dirname(caller.first.split(/:\d/,2).first))
+    Dir.entries(dir).
+        map{|f| Regexp.last_match(1) if /^(.*)\.rb$/ =~ f}.
+        compact.
+        sort.
+        each do |f|
+          require File.expand_path(f, dir)
+        end
+  end
+
   # Metaprogramming utility to make block optional.
   # Tests first if block is already optional when given options
   def self.make_block_optional mod,*methods
@@ -163,4 +174,4 @@ module Backports
       @final_block.yield(*arg)
     end
   end
-end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: backports
 version: !ruby/object:Gem::Version 
-  version: 1.11.2
+  version: 1.12.0
 platform: ruby
 authors: 
 - "Marc-Andr\xC3\xA9 Lafortune"
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-01 00:00:00 -05:00
+date: 2009-12-05 00:00:00 -05:00
 default_executable: 
 dependencies: []
 
@@ -58,19 +58,30 @@ files:
 - 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.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/dir.rb
+- lib/backports/1.9.1/file.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/string.rb
+- lib/backports/1.9.1/symbol.rb
+- lib/backports/1.9.2.rb
+- lib/backports/1.9.2/enumerable.rb
+- lib/backports/1.9.2/method.rb
 - lib/backports/1.9.rb
-- lib/backports/1.9/array.rb
-- lib/backports/1.9/dir.rb
-- lib/backports/1.9/enumerable.rb
-- lib/backports/1.9/enumerator.rb
-- lib/backports/1.9/file.rb
-- lib/backports/1.9/hash.rb
-- lib/backports/1.9/integer.rb
-- lib/backports/1.9/io.rb
-- lib/backports/1.9/kernel.rb
-- lib/backports/1.9/method.rb
-- lib/backports/1.9/string.rb
-- lib/backports/1.9/symbol.rb
 - lib/backports/basic_object.rb
 - lib/backports/rails.rb
 - lib/backports/rails/array.rb
@@ -128,7 +139,7 @@ rubyforge_project: backports
 rubygems_version: 1.3.5
 signing_key: 
 specification_version: 3
-summary: Backports or ruby 1.8.7+ & rails for older ruby.
+summary: Backports of Ruby 1.8.7+ for older ruby.
 test_files: 
 - test/array_test.rb
 - test/basic_object_test.rb

data/lib/backports/1.9/array.rb

@@ -1,12 +0,0 @@
-class Array
-  # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Array.html]
-  class << self
-    # Try to convert obj into an array, using to_ary method.
-    # Returns converted array or nil if obj cannot be converted
-    # for any reason. This method is to check if an argument is an array.
-    def try_convert(obj)
-      return nil unless obj.respond_to?(:to_ary)
-      Backports.coerce_to(obj, Array, :to_ary)
-    end unless method_defined? :try_convert
-  end
-end

data/lib/backports/1.9/string.rb

@@ -1,39 +0,0 @@
-class String
-  class << self
-    # Standard in Ruby 1.9. 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]/)
-  end unless method_defined? :ascii_only?
-
-  # Standard in Ruby 1.8.7+. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
-  def clear
-    self[0,length] = ""
-    self
-  end unless method_defined? :clear
-
-  # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
-  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]
-  alias_method :each_codepoint, :codepoints unless method_defined? :each_codepoint
-
-  # Standard in Ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
-  def getbyte(i)
-    self[i]
-  end unless method_defined? :getbyte
-  
-end