backports 3.16.0 → 3.18.0

data/SECURITY.md

@@ -0,0 +1,5 @@
+## Security contact information
+
+To report a security vulnerability, please use the
+[Tidelift security contact](https://tidelift.com/security).
+Tidelift will coordinate the fix and disclosure.

data/backports.gemspec

@@ -13,7 +13,11 @@ Gem::Specification.new do |gem|
   gem.homepage      = "http://github.com/marcandre/backports"
   gem.license       = "MIT"
 
-  gem.files         = `git ls-files`.split($/)
+  gem.files         = Dir[*%w[
+                        lib/**/*
+                        *.{md,txt,gemspec}
+                        Gemfile
+                      ]]
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]

data/lib/backports.rb

@@ -1,3 +1,9 @@
 require "backports/version"
+
+require "backports/tools/deprecation"
+Backports.deprecate :require_version,
+                    "Doing `require 'backports'` is deprecated and will not load any backport in the next major release.\n" \
+                    "Require just the needed backports instead, or 'backports/latest'."
 require "backports/2.4"
+Backports.warned[:rails] = true
 require "backports/rails"

data/lib/backports/1.8.7.rb

@@ -1,4 +1,12 @@
 # require this file to load all the backports of Ruby 1.8.7
 require "backports/tools/require_relative_dir"
-require "backports/std_lib"
-Backports.require_relative_dir
+require "backports/tools/deprecation"
+
+Backports.frown_upon :require_version,
+  'Requiring backports/<ruby version> is not recommended in production. Require just the needed backports instead.'
+
+if RUBY_VERSION < '1.8.7'
+  Backports.warned[:require_std_lib] = true
+  require "backports/std_lib"
+  Backports.require_relative_dir
+end

data/lib/backports/1.9.1.rb

@@ -1,3 +1,8 @@
 # require this file to load all the backports up to Ruby 1.9.1 (including all of 1.8.8 and below)
 require 'backports/1.8'
-Backports.require_relative_dir
+
+if RUBY_VERSION < '1.9.1'
+  Backports.warned[:require_std_lib] = true
+  require "backports/std_lib"
+  Backports.require_relative_dir
+end

data/lib/backports/1.9.2.rb

@@ -1,3 +1,8 @@
 # require this file to load all the backports up to Ruby 1.9.2
 require 'backports/1.9.1'
-Backports.require_relative_dir
+
+if RUBY_VERSION < '1.9.2'
+  Backports.warned[:require_std_lib] = true
+  require "backports/std_lib"
+  Backports.require_relative_dir
+end

data/lib/backports/1.9.2/stdlib/matrix.rb

@@ -11,7 +11,10 @@
 # Original Documentation:: Gavin Sinclair (sourced from <i>Ruby in a Nutshell</i> (Matsumoto, O'Reilly))
 ##
 
+begin
 require "e2mmap.rb"
+rescue LoadError
+else
 
 module ExceptionForMatrix # :nodoc:
   def_e2message(TypeError, "wrong argument type %s (expected %s)")
@@ -1870,3 +1873,5 @@ class Vector
   end
 end
 end
+
+end

data/lib/backports/1.9.3.rb

@@ -1,3 +1,8 @@
 # require this file to load all the backports up to Ruby 1.9.3
 require 'backports/1.9.2'
-Backports.require_relative_dir
+
+if RUBY_VERSION < '1.9.3'
+  Backports.warned[:require_std_lib] = true
+  require "backports/std_lib"
+  Backports.require_relative_dir
+end

data/lib/backports/2.0.0.rb

@@ -1,3 +1,8 @@
 # require this file to load all the backports up to Ruby 2.0.0
 require 'backports/1.9'
-Backports.require_relative_dir
+
+if RUBY_VERSION < '2.0'
+  Backports.warned[:require_std_lib] = true
+  require "backports/std_lib"
+  Backports.require_relative_dir
+end

data/lib/backports/2.0.0/range/size.rb

@@ -1,4 +1,6 @@
 unless Range.method_defined? :size
+  require 'backports/1.9.2/float/infinity'
+
   class Range
     def size
       return nil unless self.begin.is_a?(Numeric) && self.end.is_a?(Numeric)

data/lib/backports/2.1.0.rb

@@ -1,3 +1,3 @@
 # require this file to load all the backports up to Ruby 2.1.0
 require 'backports/2.0'
-Backports.require_relative_dir
+Backports.require_relative_dir if RUBY_VERSION < '2.1'

