backports 1.0.0

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Marc-Andre Lafortune
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,50 @@
+= Backports Library
+
+Essential backports that make it possible to use some of the really nice features of ruby 1.8.7, ruby 1.9 and rails from ruby 1.8.x
+
+Conditions for inclusion:
+1. Standard in either rails or ruby
+2. Won't break older code
+3. Simple and self-contained
+
+The first and second rules avoids conflicts in future and the past respectively. Because of the second rule, incompatibilities between 1.8 and 1.9 methods are left alone.
+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.
+
+More complex features of activesupport (even things like String::pluralize), won't be included. <tt>require 'activesupport'</tt> if you need them!
+
+I've added those as I need them; pull requests welcome (with tests for ruby 1.9 backports)
+
+= List of backports
+
+* Symbol
+  * +to_proc+ (e.g. <tt>foo.map(&:bar)</tt> )
+* Kernel
+  * +require_relative+
+* Module
+  * +alias_method_chain+
+* Object
+  * +tap+, +returning+
+  * +try+
+* String
+  * <tt>start_with?</tt>, <tt>end_with?</tt>
+  * +camelize+, +underscore+
+  * +dasherize+, +demodulize+
+  * +constantize+
+* Hash
+  * <tt>Hash[[[:foo, :bar],[:hello, "world"]]] ==> {:foo => :bar, :hello => "world"}</tt>
+  * +key+
+  * +symbolize_keys+, +symbolize_keys!+
+* Enumerable
+  * +sum+
+  * +find_index+
+  * +take+, +take_while+, +drop+, +drop_while+
+  * +first+
+* Fixnum
+  * <tt>odd?</tt>, <tt>even?</tt>
+
+= License
+
++backports+ is released under the terms of the MIT License, see the included LICENSE file.
+The code for backports was copied from rails when available.
+
+Author::                 Marc-André Lafortune

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:major: 1
+:minor: 0
+:patch: 0

data/lib/backports.rb

@@ -0,0 +1,15 @@
+module Kernel
+  # Standard in ruby 1.9.
+  def require_relative(relative_feature)
+    # Adapted from Pragmatic's "Programming Ruby" (since their version was buggy...)
+    file = caller.first.split(/:\d/,2).first
+    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
+end
+
+%w(object module enumerable string symbol fixnum hash).each do |lib|
+  require_relative "backports/#{lib}"
+end

data/lib/backports/enumerable.rb

@@ -0,0 +1,62 @@
+module Enumerable
+  # Standard in rails... See official documentation[http://api.rubyonrails.org/classes/Enumerable.html]
+  def sum(identity = 0, &block)
+    return identity unless size > 0
+
+    if block_given?
+      map(&block).sum
+    else
+      inject { |sum, element| sum + element }
+    end
+  end unless method_defined? :sum
+
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
+  def find_index(obj = nil)
+    return index(obj) unless block_given?
+    each_with_index do |element, i|
+      return i if yield(element)
+    end
+    nil
+  end unless method_defined? :find_index
+  
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
+  def take(n)
+    returning([]) do |array|
+      each do |elem|
+        array << elem
+        break if array.size >= n
+      end unless n <= 0
+    end
+  end unless method_defined? :take
+  
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
+  def take_while
+    raise NotImplemented unless block_given? #todo: what should this do?
+    inject([]) do |array, elem|
+      return array unless yield elem
+      array << elem
+    end
+  end unless method_defined? :take_while
+
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
+  def drop(n)
+    array = to_a
+    array[n...array.size] || []
+  end unless method_defined? :drop
+  
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
+  def drop_while(&block)
+    raise NotImplemented unless block_given? #todo: what should this do?
+    array = to_a
+    array.each_with_index do |element, i|
+      return array.drop(i) unless yield(element)
+    end
+    []
+  end unless method_defined? :drop_while
+  
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Enumerable.html]
+  def first(*arg)
+      arg.empty? ? take(1)[0] : take(arg.first)
+  end unless method_defined? :first
+
+end

data/lib/backports/fixnum.rb

@@ -0,0 +1,11 @@
+class Fixnum
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Fixnum.html]
+  def odd?
+    self & 1 == 1
+  end unless method_defined? :odd?
+  
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Fixnum.html]
+  def even?
+    self & 1 == 0
+  end unless method_defined? :even?
+end

