backports 3.0.3 → 3.1.0

data/lib/backports/1.8.7/string/bytes.rb

@@ -0,0 +1 @@
+require 'backports/1.8.7/string/each_byte'

data/lib/backports/1.8.7/string/bytesize.rb

@@ -0,0 +1,3 @@
+require 'backports/tools'
+
+Backports.alias_method String, :bytesize, :length

data/lib/backports/1.8.7/string/each.rb

@@ -0,0 +1,3 @@
+require 'backports/tools'
+
+Backports.make_block_optional String, :each, :test_on => "abc" if "is there still an each?".respond_to? :each

data/lib/backports/1.8.7/string/each_byte.rb

@@ -0,0 +1,5 @@
+require 'backports/tools'
+
+Backports.make_block_optional String, :each_byte, :test_on => "abc"
+
+Backports.alias_method String, :bytes, :each_byte

data/lib/backports/1.8.7/string/each_char.rb

@@ -0,0 +1,13 @@
+unless String.method_defined? :each_char
+  require 'backports/tools'
+  require 'enumerator'
+
+  class String
+    def each_char
+      return to_enum(:each_char) unless block_given?
+      scan(/./m) {|c| yield c}
+    end
+
+    Backports.alias_method self, :chars, :each_char
+  end
+end

data/lib/backports/1.8.7/string/each_line.rb

@@ -0,0 +1,5 @@
+require 'backports/tools'
+
+Backports.make_block_optional String, :each_line, :test_on => "abc"
+
+Backports.alias_method String, :lines, :each_line

data/lib/backports/1.8.7/string/end_with.rb

@@ -0,0 +1,12 @@
+unless String.method_defined? :end_with?
+  class String
+    def end_with?(*suffixes)
+      suffixes.any? do |suffix|
+        if suffix.respond_to? :to_str
+          suffix = suffix.to_str
+          self[-suffix.length, suffix.length] == suffix
+        end
+      end
+    end
+  end
+end

data/lib/backports/1.8.7/string/lines.rb

@@ -0,0 +1 @@
+require 'backports/1.8.7/string/each_line'

data/lib/backports/1.8.7/string/partition.rb

@@ -0,0 +1,20 @@
+unless ("check partition".partition(" ") rescue false)
+  require 'backports/tools'
+
+  class String
+    def partition_with_new_meaning(pattern = Backports::Undefined)
+      return partition_without_new_meaning{|c| yield c} if pattern == Backports::Undefined
+      pattern = Backports.coerce_to(pattern, String, :to_str) unless pattern.is_a? Regexp
+      i = index(pattern)
+      return [self, "", ""] unless i
+      if pattern.is_a? Regexp
+        match = Regexp.last_match
+        [match.pre_match, match[0], match.post_match]
+      else
+        last = i+pattern.length
+        [self[0...i], self[i...last], self[last...length]]
+      end
+    end
+    Backports.alias_method_chain self, :partition, :new_meaning
+  end
+end

data/lib/backports/1.8.7/string/rpartition.rb

@@ -0,0 +1,19 @@
+unless String.method_defined? :rpartition
+  require 'backports/tools'
+
+  class String
+    def rpartition(pattern)
+      pattern = Backports.coerce_to(pattern, String, :to_str) unless pattern.is_a? Regexp
+      i = rindex(pattern)
+      return ["", "", self] unless i
+
+      if pattern.is_a? Regexp
+        match = Regexp.last_match
+        [match.pre_match, match[0], match.post_match]
+      else
+        last = i+pattern.length
+        [self[0...i], self[i...last], self[last...length]]
+      end
+    end
+  end
+end

data/lib/backports/1.8.7/string/start_with.rb

@@ -0,0 +1,12 @@
+unless String.method_defined? :start_with?
+  class String
+    def start_with?(*prefixes)
+      prefixes.any? do |prefix|
+        if prefix.respond_to? :to_str
+          prefix = prefix.to_str
+          self[0, prefix.length] == prefix
+        end
+      end
+    end
+  end
+end

data/lib/backports/1.8.7/string/upto.rb

@@ -0,0 +1,15 @@
+unless ("abc".upto("def", true){} rescue false)
+  require 'backports/tools'
+  require 'enumerator'
+
+  class String
+    def upto_with_exclusive(to, excl=false)
+      return upto_without_exclusive(to){|s| yield s} if block_given? && !excl
+      r = Range.new(self, to, excl)
+      return r.to_enum unless block_given?
+      r.each{|s| yield s}
+      self
+    end
+    Backports.alias_method_chain self, :upto, :exclusive
+  end
+end

data/lib/backports/1.8.7/struct.rb

@@ -1,3 +1,3 @@
-class Struct
-  Backports.make_block_optional self, :each, :each_pair, :test_on => Struct.new(:foo, :bar).new
-end
+require 'backports/tools'
+
+Backports.require_relative_dir

data/lib/backports/1.8.7/struct/each.rb