data/lib/backports/2.2.0.rb

@@ -1,3 +1,3 @@
 # require this file to load all the backports up to Ruby 2.2
 require 'backports/2.1'
-Backports.require_relative_dir
+Backports.require_relative_dir if RUBY_VERSION < '2.2'

data/lib/backports/2.2.0/enumerable/slice_after.rb

@@ -7,7 +7,7 @@ unless Enumerable.method_defined? :slice_after
       raise ArgumentError, 'both pattern and block are given' if pattern != Backports::Undefined && block
       raise ArgumentError, 'wrong number of arguments (given 0, expected 1)' if pattern == Backports::Undefined && !block
       enum = self
-      block ||= Proc.new{|elem| pattern === elem}
+      block ||= proc {|elem| pattern === elem}
       Enumerator.new do |y|
         acc = []
         enum.each do |*elem|

data/lib/backports/2.2.0/float/next_float.rb

@@ -4,7 +4,7 @@ unless Float.method_defined? :next_float
   class Float
     def next_float
       return Float::INFINITY if self == Float::INFINITY
-      r = Backports.integer_to_float(Backports.float_to_integer(self)+1)
+      r = Backports.integer_to_float(Backports.float_to_integer(self) + 1)
       r == 0 ? -0.0 : r # Map +0.0 to -0.0
     end
   end

data/lib/backports/2.2.0/float/prev_float.rb

@@ -5,7 +5,7 @@ unless Float.method_defined? :prev_float
   class Float
     def prev_float
       return -Float::INFINITY if self == -Float::INFINITY
-      Backports.integer_to_float(Backports.float_to_integer(self)-1)
+      Backports.integer_to_float(Backports.float_to_integer(self) - 1)
     end
   end
 end

data/lib/backports/2.2.0/method/super_method.rb

@@ -6,10 +6,10 @@ unless Method.method_defined? :super_method
       singleton_klass = class << receiver; self; end
       call_chain = singleton_klass.ancestors
       # find current position in call chain:
-      skip = call_chain.find_index{|c| c == owner} or return
+      skip = call_chain.find_index {|c| c == owner} or return
       call_chain = call_chain.drop(skip + 1)
       # find next in chain with a definition:
-      next_index = call_chain.find_index{|c| c.method_defined? name}
+      next_index = call_chain.find_index {|c| c.method_defined? name}
       next_index && call_chain[next_index].instance_method(name).bind(receiver)
     end
   end

data/lib/backports/2.3.0.rb

@@ -1,3 +1,3 @@
 # require this file to load all the backports up to Ruby 2.3
 require 'backports/2.2'
-Backports.require_relative_dir
+Backports.require_relative_dir if RUBY_VERSION < '2.3'

data/lib/backports/2.3.0/array/bsearch_index.rb

@@ -5,7 +5,7 @@ unless Array.method_defined? :bsearch_index
       from = 0
       to   = size - 1
       satisfied = nil
-      while from <= to do
+      while from <= to
         midpoint = (from + to).div(2)
         result = yield(self[midpoint])
         case result

data/lib/backports/2.3.0/hash/lt.rb

@@ -5,7 +5,7 @@ unless Hash.method_defined? :<
       hash = Backports.coerce_to_hash(hash)
       return false unless size < hash.size
       each do |k, v|
-        v2 = hash.fetch(k){ return false }
+        v2 = hash.fetch(k) { return false }
         return false unless v2 == v
       end
       true

data/lib/backports/2.3.0/hash/lte.rb

@@ -5,7 +5,7 @@ unless Hash.method_defined? :<=
       hash = Backports.coerce_to_hash(hash)
       return false unless size <= hash.size
       each do |k, v|
-        v2 = hash.fetch(k){ return false }
+        v2 = hash.fetch(k) { return false }
         return false unless v2 == v
       end
       true

data/lib/backports/2.3.0/hash/to_proc.rb

@@ -2,7 +2,7 @@ unless Hash.method_defined? :to_proc
   class Hash
     def to_proc
       h = self
-      Proc.new{|*args| h[*args]}
+      proc {|*args| h[*args]}
     end
   end
 end

data/lib/backports/2.3.0/struct/dig.rb

@@ -2,11 +2,10 @@ unless Struct.method_defined? :dig
   class Struct
     def dig(key, *rest)
       return nil unless respond_to?(key)
