backports 3.18.0 → 3.23.0

data/backports.gemspec

@@ -23,7 +23,7 @@ Gem::Specification.new do |gem|
   gem.require_paths = ["lib"]
 
   if gem.respond_to?(:metadata)
-    gem.metadata['changelog_uri'] = 'https://github.com/marcandre/backports/blob/master/CHANGELOG.rdoc'
+    gem.metadata['changelog_uri'] = 'https://github.com/marcandre/backports/blob/master/CHANGELOG.md'
     gem.metadata['source_code_uri'] = 'https://github.com/marcandre/backports'
     gem.metadata['bug_tracker_uri'] = 'https://github.com/marcandre/backports/issues'
   end

data/lib/backports/2.0.0.rb

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

data/lib/backports/2.1.0/module/singleton_class.rb

@@ -0,0 +1,8 @@
+if Module.method_defined? :singleton_class?
+  class Module
+    def singleton_class?
+      # Hacky...
+      inspect.start_with? '#<Class:#'
+    end
+  end
+end

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'
+require 'backports/2.0.0'
 Backports.require_relative_dir if RUBY_VERSION < '2.1'

data/lib/backports/2.2.0/string/unicode_normalize.rb

@@ -4,7 +4,7 @@ unless String.method_defined? :unicode_normalize
   if (Regexp.compile("[\u{11100}-\u{11102}]") rescue false)
     class String
       def unicode_normalize(form = :nfc)
-        require 'backports/tools/normalize.rb' unless defined? UnicodeNormalize
+        require 'backports/tools/normalize' unless defined? UnicodeNormalize
         ## The following line can be uncommented to avoid repeated checking for
         ## UnicodeNormalize. However, tests didn't show any noticeable speedup
         ## when doing this. This comment also applies to the commented out lines
@@ -14,13 +14,13 @@ unless String.method_defined? :unicode_normalize
       end
 
       def unicode_normalize!(form = :nfc)
-        require 'backports/tools/normalize.rb' unless defined? UnicodeNormalize
+        require 'backports/tools/normalize' unless defined? UnicodeNormalize
         # String.send(:define_method, :unicode_normalize!, ->(form = :nfc) { replace(unicode_normalize(form)) } )
         replace(unicode_normalize(form))
       end
 
       def unicode_normalized?(form = :nfc)
-        require 'backports/tools/normalize.rb' unless defined? UnicodeNormalize
+        require 'backports/tools/normalize' unless defined? UnicodeNormalize
         # String.send(:define_method, :unicode_normalized?, ->(form = :nfc) { UnicodeNormalize.normalized?(self, form) } )
         UnicodeNormalize.normalized?(self, form)
       end

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'
+require 'backports/2.1.0'
 Backports.require_relative_dir if RUBY_VERSION < '2.2'

data/lib/backports/2.3.0/queue/close.rb

@@ -0,0 +1,48 @@
+unless Queue.method_defined? :close
+  require 'backports/tools/alias_method_chain'
+
+  class ClosedQueueError < StopIteration
+  end
+
+  class Queue
+    CLOSE_MESSAGE = Object.new
+
+    def push_with_close(arg)
+      raise ClosedQueueError, 'queue closed' if closed?
+
+      push_without_close(arg)
+    end
+    Backports.alias_method_chain self, :push, :close
+    alias_method :<<, :push
+    alias_method :enq, :push
+
+    def pop_with_close(non_block = false)
+      begin
+        r = pop_without_close(non_block || closed?)
+
+        r unless CLOSE_MESSAGE == r
+      rescue ThreadError
+        raise if non_block || !closed?
+      end
+    end
+    Backports.alias_method_chain self, :pop, :close
+
+    alias_method :shift, :pop
+    alias_method :deq, :pop
+
+    def close
+      @closed = true
+      2.times do
+        Thread.pass
+        num_waiting.times do
+          push_without_close CLOSE_MESSAGE
+        end
+      end
+      self
+    end
+
+    def closed?
+      !!defined?(@closed)
+    end
+  end
+end

data/lib/backports/2.3.0/string.rb

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

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

@@ -1,6 +1,8 @@
 unless Struct.method_defined? :dig
   class Struct
     def dig(key, *rest)
+      return self[key] if key.respond_to?(:to_int)
+
       return nil unless respond_to?(key)
       val = public_send(key)
       return val if rest.empty? || val == nil

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'
+require 'backports/2.2.0'
 Backports.require_relative_dir if RUBY_VERSION < '2.3'

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

