polyfill 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a78a97eb49d10c541939893c1df67dc431f56570
-  data.tar.gz: b56aa89aaafa5cf0ae1238c7a5d6a7b1be9277d8
+  metadata.gz: 237acd76888542aca87f442fd066883269ddaee0
+  data.tar.gz: ee1bc441b77b3a6277bbcc4385703d945cc79828
 SHA512:
-  metadata.gz: ca64b371d0e8287f87f67be903b9b48be65f318ad6ae991d4789114addc5500d785638efc65d3bfd464b5769cc80a07be033cdef17770752a1da55c1a984d2b8
-  data.tar.gz: bdfce84cb85bb20c013584b259c0612468a103985007824a38b2f635fa4adc86a0f4182ea5aaa362d873eaef0f789a02cb38a4f47df3810d6f792b75ddedf081
+  metadata.gz: ccfcb0140e7d2d14da8678133dc7544984deedacac903699cbb71dbba6be6408b3560d9ee7424045a681887b409fd6da6245e53bd80becd74ae23cdf21d544ff
+  data.tar.gz: bc0626751a50adb7470bcd992a27b09aceb594f72b28f43833a06370e15b00b7811a5c000245b518fd11fe361e37c5527cd30f804cf276f360475089d64ad2c8

data/.rubocop.yml

@@ -1,5 +1,5 @@
 AllCops:
-  TargetRubyVersion: 2.3
+  TargetRubyVersion: 2.2
 Metrics/AbcSize:
   Enabled: false
 Metrics/BlockLength:

data/.travis.yml

@@ -1,4 +1,5 @@
 language: ruby
 rvm:
-  - 2.4.0
+  - 2.4.1
   - 2.3.3
+  - 2.2.6

data/CHANGELOG.md

@@ -1,3 +1,11 @@
+# [0.5.0][] (2017-03-26)
+
+## Added
+ - Support for Ruby 2.2
+ - :version option to limit the max acceptable version for changes
+ - v2.3 String.new
+ - v2.3 Enumerable#chunk_while
+
 # [0.4.0][] (2017-03-24)
 
 ## Added

data/README.md

