backports 3.24.1 → 3.25.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e2a822b77667d9e87ca05ecb722dc91204f4ef72e88575b534d969bd0c2784f1
-  data.tar.gz: 47bb61fa96fde1da093d230fd7fab4f45dfbe58bf89ac1db56dceb9d0525a7e0
+  metadata.gz: 36ede0c424a25b64633c443a48c716c2876ac448c5a34544c842f5a5710ff03c
+  data.tar.gz: c8d3d198e817f6dc9d37f21519d84e1252e53482969a6759e25774a16fec93e4
 SHA512:
-  metadata.gz: 45939ddca1b04d95d536e652780205d8e53fd154705ce0d28fa79abcaedd628375e81abe5972638edf3d57cdf874426c8b8756156a4f6691c1682843dbdf0ad1
-  data.tar.gz: 9e0f10a128b5871c015beb2c77838599f0877213a998d983fe18433b8b09df48e974e15dd9b97fb0a11af873c367e2908558bd48fe9184627a48ab5c79ffaed5
+  metadata.gz: c5a36ace358abdf8dbce16371ee1f49c07d23373e537322f8079578e283d5e095ac06261b572b3574e88543148e4c1f5127204aecbfdbd817d7dcdef72574fcf
+  data.tar.gz: abe5101c680b15fe50d6743f7d5b702a3726a4b5c0b13c4e4d2474aa6f1d6f693557fcd74dad46a3b2b050628094fe668b23d73f7f005e74d99734891c8a5ee9

data/CHANGELOG.md

@@ -4,6 +4,14 @@ 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).
 
+## [3.25.0](https://github.com/marcandre/backports/compare/v3.24.0...v3.25.0) - 2024-03-05
+
+## Added
+
+- `MatchData#named_captures` (with `symbolize_keys` option, Ruby 3.3)
+- `Range.reverse_each` (Ruby 3.3)
+- `Range#overlap?` (Ruby 3.3)
+
 ## [3.24.0](https://github.com/marcandre/backports/compare/v3.23.0...v3.24.0) - 2023-03-07
 
 ## Added

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.2 while
+Yearning to write a gem using some new cool features in Ruby 3.3 while
 still supporting Ruby 2.5.x?
 Have some legacy code in Ruby 1.8 but can't live without `flat_map`?
 
@@ -9,10 +9,6 @@ This gem is for you!
 The goal of 'backports' is to make it easier to write ruby code that runs
 across different versions of Ruby.
 
-Note: [Next major version (X-mas
-2021?)](https://github.com/marcandre/backports/issues/139) may drop support
-for Ruby < 2.2.
-
 ## Loading backports
 
 ### Explicitly (recommended)
@@ -38,12 +34,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.2.0's standards:
+For example, to bring any version of Ruby mostly up to Ruby 3.3.0's standards:
 
-    require 'backports/3.2.0'
+    require 'backports/3.3.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.2.0 (for all versions of Ruby)!
+all the way up to Ruby 3.3.0 (for all versions of Ruby)!
 
 You may `require 'backports/latest'` as a
 shortcut to the latest Ruby version supported.
@@ -109,6 +105,17 @@ itself, JRuby and Rubinius.
 
 # Complete List of backports
 
+## Ruby 3.3 backports
+
+#### MatchData
+
+- `named_captures` (with `symbolize_keys` option)
+
+#### Range
+
+- `reverse_each` (with correct handling of endless Ranges)
+- `overlap?`
+
 ## Ruby 3.2 backports
 
 #### Class

data/lib/backports/3.1.0.rb

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

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

@@ -1,13 +1,34 @@
 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)
+    instance_eval <<-'EOT', __FILE__, __LINE__ + 1
+      def Enumerator.product(*enums, **kwargs, &block)
+        if kwargs && !kwargs.empty?
+          raise ArgumentError, "unknown keywords: #{kwargs.keys.map(&:inspect).join(', ')}"
+        end
+        product = Enumerator::Product.new(*enums)
+
+        if block_given?
+          product.each(&block)
+          return nil
+        end
+
+        product
       end
     EOT
   else
     def Enumerator.product(*enums, &block)
-      Enumerator::Product.new(*enums).each(&block)
+      kwargs = enums[-1]
+      if kwargs.is_a?(Hash) && !kwargs.empty?
+        raise ArgumentError, "unknown keywords: #{kwargs.keys.map(&:inspect).join(', ')}"
+      end
+      product = Enumerator::Product.new(*enums)
+
+      if block_given?
+        product.each(&block)
+        return nil
+      end
+
+      product
     end
   end
 
@@ -29,6 +50,7 @@ unless Enumerator.method_defined? :product
     def each(&block)
       return self unless block
       __execute(block, [], @__enums)
+      self
     end
 
     def __execute(block, values, enums)