data/lib/backports/hash.rb

@@ -0,0 +1,26 @@
+class Hash
+  # New ruby 1.9 constructor -- not documented?
+  # <tt>Hash[[[:foo, :bar],[:hello, "world"]]] ==> {:foo => :bar, :hello => "world"}</tt>
+  class << self
+    alias_method :original_constructor, :[]
+    def [](*arg)
+      return original_constructor(*arg) unless arg.length == 1 && arg.first.is_a?(Array)
+      returning({}) do |h|
+        arg.first.each{|key, value| h[key] = value}
+      end
+    end unless (Hash[[[:test, :test]]] rescue false)
+  end
+
+  # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/Hash/Keys.html]
+  def symbolize_keys
+    Hash[map{|key,value| [(key.to_sym rescue key) || key, value] }]
+  end unless method_defined? :symbolize_keys
+
+  # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/Hash/Keys.html]
+  def symbolize_keys!
+    self.replace(self.symbolize_keys)
+  end unless method_defined? :symbolize_keys!
+  
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Hash.html]
+  alias_method :key, :index unless method_defined? :key
+end

data/lib/backports/module.rb

@@ -0,0 +1,23 @@
+class Module
+  # Standard in rails... See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/Module.html]
+  def alias_method_chain(target, feature)
+    # Strip out punctuation on predicates or bang methods since
+    # e.g. target?_without_feature is not a valid method name.
+    aliased_target, punctuation = target.to_s.sub(/([?!=])$/, ''), $1
+    yield(aliased_target, punctuation) if block_given?
+    
+    with_method, without_method = "#{aliased_target}_with_#{feature}#{punctuation}", "#{aliased_target}_without_#{feature}#{punctuation}"
+    
+    alias_method without_method, target
+    alias_method target, with_method
+    
+    case
+      when public_method_defined?(without_method)
+        public target
+      when protected_method_defined?(without_method)
+        protected target
+      when private_method_defined?(without_method)
+        private target
+    end
+  end unless method_defined? :alias_method_chain
+end

data/lib/backports/object.rb

@@ -0,0 +1,22 @@
+require 'enumerator'
+
+class Object
+  # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/Object.html]
+  def try(method_id, *args, &block)
+    send(method_id, *args, &block) unless self.nil? #todo: check new def
+  end unless method_defined? :try
+
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/Object.html]
+  def tap
+    yield self
+    self
+  end unless method_defined? :tap
+
+  # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/Object.html]
+  def returning(obj)
+    yield obj
+    obj
+  end unless method_defined? :returning
+  
+  Enumerator = Enumerable::Enumerator unless const_defined? :Enumerator # Standard in ruby 1.9
+end

data/lib/backports/string.rb

@@ -0,0 +1,59 @@
+class String
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
+  def start_with?(prefix)
+    prefix = prefix.to_s
+    self[0, prefix.length] == prefix
+  end unless method_defined? :start_with?
+  
+  # Standard in ruby 1.9. See official documentation[http://ruby-doc.org/core-1.9/classes/String.html]
+  def end_with?(suffix) 
+    suffix = suffix.to_s
+    self[-suffix.length, suffix.length] == suffix    
+  end unless method_defined? :end_with?
+  
+  # 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
+  
+  # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/String/Inflections.html]
+  def camelize(first_letter = :upper) 
+    if first_letter == :upper
+      gsub(/\/(.?)/) { "::#{$1.upcase}" }.gsub(/(?:^|_)(.)/) { $1.upcase }
+    else
+      first.downcase + camelize[1..-1]
+    end
+  end unless method_defined? :camelize
+  
+  # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/String/Inflections.html]
+  def underscore(camel_cased_word)
+    camel_cased_word.to_s.gsub(/::/, '/').
+      gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+      gsub(/([a-z\d])([A-Z])/,'\1_\2').
+      tr("-", "_").
+      downcase
+  end unless method_defined? :underscore
+  
+  # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/String/Inflections.html]
+  def constantize(camel_cased_word)
+    names = camel_cased_word.split('::')
+    names.shift if names.empty? || names.first.empty?
+  
+    constant = Object
+    names.each do |name|
+      constant = constant.const_defined?(name) ? constant.const_get(name) : constant.const_missing(name)
+    end
+    constant
+  end unless method_defined? :constantize
+  
+  # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/String/Inflections.html]
+  def dasherize(underscored_word)
+    underscored_word.gsub(/_/, '-')
+  end unless method_defined? :dasherize
+  
+  # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/String/Inflections.html]
+  def demodulize(class_name_in_module)
+    class_name_in_module.to_s.gsub(/^.*::/, '')
+  end unless method_defined? :demodulize
+  
+end

