backports 2.4.0 → 2.5.0

data/CHANGELOG.rdoc

@@ -1,5 +1,30 @@
 = Packable --- History
 
+== Version 2.5.0 - March 25th, 2012
+
+* Added some features of 1.9.3:
+  * IO::NULL
+  * IO#advise
+  * String#byteslice
+  * String#prepend
+
+== Version 2.4.0 - March 24th, 2012
+
+* Add backporting for libraries
+
+* Bring libraries up to date:
+  * Matrix
+  * Prime
+  * Set
+
+* Added some features of 1.9.3:
+  * IO.write, IO.binwrite
+
+* Add forcing backports (must be required explicitly):
+  * 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)
+
 == Version 2.3.0 - May 13th, 2011
 
 * Added Enumerator::Yielder#<<

data/README.rdoc

@@ -1,6 +1,6 @@
 = Backports Library
 
-* Yearning to use some of the new cool features in 1.9.2 while using 1.8.x?
+* Yearning to use some of the new cool features in 1.9.3 while using 1.8.6?
 * 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?
 * Can't remember if you can use Array#sample or String#each_char on a friend's box?
 
@@ -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 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)!
+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), Ruby 1.9.2 and Ruby 1.9.3 (for all earlier versions)!
 
 +Note+: Although I am a Ruby committer, this gem is a personal project and is not endorsed by ruby-core.
 
@@ -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, 1.9.2, JRuby and Rubinius.
+Compatible with Ruby 1.8.6, 1.8.7, 1.9.1, 1.9.2, 1.9.3, JRuby and Rubinius.
 
 = Complete List of backports
 
@@ -180,8 +180,14 @@ To include all Ruby backports but not those of Rails, <tt>require "backports/1.9
 
 Some features of Ruby 1.9.3 have been backported:
 
+* File
+  * +NULL+
 * IO
+  * +advise+ (acts as a noop)
   * +write+, +binwrite+
+* String
+  * +byteslice+
+  * +prepend+
 
 == Rails
 

data/VERSION.yml

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

data/backports.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{backports}
-  s.version = "2.4.0"
+  s.version = "2.5.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{2012-03-24}
+  s.date = %q{2012-03-25}
   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}
@@ -96,7 +96,9 @@ Gem::Specification.new do |s|
     "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/file.rb",
     "lib/backports/1.9.3/io.rb",
+    "lib/backports/1.9.3/string.rb",
     "lib/backports/1.9.rb",
     "lib/backports/basic_object.rb",
     "lib/backports/force/array_map.rb",

data/lib/backports/1.9.3/file.rb

@@ -0,0 +1,12 @@
+class File
+  NULL =  case RUBY_PLATFORM
+          when /mswin/i
+            'NUL'
+          when /amiga/i
+            'NIL:'
+          when /openvms/i
+            'NL:'
+          else
+            '/dev/null'
+          end unless const_defined?(:NULL)
+end

data/lib/backports/1.9.3/io.rb

@@ -1,3 +1,23 @@
+class IO
+  # Standard in Ruby 1.9.3 See official documentation[http://ruby-doc.org/core-1.9.3/IO.html#method-i-advise]
+  # We're only for a platform not implementing advise, so we return nil.
+  def advise(advice, offset=0, len=0)
+    case advice
+    when  :normal,
+          :sequential,
+          :random,
+          :willneed,
+          :dontneed,
+          :noreuse
+      return nil
+    when Symbol
+      raise NotImplementedError, "Unsupported advice #{advice}"
+    else
+      raise TypeError, "advice must be a Symbol"
+    end
+  end unless method_defined? :advise
+end
+  
 class << IO
   # Standard in Ruby 1.9.3 See official documentation[http://ruby-doc.org/core-1.9.3/IO.html#method-c-write]
   def write(name, string, offset = nil, options = Backports::Undefined)

data/lib/backports/1.9.3/string.rb

@@ -0,0 +1,39 @@
+class String
+  # Standard in Ruby 1.9.3 See official documentation[http://ruby-doc.org/core-1.9.3/String.html#byteslice]
+  def byteslice(start, len = Backports::Undefined)
+    # Argument parsing & checking
+    if Backports::Undefined == len
+      if start.is_a?(Range)
+        range = start
+        start = Backports.coerce_to_int(range.begin)
+        start += bytesize if start < 0
+        last = Backports.coerce_to_int(range.end)
+        last += bytesize if last < 0
+        last += 1 unless range.exclude_end?
+        len = last - start
+      else
+        start = Backports.coerce_to_int(start)
+        start += bytesize if start < 0
+        len = 1
+        return if start >= bytesize
+      end
+    else
+      start = Backports.coerce_to_int(start)
+      start += bytesize if start < 0
+      len = Backports.coerce_to_int(len)
+      return if len < 0
+    end
+    return if start < 0 || start > bytesize
+    len = 0 if len < 0
+    # Actual implementation:
+    str = unpack("@#{start}a#{len}").first
+    str = dup.replace(str) unless self.instance_of?(String) # Must return subclass
+    str.force_encoding(encoding)
+  end unless method_defined? :byteslice
+
+  # Standard in Ruby 1.9.3 See official documentation[http://ruby-doc.org/core-1.9.3/String.html#method-i-prepend]
+  def prepend(other_str)
+    replace Backports.coerce_to_str(other_str) + self
+    self
+  end unless method_defined? :prepend
+end

data/lib/backports/tools.rb

@@ -211,6 +211,10 @@ module Backports
     coerce_to(obj, Array, :to_ary)
   end
 
+  def self.coerce_to_str(obj)
+    coerce_to(obj, String, :to_str)
+  end
+
   def self.try_convert(obj, cls, meth)
     return obj if obj.kind_of?(cls)
     return nil unless obj.respond_to?(meth)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: backports
 version: !ruby/object:Gem::Version 
-  hash: 31
+  hash: 27
   prerelease: false
   segments: 
   - 2
-  - 4
+  - 5
   - 0
-  version: 2.4.0
+  version: 2.5.0
 platform: ruby
 authors: 
 - "Marc-Andr\xC3\xA9 Lafortune"
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-03-24 00:00:00 -04:00
+date: 2012-03-25 00:00:00 -04:00
 default_executable: 
 dependencies: []
 
@@ -107,7 +107,9 @@ files:
 - 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/file.rb
 - lib/backports/1.9.3/io.rb
+- lib/backports/1.9.3/string.rb
 - lib/backports/1.9.rb
 - lib/backports/basic_object.rb
 - lib/backports/force/array_map.rb