-      val = self.public_send(key)
+      val = public_send(key)
       return val if rest.empty? || val == nil
       raise TypeError, "#{val.class} does not have #dig method" unless val.respond_to? :dig
       val.dig(*rest)
     end
   end
 end
-

data/lib/backports/2.4.0.rb

@@ -1,3 +1,3 @@
 # require this file to load all the backports up to Ruby 2.4
 require 'backports/2.3'
-Backports.require_relative_dir
+Backports.require_relative_dir if RUBY_VERSION < '2.4'

data/lib/backports/2.4.0/hash/transform_values.rb

@@ -1,6 +1,6 @@
 class Hash
   def transform_values
-    return to_enum(:transform_values){ size } unless block_given?
+    return to_enum(:transform_values) { size } unless block_given?
     h = {}
     each do |key, value|
       h[key] = yield value
@@ -9,7 +9,7 @@ class Hash
   end unless method_defined? :transform_values
 
   def transform_values!
-    return to_enum(:transform_values!){ size } unless block_given?
+    return to_enum(:transform_values!) { size } unless block_given?
     reject!{} if frozen? # Force error triggerring if frozen, in case of empty array
     each do |key, value|
       self[key] = yield value

data/lib/backports/2.4.0/true_class/dup.rb

@@ -3,4 +3,3 @@ class TrueClass
     self
   end
 end unless (true.dup rescue false)
-

data/lib/backports/2.5.0.rb

@@ -1,3 +1,3 @@
 # require this file to load all the backports up to Ruby 2.5
 require 'backports/2.4'
-Backports.require_relative_dir
+Backports.require_relative_dir if RUBY_VERSION < '2.5'

data/lib/backports/2.5.0/hash/transform_keys.rb

@@ -1,6 +1,6 @@
 class Hash
   def transform_keys
-    return to_enum(:transform_keys){ size } unless block_given?
+    return to_enum(:transform_keys) { size } unless block_given?
     h = {}
     each do |key, value|
       h[yield key] = value

data/lib/backports/2.5.0/integer/sqrt.rb

@@ -6,9 +6,9 @@ class Integer
   def self.sqrt(n)
     n = Backports.coerce_to_int(n)
     return Math.sqrt(n).to_i if n <= 9_999_899_999_899_999_322_536_673_279
-    bits_shift = n.bit_length/2 + 1
+    bits_shift = n.bit_length / 2 + 1
     bitn_mask = root = 1 << bits_shift
-    while true
+    loop do
       root ^= bitn_mask if (root * root) > n
       bitn_mask >>= 1
       return root if bitn_mask == 0

data/lib/backports/2.5.0/module/alias_method.rb

@@ -1,4 +1,3 @@
 class Module
   public :alias_method
 end
-

data/lib/backports/2.5.0/string/undump.rb

@@ -6,14 +6,10 @@ unless String.method_defined? :undump
       raise 'string contains null byte' if string["\0"]
       raise 'non-ASCII character detected' unless string.ascii_only?
 