@@ -0,0 +1,5 @@
+class Bignum
+  def dup
+    self
+  end
+end unless ((1 << 64).dup rescue false)

data/lib/backports/2.4.0/bignum.rb

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

data/lib/backports/2.4.0/string/unpack1.rb

@@ -0,0 +1,7 @@
+unless String.method_defined? :unpack1
+  class String
+    def unpack1(fmt)
+      unpack(fmt)[0]
+    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'
+require 'backports/2.3.0'
 Backports.require_relative_dir if RUBY_VERSION < '2.4'

data/lib/backports/2.5.0/dir/children.rb

@@ -3,4 +3,8 @@ class Dir
   def self.children(*args)
     entries(*args) - Backports::EXCLUDED_CHILDREN
   end
+
+  def children
+    self.class.children(path)
+  end
 end unless Dir.respond_to? :children

data/lib/backports/2.5.0/dir/each_child.rb

@@ -4,4 +4,11 @@ class Dir
     return to_enum(__method__, *args) unless block_given?
     foreach(*args) { |f| yield f unless Backports::EXCLUDED_CHILDREN.include? f }
   end
+
+  def each_child(&block)
+    return to_enum(__method__) unless block_given?
+
+    Dir.each_child(path, &block)
+    self
+  end
 end unless Dir.respond_to? :each_child

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

@@ -10,9 +10,16 @@ class Hash
 
   def transform_keys!
     return enum_for(:transform_keys!) { size } unless block_given?
-    merge!({}) if frozen?
-    keys.each do |key|
-      self[yield(key)] = delete(key)
+
+    self[:trigger_error] = :immediately if frozen?
+
+    h = {}
+    begin
+      each do |key, value|
+        h[yield key] = value
+      end
+    ensure
+      replace(h)
     end
     self
   end unless method_defined? :transform_keys!

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

@@ -39,9 +39,9 @@ unless String.method_defined? :undump
       #   * only allowing the first character after the \\ to not be alpha/num/space, so \\\\#@inst_var_access is ignored
       # To reduce the number of calls to eval a little, we wrap everything in a (...)+ so that consecutive escapes are
       # handled at the same time.
-      result = string.gsub(/(\\+(u\{[\w ]+\}|[^cCM][\w]*))+/) do |s|
+      result = string.gsub(/(\\+(u\{[\w ]+\}|[^cCM]\w*))+/) do |s|
         begin
-          eval("\"#{s}\"")
+          eval("\"#{s}\"")  # "body"
         rescue SyntaxError => e
           raise RuntimeError, e.message, e.backtrace
         end

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'
+require 'backports/2.4.0'
 Backports.require_relative_dir if RUBY_VERSION < '2.5'

data/lib/backports/2.5.rb

@@ -1,2 +1,2 @@
-# require this file to load all the backports of Ruby 2.4 and below
+# require this file to load all the backports of Ruby 2.5 and below
 require 'backports/2.5.0'

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

@@ -8,6 +8,7 @@ unless Enumerable.method_defined? :chain
   Enumerator = Enumerable::Enumerator unless Object.const_defined? :Enumerator # For 1.8.x
 
   class Enumerator::Chain < Enumerator
+    # rubocop:disable Lint/MissingSuper
     def initialize(*enums)
       @enums = enums
       @rewindable = -1
@@ -16,6 +17,7 @@ unless Enumerable.method_defined? :chain
       # ...it checks what call of #initialize on non-initalized object returns
       self # rubocop:disable Lint/Void
     end
+    # rubocop:enable Lint/MissingSuper
 
     def each(*args, &block)
       @enums.each_with_index do |enum, i|

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'
+# require this file to load all the backports up to Ruby 2.6
+require 'backports/2.5.0'
 Backports.require_relative_dir if RUBY_VERSION < '2.6'

data/lib/backports/2.6.rb

@@ -1,2 +1,2 @@
-# require this file to load all the backports of Ruby 2.4 and below
+# require this file to load all the backports of Ruby 2.6 and below
 require 'backports/2.6.0'

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

@@ -1,10 +1,11 @@
-require 'backports/1.9.1/enumerable/each_with_object' unless Enumerable.method_defined? :each_with_object
-
 unless Enumerable.method_defined? :tally
   module Enumerable
     def tally
+      h = {}
       # NB: By spec, tally should return default-less hash
-      each_with_object(Hash.new(0)) { |item, res| res[item] += 1 }.tap { |h| h.default = nil }
+      each_entry { |item| h[item] = h.fetch(item, 0) + 1 }
+
+      h
     end
   end
 end

