backports 3.22.1 → 3.24.0

data/README.md

@@ -1,6 +1,6 @@
 # Backports Library [<img src="https://travis-ci.org/marcandre/backports.svg?branch=master">](https://travis-ci.org/marcandre/backports) [<img src="https://badge.fury.io/rb/backports.svg" alt="Gem Version" />](http://badge.fury.io/rb/backports) [![Tidelift](https://tidelift.com/badges/package/rubygems/backports)](https://tidelift.com/subscription/pkg/rubygems-backports?utm_source=rubygems-backports&utm_medium=referral&utm_campaign=readme)
 
-Yearning to write a gem using some new cool features in Ruby 3.1 while
+Yearning to write a gem using some new cool features in Ruby 3.2 while
 still supporting Ruby 2.5.x?
 Have some legacy code in Ruby 1.8 but can't live without `flat_map`?
 
@@ -38,12 +38,12 @@ This will make sure that Hash responds to `dig`, `fetch_values`, `to_proc` and c
 ### Up to a specific Ruby version (for quick coding)
 
 You can load all backports up to a specific version.
-For example, to bring any version of Ruby mostly up to Ruby 3.1.0's standards:
+For example, to bring any version of Ruby mostly up to Ruby 3.2.0's standards:
 
-    require 'backports/3.1.0'
+    require 'backports/3.2.0'
 
 This will bring in all the features of 1.8.7 and many features of Ruby 1.9.x
-all the way up to Ruby 3.1.0 (for all versions of Ruby)!
+all the way up to Ruby 3.2.0 (for all versions of Ruby)!
 
 You may `require 'backports/latest'` as a
 shortcut to the latest Ruby version supported.
@@ -109,6 +109,32 @@ itself, JRuby and Rubinius.
 
 # Complete List of backports
 
+## Ruby 3.2 backports
+
+#### Class
+
+- `attached_object`
+
+#### Data
+
+- Complete class
+
+#### Enumerator
+
+- `Enumerator.product` and `Enumerator::Product`
+
+#### Hash
+
+- `shift` (with correct behavior when empty)
+
+#### Integer
+
+- `ceildiv`
+
+#### MatchData
+
+- `byteoffset`
+
 ## Ruby 3.1 backports
 
 #### Array
@@ -117,7 +143,6 @@ itself, JRuby and Rubinius.
 
 #### Class
 
-- `descendants`
 - `subclasses`
 
 #### Enumerable
@@ -129,6 +154,10 @@ itself, JRuby and Rubinius.
 
 - `dirname` (with depth argument)
 
+#### Integer
+
+- `try_convert`
+
 #### MatchData
 
 - `match`
@@ -183,6 +212,11 @@ itself, JRuby and Rubinius.
 
 - `produce` (class method)
 
+#### Symbol
+
+- `end_with?`
+- `start_with?`
+
 #### Time
 
 - `floor`, `ceil`

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/3.0.0/symbol/name.rb

@@ -1,11 +1,21 @@
 unless Symbol.method_defined? :name
-  def Backports.symbol_names
-    @symbol_names ||= ObjectSpace::WeakMap.new
-  end
+  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
+    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.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.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,149 @@
+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?
+            case values.size <=> members.size
+            when -1
+              missing = members[values.size..-1].map(:inspect).join(", ")
+              raise ArgumentError, "Missing keywords: #{missing}"
+            when +1
+              raise ArgumentError, "wrong number of arguments (given #{values.size}, expected 0..#{members.size})"
+            when 0
+              super(**members.zip(values).to_h)
+            end
+          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

data/lib/backports/3.2.0/integer/ceildiv.rb

@@ -0,0 +1,7 @@
+unless Integer.method_defined? :ceildiv
+  class Integer
+    def ceildiv(arg)
+      fdiv(arg).ceil
+    end
+  end
+end

data/lib/backports/3.2.0/integer.rb

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

data/lib/backports/3.2.0/match_data/byteoffset.rb