-      #raise '.force_encoding("...") format is not supported by backports' if string.match(/\A".*"\.force_encoding\("[^"]*"\)\z/)
-      match = string.match(/\A(".*?"?)(?:\.force_encoding\("([^"]*)"\))?\z/)
-      if match
-        string = match[1]
-        encoding = match[2]
-      else
+      match = string.match(/\A(".*?"?)(?:\.force_encoding\("([^"]*)"\))?\z/) or
         raise %(invalid dumped string; not wrapped with '"' nor '"...".force_encoding("...")' form)
-      end
+      string = match[1]
+      encoding = match[2]
 
       # Ruby 1.9.3 does weird things to encoding during gsub
       encoding ||= string.encoding.to_s

data/lib/backports/2.5.0/struct/new.rb

@@ -19,5 +19,5 @@ if RUBY_VERSION >= '2.0.0' && (Struct.new(:a, :keyword_init => true) && false re
     end
     Backports.alias_method_chain(self, :new, :keyword_init)
   end
-  ]
+  ], nil, __FILE__, __LINE__ - 19
 end

data/lib/backports/2.6.0.rb

@@ -1,3 +1,3 @@
 # require this file to load all the backports up to Ruby 2.5
 require 'backports/2.5'
-Backports.require_relative_dir
+Backports.require_relative_dir if RUBY_VERSION < '2.6'

data/lib/backports/2.6.0/enumerable/chain.rb

@@ -11,7 +11,10 @@ unless Enumerable.method_defined? :chain
     def initialize(*enums)
       @enums = enums
       @rewindable = -1
-      self
+      # This self is necessary to pass RubySpec,
+      # See rubyspec/core/enumerator/chain/initialize_spec.rb
+      # ...it checks what call of #initialize on non-initalized object returns
+      self # rubocop:disable Lint/Void
     end
 
     def each(*args, &block)

data/lib/backports/2.6.0/hash/to_h.rb

@@ -1,6 +1,6 @@
 require 'backports/2.0.0/hash/to_h' unless Hash.method_defined? :to_h
 
-if {:n => true}.to_h{[:ok, true]}[:n]
+if {:n => true}.to_h {[:ok, true]}[:n]
   require 'backports/tools/alias_method_chain'
   require 'backports/2.1.0/array/to_h'
 

data/lib/backports/2.6.0/range.rb

@@ -0,0 +1,3 @@
+require 'backports/tools/require_relative_dir'
+
+Backports.require_relative_dir

data/lib/backports/2.6.0/range/cover.rb

@@ -0,0 +1,22 @@
+unless (1..4).cover?(2..3)
+  require 'backports/tools/alias_method_chain'
+
+  class Range
+    def cover_with_range_compatibility?(what)
+      return cover_without_range_compatibility?(what) unless what.is_a?(Range)
+
+      left = self.begin <=> what.begin
+      right = self.end <=> what.end
+      return false unless left && right
+
+      left <= 0 && (
+        right >= 1 ||
+        right == 0 && (!exclude_end? || what.exclude_end?) ||
+        what.exclude_end? && what.begin.is_a?(Integer) &&
+          what.end.is_a?(Integer) && cover_without_range_compatibility?(what.end - 1)
+      )
+    end
+    Backports.alias_method_chain self, :cover?, :range_compatibility
+  end
+
+end

data/lib/backports/2.7.0.rb

@@ -1,3 +1,3 @@
 # require this file to load all the backports up to Ruby 2.5
 require 'backports/2.6'
-Backports.require_relative_dir
+Backports.require_relative_dir if RUBY_VERSION < '2.7'

data/lib/backports/2.7.0/enumerable/filter_map.rb

@@ -5,10 +5,10 @@ unless Enumerable.method_defined? :filter_map
     def filter_map
       return to_enum(:filter_map) unless block_given?
 
-      each_with_object([]) { |item, res|
+      each_with_object([]) do |item, res|
         processed = yield(item)
         res << processed if processed
-      }
+      end
     end
   end
 end

data/lib/backports/rails/array.rb

@@ -1,3 +1,7 @@
+require 'backports/tools/deprecation'
+
+Backports.deprecate :rails, 'Rails backports are deprecated.'
+
 class Array
   # See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/Array/ExtractOptions.html]
   def extract_options!

data/lib/backports/rails/enumerable.rb

@@ -1,3 +1,7 @@
+require 'backports/tools/deprecation'
+
+Backports.deprecate :rails, 'Rails backports are deprecated.'
+
 module Enumerable
   # Standard in rails... See official documentation[http://api.rubyonrails.org/classes/Enumerable.html]
   # Modified from rails 2.3 to not rely on size

data/lib/backports/rails/hash.rb

@@ -1,3 +1,7 @@
+require 'backports/tools/deprecation'
+
+Backports.deprecate :rails, 'Rails backports are deprecated.'
+
 class Hash
   # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/Hash/Keys.html]
   def reverse_merge(other_hash)

data/lib/backports/rails/kernel.rb

@@ -1,5 +1,9 @@
 # frozen_string_literal: true
 
+require 'backports/tools/deprecation'
+
+Backports.deprecate :rails, 'Rails backports are deprecated.'
+
 # From ActiveSupport
 unless Object.method_defined? :try
   class Object

data/lib/backports/rails/module.rb

@@ -1,3 +1,7 @@
+require 'backports/tools/deprecation'
+
+Backports.deprecate :rails, 'Rails backports are deprecated.'
+
 class Module
   # Standard in rails... See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/Module.html]
   def alias_method_chain(target, feature, &block)

data/lib/backports/rails/string.rb

@@ -1,3 +1,7 @@
+require 'backports/tools/deprecation'
+
+Backports.deprecate :rails, 'Rails backports are deprecated.'
+
 class String
   # Standard in rails. See official documentation[http://api.rubyonrails.org/classes/ActiveSupport/CoreExtensions/String/Inflections.html]
   def camelize(first_letter = :upper)