backports 3.18.2 → 3.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 178159f05e53f3b3fc1c828a000e71a5f1860b058cf91c651f49b252ce05f130
-  data.tar.gz: b088578f04bd15de52d682caa6f9ba4fbe819a8d51fb66f89a8323019e40ca49
+  metadata.gz: 530520a5a0baa3962a2532fde75e3cb3ee2ceac6d3c492dc72a791f8655bf5d5
+  data.tar.gz: d850950054b40303ba73d92ab1bd1754d40b78df0fbbf4506b4c7ac40e93e2eb
 SHA512:
-  metadata.gz: 14187360b8a6f5a85f61a1ab8cac5121ce6bbc468dab22cefd8ec73c85cf834d1865a83da9fb3e2ddb3ec2adee5cbf90e4e8d22c254e14d543e5d9491d166736
-  data.tar.gz: b3456f62ca139a0beec8d4f8b3faff8ed7616da4fc3e31083bc9647a816c7c55ef8eb568f4f9dd101ff62e1279cc90e8f32ec67a67ccb14be3e902ef9af07ba1
+  metadata.gz: 2de1296503399822ed401d55b4482f7452f12414877564fa09237b349a951edd41bf06959a62498d335c241e13f706d7c59756519924facd599c5dfd3413fa47
+  data.tar.gz: 25fcaaa2d21ff9bee8b0b3328b0d73b63c451074a22938d26c80ec044b88583be429b2d2b1334f86035afd0880e534b3aca8be9203ebbc74221c71cafa5b0953

data/CHANGELOG.md

@@ -6,7 +6,41 @@ 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
 
@@ -14,7 +48,7 @@ Note: [Next major version (X-mas 2020)](https://github.com/marcandre/backports/i
 
 Require per ruby version now properly requiring 2.3.0 backports for `String` [#152]
 
-## [3.18.2](https://github.com/marcandre/backports/compare/v3.18.1...v3.18.2) - 2020-08-26
+## [3.18.1](https://github.com/marcandre/backports/compare/v3.18.1...v3.18.2) - 2020-06-22
 
 ### Fixed
 

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,17 @@ itself, JRuby and Rubinius.
   - `compact`, `compact!`
   - `transform_values`, `transform_values!`
 
+#### Queue
+  - `close`, `closed?`
+
 #### Regexp
   - `match?`
 
 #### String
   - `match?`
+  - `unpack1`
 
-#### 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.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.4.0/string/unpack1.rb

@@ -0,0 +1,7 @@
+unless String.method_defined? :unpack1
+  class String
+    def unpack1(fmt)
+      unpack(fmt)[0]
+    end
+  end
+end

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