data/lib/backports/2.7.0/symbol/end_with.rb

@@ -0,0 +1,9 @@
+require 'backports/1.8.7/string/end_with' unless String.method_defined? :end_with?
+
+unless Symbol.method_defined?(:end_with?)
+  class Symbol
+    def end_with?(*suffixes)
+      to_s.end_with?(*suffixes)
+    end
+  end
+end

data/lib/backports/2.7.0/symbol.rb

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

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'
+# require this file to load all the backports up to Ruby 2.7
+require 'backports/2.6.0'
 Backports.require_relative_dir if RUBY_VERSION < '2.7'

data/lib/backports/3.0.0/env/except.rb

@@ -0,0 +1,10 @@
+class << ENV
+  def except(*keys)
+    if keys.size > 4 && size > 4 # index if O(m*n) is big
+      h = {}
+      keys.each { |key| h[key] = true }
+      keys = h
+    end
+    reject { |key, _value| keys.include? key}
+  end
+end unless ENV.respond_to? :except

data/lib/backports/3.0.0/env.rb

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

data/lib/backports/3.0.0/hash/except.rb

@@ -0,0 +1,10 @@
+class Hash
+  def except(*keys)
+    if keys.size > 4 && size > 4 # index if O(m*n) is big
+      h = {}
+      keys.each { |key| h[key] = true }
+      keys = h
+    end
+    reject { |key, _value| keys.include? key}
+  end
+end unless Hash.method_defined? :except

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

@@ -0,0 +1,48 @@
+class Hash
+  unless ({}.transform_keys(:x => 1) rescue false)
+    require 'backports/2.5.0/hash/transform_keys'
+    require 'backports/tools/alias_method_chain'
+
+    def transform_keys_with_hash_arg(hash = not_given = true, &block)
+      return to_enum(:transform_keys) { size } if not_given && !block
+
+      return transform_keys_without_hash_arg(&block) if not_given
+
+      h = {}
+      if block_given?
+        each do |key, value|
+          h[hash.fetch(key) { yield key }] = value
+        end
+      else
+        each do |key, value|
+          h[hash.fetch(key, key)] = value
+        end
+      end
+      h
+    end
+    Backports.alias_method_chain self, :transform_keys, :hash_arg
+
+    def transform_keys_with_hash_arg!(hash = not_given = true, &block)
+      return enum_for(:transform_keys!) { size } if not_given && !block
+
+      return transform_keys_without_hash_arg!(&block) if not_given
+
+      h = {}
+      begin
+        if block_given?
+          each do |key, value|
+            h[hash.fetch(key) { yield key }] = value
+          end
+        else
+          each do |key, value|
+            h[hash.fetch(key, key)] = value
+          end
+        end
+      ensure
+        replace(h)
+      end
+      self
+    end
+    Backports.alias_method_chain self, :transform_keys!, :hash_arg
+  end
+end

data/lib/backports/3.0.0/hash.rb

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

data/lib/backports/3.0.0/ractor.rb

@@ -0,0 +1,19 @@
+if RUBY_VERSION < '2'
+  warn 'Ractor not backported to Ruby 1.x'
+elsif defined?(Ractor.current)
+  # all good
+else
+  # Cloner:
+  require_relative '../2.4.0/hash/transform_values'
+  require_relative '../2.5.0/hash/transform_keys'
+  # Queues & FilteredQueue
+  require_relative '../2.3.0/queue/close'
+
+  class Ractor
+  end
+
+  module Backports
+    Ractor = ::Ractor
+  end
+  require_relative '../ractor/ractor'
+end

data/lib/backports/3.0.0/symbol/name.rb

@@ -0,0 +1,21 @@
+unless Symbol.method_defined? :name
+  if ((ObjectSpace::WeakMap.new[:test] = :test) rescue false)
+    # WeakMaps accept symbols only in Ruby 2.7+
+    def Backports.symbol_names
+      @symbol_names ||= ObjectSpace::WeakMap.new
+    end
+
+    class Symbol
+      def name
+        Backports.symbol_names[self] ||= to_s.freeze
+      end
+    end
+  else
+    # For earlier Rubies, we can't pool their strings
+    class Symbol
+      def name
+        to_s.freeze
+      end
+    end
+  end
+end

data/lib/backports/3.0.0/symbol.rb

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

data/lib/backports/3.0.0.rb

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

data/lib/backports/3.0.rb

@@ -0,0 +1 @@
+require 'backports/3.0.0'

data/lib/backports/3.1.0/array/intersect.rb