@@ -0,0 +1,12 @@
+unless MatchData.method_defined? :byteoffset
+  class MatchData
+    def byteoffset(n)
+      if (char_start_offset = self.begin(n))
+        char_end_offset = self.end(n)
+        [string[0, char_start_offset].bytesize, string[0, char_end_offset].bytesize]
+      else
+        [nil, nil]
+      end
+    end
+  end
+end

data/lib/backports/3.2.0/match_data.rb

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

data/lib/backports/3.2.0.rb

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

data/lib/backports/3.2.rb

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

data/lib/backports/version.rb

@@ -1,3 +1,3 @@
 module Backports
-  VERSION = "3.22.1" unless Backports.constants.include? :VERSION # the guard is against a redefinition warning that happens on Travis
+  VERSION = "3.24.0" unless Backports.constants.include? :VERSION # the guard is against a redefinition warning that happens on Travis
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: backports
 version: !ruby/object:Gem::Version
-  version: 3.22.1
+  version: 3.24.0
 platform: ruby
 authors:
 - Marc-André Lafortune
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-28 00:00:00.000000000 Z
+date: 2023-03-07 00:00:00.000000000 Z
 dependencies: []
 description: Essential backports that enable many of the nice features of Ruby for
   earlier versions.
@@ -531,6 +531,9 @@ files:
 - lib/backports/2.7.0/enumerable/tally.rb
 - lib/backports/2.7.0/enumerator.rb
 - lib/backports/2.7.0/enumerator/produce.rb
+- lib/backports/2.7.0/symbol.rb
+- lib/backports/2.7.0/symbol/end_with.rb
+- lib/backports/2.7.0/symbol/start_with.rb
 - lib/backports/2.7.0/time/ceil.rb
 - lib/backports/2.7.0/time/floor.rb
 - lib/backports/2.7.rb
@@ -547,20 +550,33 @@ files:
 - lib/backports/3.1.0.rb
 - lib/backports/3.1.0/array.rb
 - lib/backports/3.1.0/array/intersect.rb
-- lib/backports/3.1.0/class.rb
-- lib/backports/3.1.0/class/descendants.rb
 - lib/backports/3.1.0/class/subclasses.rb
 - lib/backports/3.1.0/enumerable.rb
 - lib/backports/3.1.0/enumerable/compact.rb
 - lib/backports/3.1.0/enumerable/tally.rb
 - lib/backports/3.1.0/file.rb
 - lib/backports/3.1.0/file/dirname.rb
+- lib/backports/3.1.0/integer.rb
+- lib/backports/3.1.0/integer/try_convert.rb
 - lib/backports/3.1.0/match_data.rb
 - lib/backports/3.1.0/match_data/match.rb
 - lib/backports/3.1.0/match_data/match_length.rb
 - lib/backports/3.1.0/struct.rb
 - lib/backports/3.1.0/struct/keyword_init.rb
 - lib/backports/3.1.rb
+- lib/backports/3.2.0.rb
+- lib/backports/3.2.0/class.rb
+- lib/backports/3.2.0/class/attached_object.rb
+- lib/backports/3.2.0/data.rb
+- lib/backports/3.2.0/enumerator.rb
+- lib/backports/3.2.0/enumerator/product.rb
+- lib/backports/3.2.0/hash.rb
+- lib/backports/3.2.0/hash/shift.rb
+- lib/backports/3.2.0/integer.rb
+- lib/backports/3.2.0/integer/ceildiv.rb
+- lib/backports/3.2.0/match_data.rb
+- lib/backports/3.2.0/match_data/byteoffset.rb
+- lib/backports/3.2.rb
 - lib/backports/basic_object.rb
 - lib/backports/force/array_map.rb
 - lib/backports/force/enumerable_map.rb
@@ -608,7 +624,7 @@ metadata:
   changelog_uri: https://github.com/marcandre/backports/blob/master/CHANGELOG.md
   source_code_uri: https://github.com/marcandre/backports
   bug_tracker_uri: https://github.com/marcandre/backports/issues
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -623,8 +639,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
-signing_key:
+rubygems_version: 3.1.6
+signing_key: 
 specification_version: 4
 summary: Backports of Ruby features for older Ruby.
 test_files: []

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

@@ -1,11 +0,0 @@
-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