backports 3.18.1 → 3.20.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1f8274a378c35a932287714e49499fdfe0f6b1cc0c3b10f77b3e0b321d05e80
-  data.tar.gz: 47596230657db9f20c4ccc221ac4e0d629bd8e0798ddadc6c94c096f3a3bd89f
+  metadata.gz: 4e5c6feae3c15c70a78dda33abcb10c737393eb6898d1756c8f3da4e5f604b25
+  data.tar.gz: 3339a5a0ae48803b9853627c096790f555a3a8f852af7b66c4331f683fcaac55
 SHA512:
-  metadata.gz: 6be9e6cde88338a14523a28bae4c2818f976aa81963001ec8370c137e0ca0d8e289049d76670f2d76b8619a4b27956b8e72a6bc186ba688095a6707a9ff804bf
-  data.tar.gz: 252030972b159d5380cd6a8b65807451cfdfbdaab179c2460ec07c150ec4de45db6c8d0f2fb36c1dd1caee078345514b71547564a9cc776ea84a0719e6767aa0
+  metadata.gz: d843af1e7bd02fe062f600df7b130c37b2ce41bf178831049bbcd57fadbb9cac1c73d9bf4feebca71dcb39998492442083822d60c1691e1e67f195e21005ea97
+  data.tar.gz: f37e52397480aeb259cf469093980cdef01500e845b94fbe90d67864f37323d2dcdbd59fa308ada90cc7c1820a02b20c07c4a647e986840f0c9222c1b4313a35

data/CHANGELOG.md

@@ -6,7 +6,53 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
-Note: [Next major version (X-mas 2020)](https://github.com/marcandre/backports/issues/139) might drop support for Ruby < 2.2, please comment.
+Note: [Next major version (X-mas 2021?)](https://github.com/marcandre/backports/issues/139) may drop support for Ruby < 2.2, please comment.
+
+## [3.20.1](https://github.com/marcandre/backports/compare/v3.20.0...v3.20.1) - 2021-01-03
+
+### Fixed
+
+* Added `Ractor.[]` and `[]=` [#161]
+* `Ractor.current` fixed from threads [#161]
+
+## [3.20.0](https://github.com/marcandre/backports/compare/v3.19.0...v3.20.0) - 2020-12-30
+
+### Added
+
+Ractor backport (all methods)
+
+## [3.19.0](https://github.com/marcandre/backports/compare/v3.18.2...v3.19.0) - 2020-12-28
+
+### Added
+
+* Ruby 3.0 backports
+
+  * Env
+    * `except`
+
+  * Hash
+    * `except`
+    * `transform_keys`, `transform_keys!` (with hash argument)
+
+  * Symbol
+    * `name`
+
+* Ruby 2.3 backports
+
+  * Queue
+    * `close`, `closed?` (affects `push`, `pop` and aliases)
+
+## [3.18.2](https://github.com/marcandre/backports/compare/v3.18.0...v3.18.2) - 2020-08-26
+
+### Fixed
+
+Require per ruby version now properly requiring 2.3.0 backports for `String` [#152]
+
+## [3.18.1](https://github.com/marcandre/backports/compare/v3.18.1...v3.18.2) - 2020-06-22
+
+### Fixed
+
+Fixed Changelog URI in gem manifest
 
 ## [3.18.0](https://github.com/marcandre/backports/compare/v3.17.2...v3.18.0) - 2020-06-22
 

data/Gemfile

@@ -9,8 +9,8 @@ group :test do
   gem 'test-unit'
 end
 
-if RUBY_VERSION >= '2.3.0'
+if RUBY_VERSION >= '2.4.0'
   group :development do
-    gem 'rubocop', '~> 0.80.0'
+    gem 'rubocop'
   end
 end

data/README.md

@@ -1,6 +1,7 @@
 # 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 use some of the new cool features in Ruby 2.7 while using 2.3.x?
+Yearning to write a gem using some new cool features in Ruby 3.0 while
+still supporting Ruby 2.5.x?
 Have some legacy code in Ruby 1.8 but can't live without `flat_map`?
 
 This gem is for you!
@@ -9,20 +10,20 @@ 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
-2020)](https://github.com/marcandre/backports/issues/139) will drop support
+2021?)](https://github.com/marcandre/backports/issues/139) may drop support
 for Ruby < 2.2.
 
 ## Loading backports
 
 ### Explicitly (recommended)
 
-For example, if you want to use transform_values and transform_keys, even in
+For example, if you want to use `transform_values` and `transform_keys`, even in
 Ruby implementations that don't include it:
 
     require 'backports/2.4.0/hash/transform_values'
     require 'backports/2.5.0/hash/transform_keys'
 
-This will enable Hash#transform_values and Hash#transform_keys, using the
+This will enable `Hash#transform_values` and `Hash#transform_keys`, using the
 native versions if available or otherwise provide a pure Ruby version.
 
 ### By Module
@@ -32,19 +33,17 @@ Class:
 
     require 'backports/2.3.0/hash'
 
-This will make sure that Hash responds to dig, fetch_values, <, <=, >, >= and
-to_proc
+This will make sure that Hash responds to `dig`, `fetch_values`, `to_proc` and comparisons.
 
 ### 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 2.7.0's standards:
+For example, to bring any version of Ruby mostly up to Ruby 3.0.0's standards:
 
-    require 'backports/2.7.0'
+    require 'backports/3.0.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 2.7.0 (for all versions of Ruby)!
+all the way up to Ruby 3.0.0 (for all versions of Ruby)!
 
 You may `require 'backports/latest'` as a
 shortcut to the latest Ruby version supported.
@@ -109,6 +108,24 @@ itself, JRuby and Rubinius.
 
 # Complete List of backports
 
+## Ruby 3.0 backports
+
+#### Env
+  - `except`
+
+#### Hash
+  - `except`
+  - `transform_keys`, `transform_keys!` (with hash argument)
+
+#### Ractor
+  - All methods, with the caveats:
+    - uses Ruby's `Thread` internally
+    - will not raise some errors when `Ractor` would (in particular `Ractor::IsolationError`)
+    - supported in Ruby 2.0+ only
+
+#### Symbol
+  - `name`
+
 ## Ruby 2.7 backports
 
 #### Array
@@ -118,7 +135,7 @@ itself, JRuby and Rubinius.
   - `clamp` (with range)
 
 #### Complex
-  - +<=>+
+  - `<=>`
 
 #### Enumerable
   - `filter_map`
@@ -150,10 +167,10 @@ itself, JRuby and Rubinius.
   - `then`
 
 #### Method
-  - +<<+, +>>+
+  - `<<`, `>>`
 
 #### Proc
-  - +<<+, +>>+
+  - `<<`, `>>`
 
 #### Range
   - `cover?` (with `Range` argument)
@@ -206,13 +223,16 @@ itself, JRuby and Rubinius.
   - `compact`, `compact!`
   - `transform_values`, `transform_values!`
 
+#### Queue
+  - `close`, `closed?`
+
 #### Regexp
   - `match?`
 
 #### String
   - `match?`
 
-#### FalseClass, Fixnum, Float, NilClass, TrueClass
+#### FalseClass, Fixnum, Bignum, Float, NilClass, TrueClass
   - `dup`
 
 ## Ruby 2.3 backports

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.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.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.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.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.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.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.4.0/bignum.rb

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

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.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.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.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.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.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.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.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.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.0/env.rb

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

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/hash.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