backports 3.15.0 → 3.24.1

data/lib/backports/2.7.0/complex/comparison.rb

@@ -0,0 +1,13 @@
+unless Complex.method_defined?(:<=>)
+  class Complex
+    def <=>(other)
+      return nil unless imaginary.zero?
+
+      if other.is_a?(Complex)
+        other.imaginary.zero? ? real <=> other.real : nil
+      else
+        real <=> other
+      end
+    end
+  end
+end

data/lib/backports/2.7.0/complex.rb

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

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

@@ -0,0 +1,14 @@
+require 'backports/1.9.1/enumerable/each_with_object' unless Enumerable.method_defined? :each_with_object
+
+unless Enumerable.method_defined? :filter_map
+  module Enumerable
+    def filter_map
+      return to_enum(:filter_map) unless block_given?
+
+      each_with_object([]) do |item, res|
+        processed = yield(item)
+        res << processed if processed
+      end
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+unless Enumerable.method_defined? :tally
+  module Enumerable
+    def tally
+      h = {}
+      # NB: By spec, tally should return default-less hash
+      each_entry { |item| h[item] = h.fetch(item, 0) + 1 }
+
+      h
+    end
+  end
+end

data/lib/backports/2.7.0/enumerable.rb

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

data/lib/backports/2.7.0/enumerator/produce.rb

@@ -0,0 +1,20 @@
+Enumerator = Enumerable::Enumerator unless Object.const_defined? :Enumerator # For 1.8.x
+
+unless Enumerator.respond_to?(:produce)
+  require 'backports/tools/arguments'
+
+  class Enumerator
+    def self.produce(initial = Backports::Undefined)
+      raise ArgumentError, 'no block given' unless block_given?
+
+      Enumerator.new do |y|
+        val = initial == Backports::Undefined ? yield() : initial
+
+        loop do
+          y << val
+          val = yield(val)
+        end
+      end
+    end
+  end
+end

data/lib/backports/2.7.0/enumerator.rb

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

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/start_with.rb

@@ -0,0 +1,9 @@
+require 'backports/1.8.7/string/start_with' unless String.method_defined? :end_with?
+
+unless Symbol.method_defined?(:start_with?)
+  class Symbol
+    def start_with?(*suffixes)
+      to_s.start_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/time/ceil.rb

@@ -0,0 +1,10 @@
+unless Time.method_defined?(:ceil)
+  class Time
+    def ceil(ndigits = 0)
+      # Imitate value.ceil(ndigits) which does not exist in Ruby < 2.4
+      sceil = (subsec * 10**ndigits).ceil.to_r / 10**ndigits
+      change = sceil - subsec
+      self + change
+    end
+  end
+end

data/lib/backports/2.7.0/time/floor.rb

@@ -0,0 +1,7 @@
+unless Time.method_defined?(:floor)
+  class Time
+    def floor(ndigits = 0)
+      self - subsec.modulo(10**-ndigits)
+    end
+  end
+end

data/lib/backports/2.7.0.rb

@@ -0,0 +1,3 @@
+# 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/2.7.rb

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

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/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/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/3.2.0/class/attached_object.rb

@@ -0,0 +1,10 @@
+unless Class.method_defined? :attached_object
+  require 'backports/2.1.0/module/singleton_class'
+
+  class Class
+    def attached_object
+      raise TypeError, "`#{self}' is not a singleton class" unless singleton_class?
+      ObjectSpace.each_object(self).first
+    end
+  end
+end

data/lib/backports/3.2.0/class.rb

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

data/lib/backports/3.2.0/data.rb