data/lib/backports/symbol.rb

@@ -0,0 +1,6 @@
+class Symbol
+  # Standard in ruby 1.9. 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

data/test/backports_test.rb

@@ -0,0 +1,65 @@
+require 'test_helper'
+
+class BackportsTest < Test::Unit::TestCase
+  context "find_index" do
+    should "conform to doc" do
+      assert_equal 3, %w{ant bat cat dog}.find_index {|item| item =~ /g/ }
+      assert_equal nil, %w{ant bat cat dog}.find_index {|item| item =~ /h/ }
+    end
+  end
+
+  context "take" do
+    should "conform to doc" do
+      assert_equal [1, 2, 3], (1..7).take(3)
+      assert_equal [["a", 1], ["b", 2]], { 'a'=>1, 'b'=>2, 'c'=>3 }.take(2)
+    end
+    
+    should "only consume what's needed" do
+      assert_equal [], Enumerator.new(nil).take(0)
+      assert_raises(NoMethodError) { Enumerator.new(nil).take(1) }
+    end
+  end
+  
+  context "take_while" do
+    should "conform to doc" do
+      assert_equal [1,2], (1..7).take_while {|item| item < 3 }
+      assert_equal [2,4,6], [ 2, 4, 6, 9, 11, 16 ].take_while(&:even?)
+    end
+
+    should "work with infinite enumerables" do
+      assert_equal [1,2], (1..(1/0.0)).take_while {|item| item < 3 }
+    end
+  end
+  
+  context "drop" do
+    should "conform to doc" do
+      assert_equal [5, 8, 13], [ 1, 1, 2, 3, 5, 8, 13 ].drop(4)
+      assert_equal [], [ 1, 1, 2, 3, 5, 8, 13 ].drop(99)
+    end
+    
+    should "work with enums" do
+      assert_equal [14,15], (10...16).drop(4)
+    end
+  end
+  
+  context "drop_while" do
+    should "conform to doc" do
+      assert_equal [8, 13], [ 1, 1, 2, 3, 5, 8, 13 ].drop_while {|item| item < 6 } 
+    end
+
+    should "work with enums" do
+      assert_equal [14,15], (10...16).drop_while {|item| item < 14}
+    end
+
+    should "work with extemity cases" do
+      assert_equal [10,11,12,13,14,15], (10...16).drop_while {|item| false}
+      assert_equal [], (10...16).drop_while {|item| true}
+    end
+  end
+  
+  context "Hash" do
+    should "should be constructible from key value pairs" do
+      assert_equal({1 => 2, 3 => 4}, Hash[[[1,2],[3,4]]])
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'backports'
+
+class Test::Unit::TestCase
+end

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification 
+name: backports
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- "Marc-Andr\xC3\xA9 Lafortune"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-04-01 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: 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.
+email: github@marc-andre.ca
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- LICENSE
+files: 
+- README.rdoc
+- VERSION.yml
+- lib/backports
+- lib/backports/enumerable.rb
+- lib/backports/fixnum.rb
+- lib/backports/hash.rb
+- lib/backports/module.rb
+- lib/backports/object.rb
+- lib/backports/string.rb
+- lib/backports/symbol.rb
+- lib/backports.rb
+- test/backports_test.rb
+- test/test_helper.rb
+- LICENSE
+has_rdoc: true
+homepage: http://github.com/marcandre/backports
+post_install_message: 
+rdoc_options: 
+- --title
+- Backports library
+- --main
+- README.rdoc
+- --line-numbers
+- --inline-source
+- --inline-source
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: marcandre
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Backports or ruby 1.8.7+ & rails for older ruby.
+test_files: []
+