@@ -0,0 +1,3 @@
+require 'backports/tools'
+
+Backports.make_block_optional Struct, :each, :test_on => Struct.new(:foo, :bar).new

data/lib/backports/1.8.7/struct/each_pair.rb

@@ -0,0 +1,3 @@
+require 'backports/tools'
+
+Backports.make_block_optional Struct, :each_pair, :test_on => Struct.new(:foo, :bar).new

data/lib/backports/1.8.7/symbol.rb

@@ -1,6 +1,3 @@
-class Symbol
-  # Standard in ruby 1.8.7+. See official documentation[http://ruby-doc.org/core-1.9/classes/Symbol.html]
-  def to_proc
-    Proc.new { |*args| args.shift.__send__(self, *args) }
-  end unless :to_proc.respond_to?(:to_proc)
-end
+require 'backports/tools'
+
+Backports.require_relative_dir

data/lib/backports/1.8.7/symbol/to_proc.rb

@@ -0,0 +1,8 @@
+unless Symbol.method_defined? :to_proc
+  class Symbol
+    # Standard in ruby 1.8.7+. See official documentation[http://ruby-doc.org/core-1.9/classes/Symbol.html]
+    def to_proc
+      Proc.new { |*args| args.shift.__send__(self, *args) }
+    end
+  end
+end

data/lib/backports/1.8.8.rb

@@ -1,4 +1,2 @@
 # 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"
+require 'backports/1.8.7'

data/lib/backports/1.8.rb

@@ -1,4 +1,2 @@
 # 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"
+require 'backports/1.8.7'

data/lib/backports/1.9.1.rb

@@ -1,5 +1,3 @@
 # 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"
+require 'backports/1.8'
+Backports.require_relative_dir

data/lib/backports/1.9.1/array.rb

@@ -1,8 +1,3 @@
-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)
-      Backports.try_convert(obj, Array, :to_ary)
-    end unless method_defined? :try_convert
-  end
-end
+require 'backports/tools'
+
+Backports.require_relative_dir

data/lib/backports/1.9.1/array/sample.rb

@@ -0,0 +1,19 @@
+unless Array.method_defined? :sample
+  require 'backports/tools'
+
+  class Array
+    def sample(n = Backports::Undefined)
+      return self[Kernel.rand(size)] if n == Backports::Undefined
+      n = Backports.coerce_to_int(n)
+      raise ArgumentError, "negative array size" if n < 0
+      n = size if n > size
+      result = Array.new(self)
+      n.times do |i|
+        r = i + Kernel.rand(size - i)
+        result[i], result[r] = result[r], result[i]
+      end
+      result[n..size] = []
+      result
+    end
+  end
+end

data/lib/backports/1.9.1/array/try_convert.rb

@@ -0,0 +1,7 @@
+unless Array.respond_to? :try_convert
+  require 'backports/tools'
+
+  def Array.try_convert(obj)
+    Backports.try_convert(obj, Array, :to_ary)
+  end
+end

data/lib/backports/1.9.1/dir.rb

@@ -1,3 +1,3 @@
-class Dir
-  Backports.alias_method self, :to_path, :path
-end
+require 'backports/tools'
+
+Backports.require_relative_dir

data/lib/backports/1.9.1/dir/to_path.rb

@@ -0,0 +1,3 @@
+require 'backports/tools'
+
+Backports.alias_method Dir, :to_path, :path

data/lib/backports/1.9.1/enumerable.rb

@@ -1,19 +1,3 @@
-module Enumerable
-  # Standard in Ruby 1.9.1. See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
-  def each_with_object(memo)
-    return to_enum(:each_with_object, memo) unless block_given?
-    each {|obj| yield obj, memo}
-    memo
-  end unless method_defined? :each_with_object
+require 'backports/tools'
 
-  # Standard in Ruby 1.9.1. See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
-  if instance_method(:each_with_index).arity.zero?
-    def each_with_index_with_optional_args_and_block(*args)
-      return to_enum(:each_with_index, *args) unless block_given?
-      idx = 0
-      each(*args) { |o| yield(o, idx); idx += 1 }
-      self
-    end
-    Backports.alias_method_chain self, :each_with_index, :optional_args_and_block
-  end
-end
+Backports.require_relative_dir

data/lib/backports/1.9.1/enumerable/each_with_index.rb

@@ -0,0 +1,14 @@
+if Enumerable.instance_method(:each_with_index).arity.zero?
+  require 'backports/tools'
+  require 'enumerator'
+
+  module Enumerable
+    def each_with_index_with_optional_args_and_block(*args)
+      return to_enum(:each_with_index, *args) unless block_given?
+      idx = 0
+      each(*args) { |o| yield(o, idx); idx += 1 }
+      self
+    end
+    Backports.alias_method_chain self, :each_with_index, :optional_args_and_block
+  end
+end

data/lib/backports/1.9.1/enumerable/each_with_object.rb