@@ -0,0 +1,144 @@
+original_verbosity = $VERBOSE
+$VERBOSE = nil
+if defined?(::Data) && !::Data.respond_to?(:define)
+  Object.send(:remove_const, :Data)
+end
+class ::Data
+end
+
+module Backports
+  Data = ::Data
+end
+$VERBOSE = original_verbosity
+
+unless ::Backports::Data.respond_to?(:define)
+  require "backports/2.7.0/symbol/end_with"
+  require "backports/2.5.0/module/define_method"
+
+  class ::Backports::Data
+    def deconstruct
+      @__members__.values
+    end
+
+    def deconstruct_keys(keys_or_nil)
+      return @__members__ unless keys_or_nil
+
+      raise TypeError, "Expected symbols" unless keys_or_nil.is_a?(Array) && keys_or_nil.all? {|s| s.is_a?(Symbol)}
+      @__members__.slice(*keys_or_nil)
+    end
+
+    def self.define(*members, &block)
+      members.each do |m|
+        raise TypeError, "#{m} is not a Symbol" unless m.is_a?(Symbol) || m.is_a?(String)
+        raise ArgumentError, "invalid data member: #{m}" if m.end_with?("=")
+      end
+      members = members.map(&:to_sym)
+      raise ArgumentError, "duplicate members" if members.uniq!
+
+      klass = instance_eval <<-"end_define", __FILE__, __LINE__ + 1
+        Class.new(::Backports::Data) do     # Class.new(::Data) do
+          def self.members       #   def self.members
+            #{members.inspect}   #     [:a_member, :another_member]
+          end                    #   end
+        end                      # end
+      end_define
+
+      members.each do |m|
+        klass.define_method(m) { @__members__[m]}
+      end
+
+      class << klass
+        def new(*values, **named_values)
+          if named_values.empty?
+            if values.size > members.size
+              raise ArgumentError, "wrong number of arguments (given #{values.size}, expected 0..#{members.size})"
+            end
+            super(**members.first(values.size).zip(values).to_h)
+          else
+            unless values.empty?
+              raise ArgumentError, "wrong number of arguments (given #{values.size}, expected 0)"
+            end
+            super(**named_values)
+          end
+        end
+        undef :define
+      end
+
+      klass.class_eval(&block) if block
+
+      klass
+    end
+
+    def eql?(other)
+      return false unless other.instance_of?(self.class)
+
+      @__members__.eql?(other.to_h)
+    end
+
+    def ==(other)
+      return false unless other.instance_of?(self.class)
+
+      @__members__ == other.to_h
+    end
+
+    def hash
+      @__members__.hash
+    end
+
+    def initialize(**named_values)
+      given = named_values.keys
+      missing = members - given
+      unless missing.empty?
+        missing = missing.map(&:inspect).join(", ")
+        raise ArgumentError, "missing keywords: #{missing}"
+      end
+      if members.size < given.size
+        extra = (given - members).map(&:inspect).join(", ")
+        raise ArgumentError, "unknown keywords: #{extra}"
+      end
+      @__members__ = named_values.freeze
+      freeze
+    end
+
+    # Why is `initialize_copy` specialized in MRI and not just `initialize_dup`?
+    # Let's follow the pattern anyways
+    def initialize_copy(other)
+      @__members__ = other.to_h
+      freeze
+    end
+
+    def inspect
+      data = @__members__.map {|k, v| "#{k}=#{v.inspect}"}.join(", ")
+      space = data != "" && self.class.name ? " " : ""
+      "#<data #{self.class.name}#{space}#{data}>"
+    end
+
+    def marshal_dump
+      @__members__
+    end
+
+    def marshal_load(members)
+      @__members__ = members
+      freeze
+    end
+
+    # class method defined in `define`
+    def members
+      self.class.members
+    end
+
+    class << self
+      private :new
+    end
+
+    def to_h(&block)
+      @__members__.to_h(&block)
+    end
+
+    def with(**update)
+      return self if update.empty?
+
+      self.class.new(**@__members__.merge(update))
+    end
+  end
+end

data/lib/backports/3.2.0/enumerator/product.rb

@@ -0,0 +1,64 @@
+unless Enumerator.method_defined? :product
+  if RUBY_VERSION >= '2.7'
+    instance_eval <<-EOT, __FILE__, __LINE__ + 1
+      def Enumerator.product(*enums, **nil, &block)
+        Enumerator::Product.new(*enums).each(&block)
+      end
+    EOT
+  else
+    def Enumerator.product(*enums, &block)
+      Enumerator::Product.new(*enums).each(&block)
+    end
+  end
+
+  class Enumerator::Product < Enumerator
+    if RUBY_VERSION >= '2.7'
+      module_eval <<-EOT, __FILE__, __LINE__ + 1
+        def initialize(*enums, **nil)
+          @__enums = enums
+        end
+      EOT
+    else
+      # rubocop:disable Lint/MissingSuper
+      def initialize(*enums)
+        @__enums = enums
+      end
+      # rubocop:enable Lint/MissingSuper
+    end
+
+    def each(&block)
+      return self unless block
+      __execute(block, [], @__enums)
+    end
+
+    def __execute(block, values, enums)
+      if enums.empty?
+        block.yield values
+      else
+        enum, *enums = enums
+        enum.each do |val|
+          __execute(block, [*values, val], enums)
+        end
+      end
+      nil
+    end
+    private :__execute
+
+    def size
+      total_size = 1
+      @__enums.each do |enum|
+        size = enum.size
+        return size if size == nil || size == Float::INFINITY
+        total_size *= size
+      end
+      total_size
+    end
+
+    def rewind
+      @__enums.reverse_each do |enum|
+        enum.rewind if enum.respond_to?(:rewind)
+      end
+      self
+    end
+  end
+end

data/lib/backports/3.2.0/enumerator.rb

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

data/lib/backports/3.2.0/hash/shift.rb

@@ -0,0 +1,10 @@
+if Hash.new(42).shift
+  require 'backports/tools/alias_method_chain'
+
+  class Hash
+    def shift_with_correct_behaviour_when_empty
+      shift_without_correct_behaviour_when_empty unless empty?
+    end
+    Backports.alias_method_chain self, :shift, :correct_behaviour_when_empty
+  end
+end

data/lib/backports/3.2.0/hash.rb

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