@@ -0,0 +1,16 @@
+unless Array.method_defined? :intersect?
+  require 'backports/tools/arguments'
+
+  class Array
+    def intersect?(array)
+      array = Backports.coerce_to_ary(array)
+
+      if size < array.size
+        smaller = self
+      else
+        smaller, array = array, self
+      end
+      (array & smaller).size > 0
+    end
+  end
+end

data/lib/backports/3.1.0/array.rb

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

data/lib/backports/3.1.0/class/descendants.rb

@@ -0,0 +1,11 @@
+unless Class.method_defined? :descendants
+  require 'backports/2.1.0/module/singleton_class'
+
+  class Class
+    def descendants
+      ObjectSpace.each_object(singleton_class).reject do |klass|
+        klass.singleton_class? || klass == self
+      end
+    end
+  end
+end

data/lib/backports/3.1.0/class/subclasses.rb

@@ -0,0 +1,11 @@
+unless Class.method_defined? :subclasses
+  require 'backports/2.1.0/module/singleton_class'
+
+  class Class
+    def subclasses
+      ObjectSpace.each_object(singleton_class).reject do |klass|
+        klass.superclass != self || klass.singleton_class?
+      end
+    end
+  end
+end

data/lib/backports/3.1.0/class.rb

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

data/lib/backports/3.1.0/enumerable/compact.rb

@@ -0,0 +1,5 @@
+module Enumerable
+  def compact
+    reject { |elem| nil == elem }
+  end
+end unless Enumerable.method_defined? :compact

data/lib/backports/3.1.0/enumerable/tally.rb

@@ -0,0 +1,18 @@
+unless ([].tally({}) rescue false)
+  require 'backports/tools/arguments'
+  require 'backports/2.7.0/enumerable/tally'
+  require 'backports/tools/alias_method_chain'
+
+  module Enumerable
+    def tally_with_hash_argument(h = ::Backports::Undefined)
+      return tally_without_hash_argument if h.equal? ::Backports::Undefined
+
+      h = ::Backports.coerce_to_hash(h)
+
+      each_entry { |item| h[item] = h.fetch(item, 0) + 1 }
+
+      h
+    end
+    ::Backports.alias_method_chain self, :tally, :hash_argument
+  end
+end

data/lib/backports/3.1.0/enumerable.rb

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

data/lib/backports/3.1.0/file/dirname.rb

@@ -0,0 +1,16 @@
+unless (File.dirname("", 0) rescue false)
+  require 'backports/tools/alias_method_chain'
+
+  class File
+    def self.dirname_with_depth(path, depth = 1)
+      return dirname_without_depth(path) if depth == 1
+
+      raise ArgumentError, "negative depth #{depth}" if depth < 0
+
+      depth.times { path = dirname_without_depth(path) }
+
+      path
+    end
+    Backports.alias_method_chain singleton_class, :dirname, :depth
+  end
+end

data/lib/backports/3.1.0/file.rb

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

data/lib/backports/3.1.0/integer/try_convert.rb

@@ -0,0 +1,7 @@
+class Integer
+  require 'backports/tools/arguments'
+
+  def self.try_convert(obj)
+    ::Backports.try_convert(obj, ::Integer, :to_int)
+  end
+end unless Integer.respond_to? :try_convert

data/lib/backports/3.1.0/integer.rb

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

data/lib/backports/3.1.0/match_data/match.rb

@@ -0,0 +1,5 @@
+class MatchData
+  def match(index)
+    self[index]
+  end
+end unless MatchData.method_defined? :match

data/lib/backports/3.1.0/match_data/match_length.rb

@@ -0,0 +1,6 @@
+class MatchData
+  def match_length(index)
+    m = self[index]
+    m && m.length
+  end
+end unless MatchData.method_defined? :match_length

data/lib/backports/3.1.0/match_data.rb

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

data/lib/backports/3.1.0/struct/keyword_init.rb

@@ -0,0 +1,5 @@
+unless Struct.respond_to?(:keyword_init?)
+  def Struct.keyword_init?
+    new(1) && false rescue true
+  end
+end

data/lib/backports/3.1.0/struct.rb

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

data/lib/backports/3.1.0.rb

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

data/lib/backports/3.1.rb

@@ -0,0 +1 @@
+require 'backports/3.1.0'

data/lib/backports/latest.rb

@@ -1,4 +1,4 @@
 # require this file to load all the backports
 # NOTE: This is NOT recommended.
 # Best to require the specific backports you need
-require 'backports/2.7.0'
+require 'backports/3.1.0'