@@ -47,18 +69,36 @@ unless Enumerator.method_defined? :product
     def size
       total_size = 1
       @__enums.each do |enum|
+        return nil unless enum.respond_to?(:size)
         size = enum.size
-        return size if size == nil || size == Float::INFINITY
+        return size if size == 0 || size == nil || size == Float::INFINITY || size == -Float::INFINITY
+        return nil unless size.is_a?(Integer)
         total_size *= size
       end
       total_size
     end
 
     def rewind
-      @__enums.reverse_each do |enum|
+      @__enums.each do |enum|
         enum.rewind if enum.respond_to?(:rewind)
       end
       self
     end
+
+    private def initialize_copy(other)
+      return self if equal?(other)
+
+      raise TypeError unless Product === other
+
+      super(other)
+
+      other_enums = other.instance_variable_get(:@__enums)
+
+      raise ArgumentError, "uninitialized product" unless other_enums
+
+      @__enums = other_enums
+
+      self
+    end
   end
 end

data/lib/backports/3.2.0.rb

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

data/lib/backports/3.3.0/match_data/named_captures.rb

@@ -0,0 +1,12 @@
+if (MatchData.instance_method(:named_captures).arity == 0 rescue false)
+  require 'backports/tools/alias_method_chain'
+
+  class MatchData
+    def named_captures_with_symbolize_option(symbolize_keys: false)
+      captures = named_captures_without_symbolize_option
+      captures.transform_keys!(&:to_sym) if symbolize_keys
+      captures
+    end
+    Backports.alias_method_chain self, :named_captures, :symbolize_option
+  end
+end

data/lib/backports/3.3.0/match_data.rb

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

data/lib/backports/3.3.0/range/overlap.rb

@@ -0,0 +1,18 @@
+unless Range.method_defined? :overlap?
+  class Range
+    def overlap?(other)
+      raise TypeError, "wrong argument type #{other.class} (expected Range)" unless other.is_a?(Range)
+
+      [
+        [other.begin, self.end, exclude_end?],
+        [self.begin, other.end, other.exclude_end?],
+        [self.begin, self.end, exclude_end?],
+        [other.begin, other.end, other.exclude_end?],
+      ].all? do |from, to, excl|
+        less = (from || -Float::INFINITY) <=> (to || Float::INFINITY)
+        less = +1 if less == 0 && excl
+        less && less <= 0
+      end
+    end
+  end
+end

data/lib/backports/3.3.0/range/reverse_each.rb

@@ -0,0 +1,20 @@
+unless (Range.new(nil, 3) rescue [:ok]).reverse_each.first
+  require 'backports/tools/alias_method_chain'
+
+  class Range
+    def reverse_each_with_endless_handling(&block)
+      case self.end
+      when nil
+        raise "Hey"
+      when Float::INFINITY
+        raise "Hey"
+      when Integer
+        delta = exclusive? ? 1 : 0
+        ((self.end - delta)..(self.begin)).each(&block)
+      else
+        reverse_each_without_endless_handling(&block)
+      end
+    end
+    Backports.alias_method_chain self, :reverse_each, :endless_handling
+  end
+end

data/lib/backports/3.3.0/range.rb

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

data/lib/backports/3.3.0.rb

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

data/lib/backports/3.3.rb

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

data/lib/backports/version.rb

@@ -1,3 +1,3 @@
 module Backports
-  VERSION = "3.24.1" unless Backports.constants.include? :VERSION # the guard is against a redefinition warning that happens on Travis
+  VERSION = "3.25.1" 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.24.1
+  version: 3.25.1
 platform: ruby
 authors:
 - Marc-André Lafortune
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-04-05 00:00:00.000000000 Z
+date: 2025-03-20 00:00:00.000000000 Z
 dependencies: []
 description: Essential backports that enable many of the nice features of Ruby for
   earlier versions.
@@ -577,6 +577,13 @@ files:
 - lib/backports/3.2.0/match_data.rb
 - lib/backports/3.2.0/match_data/byteoffset.rb
 - lib/backports/3.2.rb
+- lib/backports/3.3.0.rb
+- lib/backports/3.3.0/match_data.rb
+- lib/backports/3.3.0/match_data/named_captures.rb
+- lib/backports/3.3.0/range.rb
+- lib/backports/3.3.0/range/overlap.rb
+- lib/backports/3.3.0/range/reverse_each.rb
+- lib/backports/3.3.rb
 - lib/backports/basic_object.rb
 - lib/backports/force/array_map.rb
 - lib/backports/force/enumerable_map.rb
@@ -624,7 +631,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
@@ -639,8 +646,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
-signing_key: 
+rubygems_version: 3.5.11
+signing_key:
 specification_version: 4
 summary: Backports of Ruby features for older Ruby.
 test_files: []