@@ -17,6 +17,8 @@ Right now the only update is from 2.3 to 2.4 however the goal is to go all the w
 - [Goals](#goals)
 - [Usage](#usage)
 - [Implementation Table](#implementation-table)
+  - [2.3 to 2.4](#23-to-24)
+  - [2.2 to 2.3](#22-to-23)
 
 ## Caveat Emptor
 
@@ -32,7 +34,7 @@ See the [implementation table](#implementation-table) for specifics about what h
 Add it to your Gemfile:
 
 ```ruby
-gem 'polyfill', '0.4.0'
+gem 'polyfill', '0.5.0'
 ```
 
 Or install it manually:
@@ -75,6 +77,13 @@ If you want all of the methods for a particular class you can use `:all`.
 using Polyfill(Numeric: :all)
 ```
 
+Updates can be stopped at a specific version by pass it via `:version`. The
+version selected must be formatted as "MAJOR.MINOR".
+
+```ruby
+using Polyfill(version: '2.3', Numeric: :all)
+```
+
 Methods can be included in the same way. Prior to Ruby 2.4, refinements did
 not work on modules. In order to get methods you'll need to include them after
 the module. Calling `using` on a module will add it to all core Ruby classes
@@ -195,6 +204,41 @@ end
 | TracePoint       | #callee_id               | No          |
 | Warning          | #warn                    | No          |
 
+### 2.2 to 2.3
+
+| Object           | Method                   | Implemented | Notes |
+| ---------------- | ------------------------ | ----------- | ----- |
+| ARGF             | #read_nonblock           | No          |
+| Array            | #bsearch_index           | No          |
+|                  | #dig                     | No          |
+| Comparable       | #==                      | No          |
+| Enumerable       | #chunk                   | No          |
+|                  | #chunk_while             | Yes         |
+|                  | #grep_v                  | No          |
+|                  | #slice_before            | No          |
+| Enumerator::Lazy | #grep_v                  | No          |
+| File             | .mkfifo                  | No          |
+| Hash             | #<                       | No          |
+|                  | #<=                      | No          |
+|                  | #>                       | No          |
+|                  | #>=                      | No          |
+|                  | #dig                     | No          |
+|                  | #fetch_values            | No          |
+|                  | #to_proc                 | No          |
+| IO               | #advise                  | No          |
+| Kernel           | #loop                    | No          |
+| Module           | #deprecate_constant      | No          |
+| NameError        | #receiver                | No          |
+| Numeric          | #negative?               | No          |
+|                  | #positive?               | No          |
+| Queue            | #close                   | No          |
+| String           | #+@                      | No          |
+|                  | #-@                      | No          |
+|                  | .new                     | Yes         |
+| Struct           | #dig                     | No          |
+| Thread           | #name                    | No          |
+|                  | #name=                   | No          |
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/AaronLasseigne/polyfill.

data/lib/polyfill.rb

@@ -1,38 +1,64 @@
 require 'polyfill/version'
+require 'polyfill/utils'
+require 'polyfill/v2_3'
 require 'polyfill/v2_4'
 
 module Polyfill
+  include V2_3
   include V2_4
 end
 
 def Polyfill(options) # rubocop:disable Style/MethodName
   mod = Module.new
 
-  klasses, others = options.partition { |key,| key[/\A[A-Z]/] }
+  objects, others = options.partition { |key,| key[/\A[A-Z]/] }
+  others = others.to_h
+
+  versions = {
+    '2.3' => Polyfill::V2_3,
+    '2.4' => Polyfill::V2_4
+  }
+  desired_version = others.delete(:version) || versions.keys.max
+  unless versions.keys.include?(desired_version)
+    raise ArgumentError, "invalid value for keyword version: #{desired_version}"
+  end
+  versions.reject! do |version_number, _|
+    version_number > desired_version
+  end
 
   unless others.empty?
     raise ArgumentError, "unknown keyword: #{others.first[0]}"
   end
 
-  needs_update = RUBY_VERSION[/\A(\d+\.\d+)/, 1] < '2.4'
+  current_ruby_version = RUBY_VERSION[/\A(\d+\.\d+)/, 1]
 
-  klasses.each do |names, methods|
-    class_or_module_mod = names
-      .to_s
-      .split('::')
-      .reduce(Polyfill::V2_4) do |current_mod, name|
+  objects.each do |full_name, methods|
+    object_module_names = full_name.to_s.split('::')
+
+    object_modules = versions
+      .map do |version_number, version_module|
         begin
-          current_mod.const_get(name, false)
+          final_module = object_module_names
+            .reduce(version_module) do |current_mod, name|
+              current_mod.const_get(name, false)
+            end
+
+          [version_number, final_module]
         rescue NameError
-          raise ArgumentError, %Q("#{names}" is not a valid class or has no updates)
+          nil
         end
       end
+      .compact
 
-    if methods == :all
-      next unless needs_update
+    if object_modules.empty?
+      raise ArgumentError, %Q("#{full_name}" is not a valid class or has no updates)
+    end
 
+    if methods == :all
       mod.module_eval do
-        include class_or_module_mod
+        object_modules.each do |(version_number, object_module)|
+          include object_module if version_number > current_ruby_version
+        end
       end
     else
       methods.each do |method|
@@ -58,19 +84,24 @@ def Polyfill(options) # rubocop:disable Style/MethodName
         method_name.capitalize!
         method_name.gsub!(/_(.)/) { |match| match[1].capitalize }
 
-        method_mod =
-          begin
-            class_or_module_mod
-              .const_get(type, false)
-              .const_get(method_name, false)
-          rescue NameError
-            raise ArgumentError, %Q("#{method}" is not a valid method on #{names} or has no updates)
+        method_modules = object_modules
+          .map do |(version_number, object_module)|
+            begin
+              [version_number, object_module.const_get(type, false).const_get(method_name, false)]
+            rescue NameError
+              nil
+            end
           end
+          .compact
 
-        next unless needs_update
+        if method_modules.empty?
+          raise ArgumentError, %Q("#{method}" is not a valid method on #{full_name} or has no updates)
+        end
 
         mod.module_eval do
-          include method_mod
+          method_modules.each do |(version_number, method_module)|
+            include method_module if version_number > current_ruby_version
+          end
         end
       end
     end

data/lib/polyfill/utils.rb

@@ -0,0 +1,8 @@
+module Polyfill
+  module Utils
+    def when_ruby_below(version)
+      yield if RUBY_VERSION[/\A(\d+\.\d+)/, 1] < version
+    end
+    module_function :when_ruby_below
+  end
+end

data/lib/polyfill/v2_3.rb

@@ -0,0 +1,9 @@
+require_relative 'v2_3/enumerable'
+require_relative 'v2_3/string'
+
+module Polyfill
+  module V2_3
+    include Enumerable
+    include String
+  end
+end

data/lib/polyfill/v2_3/enumerable.rb

@@ -0,0 +1,9 @@
+require_relative 'enumerable/instance'
+
+module Polyfill
+  module V2_3
+    module Enumerable
+      include Instance
+    end
+  end
+end

data/lib/polyfill/v2_3/enumerable/instance.rb

@@ -0,0 +1,11 @@
+require_relative 'instance/chunk_while'
+
+module Polyfill
+  module V2_3
+    module Enumerable
+      module Instance
+        include ChunkWhile
+      end
+    end
+  end
+end

data/lib/polyfill/v2_3/enumerable/instance/chunk_while.rb

@@ -0,0 +1,70 @@
+require 'stringio'
+
+module Polyfill
+  module V2_3
+    module Enumerable
+      module Instance
+        module ChunkWhile
+          module Method
+            def chunk_while
+              block = Proc.new
+
+              return [self] if size == 1
+
+              Enumerator.new do |yielder|
+                output = []
+                each_cons(2).with_index(1) do |(a, b), run|
+                  if run == size - 1
+                    if block.call(a, b)
+                      output.push(a, b)
+                      yielder << output
+                    else
+                      output.push(a)
+                      yielder << output
+                      yielder << [b]
+                    end
+                  else
+                    output.push(a)
+                    unless block.call(a, b)
+                      yielder << output
+                      output = []
+                    end
+                  end
+                end
+              end
+            end
+          end
+
+          refine ::Array do
+            include Method
+          end
+          refine ::Dir do
+            include Method
+          end
+          refine ::Enumerator do
+            include Method
+          end
+          refine ::Hash do
+            include Method
+          end
+          refine ::IO do
+            include Method
+          end
+          refine ::Range do
+            include Method
+          end
+          refine ::StringIO do
+            include Method
+          end
+          refine ::Struct do
+            include Method
+          end
+
+          def self.included(base)
+            base.include Method
+          end
+        end
+      end
+    end
+  end
+end

data/lib/polyfill/v2_3/string.rb

@@ -0,0 +1,9 @@
+require_relative 'string/class'
+
+module Polyfill
+  module V2_3
+    module String
+      include Class
+    end
+  end
+end

data/lib/polyfill/v2_3/string/class.rb

@@ -0,0 +1,11 @@
+require_relative 'class/new'
+
+module Polyfill
+  module V2_3
+    module String
+      module Class
+        include New
+      end
+    end
+  end
+end

data/lib/polyfill/v2_3/string/class/new.rb

@@ -0,0 +1,33 @@
+module Polyfill
+  module V2_3
+    module String
+      module Class
+        module New
+          module Method
+            def new(*args)
+              hash, others = args.partition { |arg| arg.is_a?(::Hash) }
+              hash = hash.first
+              encoding = hash && hash.delete(:encoding)
+
+              if hash && !hash.keys.empty?
+                raise ArgumentError, "unknown keyword: #{hash.keys.first}"
+              end
+
+              str = super(*others)
+              str.encode!(encoding) if encoding
+              str
+            end
+          end
+
+          refine ::String.singleton_class do
+            include Method
+          end
+
+          def self.included(base)
+            base.include Method
+          end
+        end
+      end
+    end
+  end
+end

data/lib/polyfill/v2_4/enumerable/instance/chunk.rb

@@ -1,3 +1,5 @@
+require 'stringio'
+
 module Polyfill
   module V2_4
     module Enumerable

data/lib/polyfill/v2_4/enumerator/lazy/instance/chunk_while.rb

@@ -5,6 +5,10 @@ module Polyfill
         module Instance
           module ChunkWhile
             module Method
+              Utils.when_ruby_below('2.3') do
+                using V2_3::Enumerable::Instance::ChunkWhile
+              end
+
               def chunk_while
                 super.lazy
               end

data/lib/polyfill/version.rb

@@ -1,3 +1,3 @@
 module Polyfill
-  VERSION = '0.4.0'.freeze
+  VERSION = '0.5.0'.freeze
 end

data/polyfill.gemspec

@@ -13,7 +13,7 @@ Gem::Specification.new do |spec|
   spec.homepage = ''
   spec.license  = 'MIT'
 
-  spec.required_ruby_version = '>= 2.3'
+  spec.required_ruby_version = '>= 2.2'
 
   spec.files = `git ls-files -z`.split("\x0").reject do |f|
     f.match(%r{^(test|spec|features)/})

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: polyfill
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Aaron Lasseigne
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-03-24 00:00:00.000000000 Z
+date: 2017-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -86,6 +86,14 @@ files:
 - bin/console
 - bin/setup
 - lib/polyfill.rb
+- lib/polyfill/utils.rb
+- lib/polyfill/v2_3.rb
+- lib/polyfill/v2_3/enumerable.rb
+- lib/polyfill/v2_3/enumerable/instance.rb
+- lib/polyfill/v2_3/enumerable/instance/chunk_while.rb
+- lib/polyfill/v2_3/string.rb
+- lib/polyfill/v2_3/string/class.rb
+- lib/polyfill/v2_3/string/class/new.rb
 - lib/polyfill/v2_4.rb
 - lib/polyfill/v2_4/array.rb
 - lib/polyfill/v2_4/array/instance.rb
@@ -196,7 +204,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: '2.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="