backports 3.23.0 → 3.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3ebf913e1cb86c25292dbf4106e69878788804f7d1e150ba7a41ea2743b4cce7
-  data.tar.gz: 5caf5e6bc8a92fd2ceff9eed115bdd504b3cac17478b56e798816744c17b5fab
+  metadata.gz: 8beaceec7c1ff3819b478521aa32a3777d2ea56a514ba9cb1431c5f89b27dd72
+  data.tar.gz: 228023f65abde2103588059a8b5ab2d882bc3616a9033fa3f3398cecabd4cc5d
 SHA512:
-  metadata.gz: aac88ca171d07ddcb74fd4fa71cbca9fe82f69f1d8c763ccaa54cd8b2328bae08af481f0011937f98fb2c79ee4484e17ac1d606d42f0a424d5677b91f50935f6
-  data.tar.gz: a7a179a5c9e51e767180d822b7dd2976312a44221f7f2e33a00f682e9f28e747fa7d00c4d81541af9011bb4aba4b12025b6f7e6f2c4050a94608897995ee8248
+  metadata.gz: ea8d7a6e510d0da24ca48a43436956c231800e651f55d439e6568f0859fb33366879df4179f41fab8a343f636c9c90784161931feb70d70a59d1ac4e937f8d59
+  data.tar.gz: 684267e5d459a983d616e5a6ed67fbe29fc4df0ed0b6c46610a07d4b5b5953d015f122aff10b91dc055cef72ef013458c2f66a9ff14ee39da22b3c8941d44279

data/CHANGELOG.md

@@ -4,9 +4,21 @@ All notable changes to this project will be documented in this file.
 
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [3.24.0](https://github.com/marcandre/backports/compare/v3.23.0...v3.24.0) - 2023-03-07
 
-Note: [Next major version (X-mas 2021?)](https://github.com/marcandre/backports/issues/139) may drop support for Ruby < 2.2, please comment.
+## Added
+
+- `Class#attached_object` (Ruby 3.2)
+- `Data` (Ruby 3.2)
+- `Enumerator.product` and `Enumerator::Product` (Ruby 3.2)
+- `Hash#shift` (with correct behavior when empty) (Ruby 3.2)
+- `Integer#ceildiv` (Ruby 3.2)
+- `MatchData#byteoffset` (Ruby 3.2)
+- `Symbol#start_with?` (Ruby 2.7)
+
+## Fixed
+
+- `Class#descendants` (removed, as it was not actually added in Ruby 3.1, sorry)
 
 ## [3.23.0](https://github.com/marcandre/backports/compare/v3.22.1...v3.23.0) - 2021-12-28
 

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
@@ -188,7 +213,9 @@ itself, JRuby and Rubinius.
 - `produce` (class method)
 
 #### Symbol
-  - `end_with?`
+
+- `end_with?`
+- `start_with?`
 
 #### Time
 

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.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/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.23.0" 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.23.0
+  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.
@@ -533,6 +533,7 @@ files:
 - 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
@@ -549,8 +550,6 @@ 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
@@ -565,6 +564,19 @@ files:
 - 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
@@ -612,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
@@ -627,8 +639,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.3
-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