@@ -0,0 +1,9 @@
+unless Enumerable.method_defined? :each_with_object
+  module Enumerable
+    def each_with_object(memo)
+      return to_enum(:each_with_object, memo) unless block_given?
+      each {|obj| yield obj, memo}
+      memo
+    end
+  end
+end

data/lib/backports/1.9.1/enumerator.rb

@@ -1,41 +1,3 @@
-# Must be defined outside of Kernel for jruby, see http://jira.codehaus.org/browse/JRUBY-3609
-Enumerator = Enumerable::Enumerator unless Object.const_defined? :Enumerator # Standard in ruby 1.9
+require 'backports/tools'
 
-class Enumerator
-  # new with block, standard in Ruby 1.9
-  unless (self.new{} rescue false)
-      # A simple class which allows the construction of Enumerator from a block
-    class Yielder
-      def initialize(&block)
-        @final_block = block
-      end
-
-      def yield(*arg)
-        @final_block.yield(*arg)
-      end
-
-      def <<(*arg)
-        @final_block.yield(*arg)
-        self
-      end
-    end
-
-    class GeneratorBP # Avoid conflict with 1.8's ::Generator class
-      def initialize(&block)
-        @main_block = block
-      end
-
-      def each(&block)
-        @main_block.call(Yielder.new(&block))
-      end
-    end
-
-    def initialize_with_optional_block(*arg, &block)
-      return initialize_without_optional_block(*arg, &nil) unless arg.empty?  # Ruby 1.9 apparently ignores the block if any argument is present
-      initialize_without_optional_block(GeneratorBP.new(&block))
-    end
-    Backports.alias_method_chain self, :initialize, :optional_block
-  end
-
-  Backports.alias_method self, :with_object, :each_with_object
-end
+Backports.require_relative_dir

data/lib/backports/1.9.1/enumerator/new.rb

@@ -0,0 +1,40 @@
+Enumerator = Enumerable::Enumerator unless Object.const_defined? :Enumerator # Standard in ruby 1.9
+
+unless (Enumerator.new{} rescue false)
+  require 'backports/tools'
+  # new with block, standard in Ruby 1.9
+
+  class Enumerator
+      # A simple class which allows the construction of Enumerator from a block
+    class Yielder
+      def initialize(&block)
+        @final_block = block
+      end
+
+      def yield(*arg)
+        @final_block.call(*arg)
+      end
+
+      def <<(*arg)
+        @final_block.call(*arg)
+        self
+      end
+    end
+
+    class GeneratorBP # Avoid conflict with 1.8's ::Generator class
+      def initialize(&block)
+        @main_block = block
+      end
+
+      def each(&block)
+        @main_block.call(Yielder.new(&block))
+      end
+    end
+
+    def initialize_with_optional_block(*arg, &block)
+      return initialize_without_optional_block(*arg, &nil) unless arg.empty?  # Ruby 1.9 apparently ignores the block if any argument is present
+      initialize_without_optional_block(GeneratorBP.new(&block))
+    end
+    Backports.alias_method_chain self, :initialize, :optional_block
+  end
+end

data/lib/backports/1.9.1/enumerator/with_object.rb

@@ -0,0 +1,6 @@
+require 'backports/tools'
+require 'backports/1.9.1/enumerable/each_with_object'
+
+Enumerator = Enumerable::Enumerator unless Object.const_defined? :Enumerator # Standard in ruby 1.9
+
+Backports.alias_method Enumerator, :with_object, :each_with_object

data/lib/backports/1.9.1/env.rb

@@ -1,3 +1,3 @@
-class << ENV
-  Backports.alias_method self, :key, :index
-end
+require 'backports/tools'
+
+Backports.require_relative_dir

data/lib/backports/1.9.1/env/key.rb

@@ -0,0 +1,5 @@
+require 'backports/tools'
+
+class << ENV
+  Backports.alias_method self, :key, :index
+end

data/lib/backports/1.9.1/file.rb

@@ -1,44 +1,3 @@
-class File
-  def size
-    stat.size
-  end unless method_defined? :size
+require 'backports/tools'
 
-  Backports.alias_method self, :to_path, :path
-
-  class << self
-    if RUBY_VERSION < '1.9' # can't see any other reasonable way to test than this
-      Backports.convert_all_arguments_to_path self, 0, :delete, :unlink, :join
-      Backports.convert_all_arguments_to_path self, 1, :chmod, :lchmod
-      Backports.convert_all_arguments_to_path self, 2, :chown, :lchown
-
-      Backports.convert_first_argument_to_path self, :atime, :basename,
-        :blockdev?, :chardev?, :ctime, :directory?, :dirname, :executable?, :executable_real?,
-        :exist?, :exists?, :expand_path, :extname, :file?, :ftype, :grpowned?,
-        :link, :lstat, :mtime, :new, :open, :owned?, :pipe?, :readable?, :readable_real?,
-        :readlink, :rename, :setgid?, :setuid?, :size, :size?, :socket?,
-        :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)
-        perm ||= 0666 # Avoid error on Rubinius, see issue #52
-        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
+Backports.require_relative_dir