backports 3.16.1 → 3.18.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2118947fbadf4aa13865b5ceec7be5ed416ab4ada72647c076bcc277c034abfc
-  data.tar.gz: c6237a756a22de924ef77c9b0027a55d55a9c2386286ef2ba86c8967b75cb2e3
+  metadata.gz: b1f8274a378c35a932287714e49499fdfe0f6b1cc0c3b10f77b3e0b321d05e80
+  data.tar.gz: 47596230657db9f20c4ccc221ac4e0d629bd8e0798ddadc6c94c096f3a3bd89f
 SHA512:
-  metadata.gz: 324ce7e19fabc56f101dcf2b567f1b3e2b75b7d165351a6b8526df050d8646a13a3645b5aa747e51ded19f9e486adea6b9612f31798a5660135ededc837f2888
-  data.tar.gz: 6455e9141e9a2fb66a68be72184caedc36529027459590d35be9ebc462967424ed6cb736b2fd836b2f998e616985e473c895d27f56fafd55c4ee13f838e761ec
+  metadata.gz: 6be9e6cde88338a14523a28bae4c2818f976aa81963001ec8370c137e0ca0d8e289049d76670f2d76b8619a4b27956b8e72a6bc186ba688095a6707a9ff804bf
+  data.tar.gz: 252030972b159d5380cd6a8b65807451cfdfbdaab179c2460ec07c150ec4de45db6c8d0f2fb36c1dd1caee078345514b71547564a9cc776ea84a0719e6767aa0

data/CHANGELOG.md

@@ -6,13 +6,46 @@ 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) will drop support for Ruby < 2.2.
+Note: [Next major version (X-mas 2020)](https://github.com/marcandre/backports/issues/139) might drop support for Ruby < 2.2, please comment.
+
+## [3.18.0](https://github.com/marcandre/backports/compare/v3.17.2...v3.18.0) - 2020-06-22
+
+### Changed
+
+Require per ruby version / all requires now check `RUBY_VERSION` to be more efficient [#149]
+
+## [3.17.2](https://github.com/marcandre/backports/compare/v3.17.1...v3.17.2) - 2020-04-09
+
+### Fixed
+
+Fix Range#cover (Ruby 2.6.0) [#148]
+
+## [3.17.1](https://github.com/marcandre/backports/compare/v3.17.0...v3.17.1) - 2020-04-09
+
+### Fixed
+
+Fix Range#size (Ruby 2.0) on Ruby 1.8.7 [#144]
+
+## [3.17.0](https://github.com/marcandre/backports/compare/v3.16.2...v3.17.0) - 2020-03-06
+
+### Added
+
+* Ruby 2.6 backports
+
+  * Range
+    * `cover?` (with `Range` argument)
+
+### Changed
+
+Requiring features for a particular version of Ruby or `latest` is un-deprecated but
+instead simply warned in verbose mode.
 
 ## [3.16.1](https://github.com/marcandre/backports/compare/v3.16.0...v3.16.1) - 2020-02-16
 
 ### Deprecated
 
-Officially deprecate requiring features for a particular version of Ruby, `latest`, `std_lib` or `rails` backports
+Officially deprecate requiring features for a particular version of Ruby, `latest`, `std_lib` or `rails` backports.
+Partly un-deprecated in 3.17.0!
 
 ### Fixed
 

data/Gemfile

@@ -1,23 +1,16 @@
 source "http://rubygems.org"
 
-# Declare your gem's dependencies in backports.gemspec.
-# Bundler will treat runtime dependencies like base dependencies, and
-# development dependencies will be added by default to the :development group.
 gemspec
 
-# jquery-rails is used by the dummy application
 group :test do
   gem "rake"
   gem 'mspec'
   gem 'activesupport', '~>3.2.0'
-  gem 'minitest', '< 5.0.0', :require => false
-  gem 'test-unit', '~>2.1.1.0'
+  gem 'test-unit'
 end
 
-# Declare any dependencies that are still in development here instead of in
-# your gemspec. These might include edge Rails or gems from your path or
-# Git. Remember to move these dependencies to your gemspec before releasing
-# your gem to rubygems.org.
-
-# To use debugger
-# gem 'ruby-debug19', :require => 'ruby-debug'
+if RUBY_VERSION >= '2.3.0'
+  group :development do
+    gem 'rubocop', '~> 0.80.0'
+  end
+end

data/README.md

@@ -1,4 +1,4 @@
-# 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)
+# 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?
 Have some legacy code in Ruby 1.8 but can't live without `flat_map`?
@@ -35,20 +35,22 @@ Class:
 This will make sure that Hash responds to dig, fetch_values, <, <=, >, >= and
 to_proc
 
-### Up to a specific Ruby version (deprecated)
+### Up to a specific Ruby version (for quick coding)
 
-Although this is deprecated, you can load all backports up to a specific version.
+You can load all backports up to a specific version.
 For example, to bring any
-version of Ruby mostly up to Ruby 2.4.0's standards:
+version of Ruby mostly up to Ruby 2.7.0's standards:
 
-    require 'backports/2.4.0'
+    require 'backports/2.7.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.4.0 (for all versions of Ruby)!
+all the way up to Ruby 2.7.0 (for all versions of Ruby)!
 
-While it is not recommended, you may `require 'backports/latest'` as a
-shortcut to the latest Ruby version supported. This is equivalent to the
-deprecated `require 'backports'`.
+You may `require 'backports/latest'` as a
+shortcut to the latest Ruby version supported.
+
+*Note*: For production / public gems, it is highly recommended you only require
+the backports you need explicitly.
 
 *Note*: Although I am a Ruby committer, this gem is a personal project and is
 not endorsed by ruby-core.
@@ -63,14 +65,14 @@ Goals for backported features:
 Let's be a bit more precise about the "breaking code" business. It is of
 course entirely possible that code will break. In particular, you may be
 distinguishing parameters with duck typing, but a builtin class may, in the
-future, be responding to a particular call. Here's {an exemple from
-Rails}(https://github.com/rails/rails/blob/a4b55827721a5967299f3c1531afb3d6d81
-e4ac0/activerecord/lib/active_record/associations/association.rb#L155-L159)
+future, be responding to a particular call. Here's [an example from Rails][]
 that is relying on the fact that Proc and Method respond to :to_proc and Hash
 isn't. That is, until Ruby 2.3... This old version of Rails therefore won't
 work on Ruby 2.3, or on older Rubies with that the `2.3.0/hash/to_proc`
 loaded...
 
+[an example from rails]: https://github.com/rails/rails/blob/a4b55827721a5967299f3c1531afb3d6d81e4ac0/activerecord/lib/active_record/associations/association.rb#L155-L159
+
 For Ruby < 2.0, there are some real incompatibilities. For example,
 `Module::instance_methods` which returns strings in 1.8 and symbols in 1.9. No
 change can be made without the risk of breaking existing code. Such
@@ -109,239 +111,242 @@ itself, JRuby and Rubinius.
 
 ## Ruby 2.7 backports
 
-*  Array
-  * `intersection`
+#### Array
+  - `intersection`
 
-*  Comparable
-  * `clamp` (with range)
+#### Comparable
+  - `clamp` (with range)
 
-*  Complex
-  * +<=>+
+#### Complex
+  - +<=>+
 
-*  Enumerable
-  * `filter_map`
-  * `tally`
+#### Enumerable
+  - `filter_map`
+  - `tally`
 
-*  Enumerator
-  * `produce` (class method)
+#### Enumerator
+  - `produce` (class method)
 
-*  Time
-  * `floor`, `ceil`
+#### Time
+  - `floor`, `ceil`
 
 ## Ruby 2.6 backports
 
-*  Array
-  * `difference`, `union`
-  * `to_h` (with block)
+#### Array
+  - `difference`, `union`
+  - `to_h` (with block)
+
+#### Enumerable
+  - `chain`
+  - `to_h` (with block)
 
-*  Enumerable
-  * `chain`
-  * `to_h` (with block)
+#### Enumerator::Chain (use Enumerable#chain)
 
-*  Enumerator::Chain (use Enumerable#chain)
+#### Hash
+  - `merge`, `merge!`/`update` (with multiple arguments)
+  - `to_h` (with block)
 
-*  Hash
-  * `merge`, `merge!`/`update` (with multiple arguments)
-  * `to_h` (with block)
+#### Kernel
+  - `then`
 
-*  Kernel
-  * `then`
+#### Method
+  - +<<+, +>>+
 
-*  Method
-  * +<<+, +>>+
+#### Proc
+  - +<<+, +>>+
 
-*  Proc
-  * +<<+, +>>+
+#### Range
+  - `cover?` (with `Range` argument)
 
 ## Ruby 2.5 backports
 
-*  Array
-  * `append`, `prepend`
+#### Array
+  - `append`, `prepend`
 
-*  Dir
-  * `children`, `each_child`
+#### Dir
+  - `children`, `each_child`
 
-*  Enumerable
-  * `any?`, `all?`, `none?`, `one?` (with pattern argument)
+#### Enumerable
+  - `any?`, `all?`, `none?`, `one?` (with pattern argument)
 
-*  Hash
-  * `slice`
-  * `transform_keys`
+#### Hash
+  - `slice`
+  - `transform_keys`
 
-*  Integer
-  * `sqrt`
-  * `allbits?`, `anybits?` and `nobits?`
+#### Integer
+  - `sqrt`
+  - `allbits?`, `anybits?` and `nobits?`
 
-*  Kernel
-  * `yield_self`
+#### Kernel
+  - `yield_self`
 
-*  Module
-  * `attr`, `attr_accessor`, `attr_reader`, `attr_writer` (now public)
-  * `define_method`, `alias_method`, `undef_method`, `remove_method` (now
+#### Module
+  - `attr`, `attr_accessor`, `attr_reader`, `attr_writer` (now public)
+  - `define_method`, `alias_method`, `undef_method`, `remove_method` (now
         public)
 
-*  String
-  * `delete_prefix`, `delete_prefix!`
-  * `delete_suffix`, `delete_suffix!`
-  * `undump`
+#### String
+  - `delete_prefix`, `delete_prefix!`
+  - `delete_suffix`, `delete_suffix!`
+  - `undump`
 
-*  Struct
-  * `new` (with `keyword_init: true`)
+#### Struct
+  - `new` (with `keyword_init: true`)
 
 ## Ruby 2.4 backports
 
-*  Comparable
-  * `clamp`
+#### Comparable
+  - `clamp`
 
-*  Enumerable
-  * `sum`
-  * `uniq`
+#### Enumerable
+  - `sum`
+  - `uniq`
 
-*  Hash
-  * `compact`, `compact!`
-  * `transform_values`, `transform_values!`
+#### Hash
+  - `compact`, `compact!`
+  - `transform_values`, `transform_values!`
 
-*  Regexp
-  * `match?`
+#### Regexp
+  - `match?`
 
-*  String
-  * `match?`
+#### String
+  - `match?`
 
-*  FalseClass, Fixnum, Float, NilClass, TrueClass
-  * `dup`
+#### FalseClass, Fixnum, Float, NilClass, TrueClass
+  - `dup`
 
 ## Ruby 2.3 backports
 
-*  Array
-  * `bsearch_index`
-  * `dig`
+#### Array
+  - `bsearch_index`
+  - `dig`
 
-*  Enumerable
-  * `chunk_while`
-  * `grep_v`
+#### Enumerable
+  - `chunk_while`
+  - `grep_v`
 
-*  Hash
-  * `dig`
-  * `fetch_values`
-  * `to_proc`
-  * <=, <, >=, >
+#### Hash
+  - `dig`
+  - `fetch_values`
+  - `to_proc`
+  - <=, <, >=, >
 
-*  Numeric
-  * `negative?`
-  * `positive?`
+#### Numeric
+  - `negative?`
+  - `positive?`
 
-*  String
-  * unary + and -
+#### String
+  - unary + and -
 
-*  Struct
-  * `dig`
+#### Struct
+  - `dig`
 
 ## Ruby 2.2 backports
 
-*  Enumerable
-  * `slice_after`
-  * `slice_when`
+#### Enumerable
+  - `slice_after`
+  - `slice_when`
 
-*  Float
-  * `prev_float`
-  * `next_float`
+#### Float
+  - `prev_float`
+  - `next_float`
 
-*  Kernel
-  * `itself`
+#### Kernel
+  - `itself`
 
-*  Method
-  * `curry`
-  * `super_method`
+#### Method
+  - `curry`
+  - `super_method`
 
-*  String
-  * `unicode_normalize`
-  * `unicode_normalize!`
-  * `unicode_normalize?`
+#### String
+  - `unicode_normalize`
+  - `unicode_normalize!`
+  - `unicode_normalize?`
 
 ## Ruby 2.1 backports
 
-*  Array
-  * `to_h`
+#### Array
+  - `to_h`
 
-*  Bignum
-  * `bit_length`
+#### Bignum
+  - `bit_length`
 
-*  Enumerable
-  * `to_h`
+#### Enumerable
+  - `to_h`
 
-*  Fixnum
-  * `bit_length`
+#### Fixnum
+  - `bit_length`
 
-*  Module
-  * `include` (now public)
+#### Module
+  - `include` (now public)
 
 ## Ruby 2.0 backports
 
-*  Array
-  * `bsearch`
+#### Array
+  - `bsearch`
 
-*  Enumerable
-  * `lazy`
+#### Enumerable
+  - `lazy`
 
-*  Enumerator::Lazy
-  * all methods
+#### Enumerator::Lazy
+  - all methods
 
-*  Hash
-  * `default_proc=` (with nil argument)
-  * `to_h`
+#### Hash
+  - `default_proc=` (with nil argument)
+  - `to_h`
 
-*  `nil.to_h`
+#### `nil.to_h`
 
-*  Range
-  * `bsearch`
+#### Range
+  - `bsearch`
 
-*  Struct
-  * `to_h`
+#### Struct
+  - `to_h`
 
 ## Ruby 1.9.3 backports
 
-*  File
-  * `NULL`
+#### File
+  - `NULL`
 
-*  IO
-  * `advise` (acts as a noop)
-  * `write`, `binwrite`
+#### IO
+  - `advise` (acts as a noop)
+  - `write`, `binwrite`
 
-*  String
-  * `byteslice`
-  * `prepend`
+#### String
+  - `byteslice`
+  - `prepend`
 
 ## Ruby 1.9.2 backports
 
-*  Array
-  * `rotate, rotate!`
-  * `keep_if, select!`
-  * `product` (with block)
-  * `repeated_combination`, `repeated_permutation`
-  * `sort_by!`
-  * `uniq, uniq!` (with block)
+#### Array
+  - `rotate, rotate!`
+  - `keep_if, select!`
+  - `product` (with block)
+  - `repeated_combination`, `repeated_permutation`
+  - `sort_by!`
+  - `uniq, uniq!` (with block)
 
-*  Complex
-  * `to_r`
+#### Complex
+  - `to_r`
 
-*  Dir
-  * `home`
+#### Dir
+  - `home`
 
-*  Enumerable
-  * `chunk`
-  * `flat_map`, `collect_concat`
-  * `join`
-  * `slice_before`
+#### Enumerable
+  - `chunk`
+  - `flat_map`, `collect_concat`
+  - `join`
+  - `slice_before`
 
-*  Float::INFINITY, NAN
+#### Float::INFINITY, NAN
 
-*  Hash
-  * `keep_if`, `select!`
+#### Hash
+  - `keep_if`, `select!`
 
-*  Object
-  * `singleton_class`
+#### Object
+  - `singleton_class`
 
-*  Random (new class)
+#### Random (new class)
 
 *Note*: The methods of `Random` can't be required individually; the class
 can only be required whole with `require 'backports/1.9.2/random'`.
@@ -349,78 +354,78 @@ can only be required whole with `require 'backports/1.9.2/random'`.
 ## Ruby 1.9.1 backports
 
 Additionally, the following Ruby 1.9 features have been backported:
-*  Array
-  * `try_convert`
-  * `sample`
+#### Array
+  - `try_convert`
+  - `sample`
 
-*  Enumerable
-  * `each_with_object`
-  * `each_with_index` (with arguments)
+#### Enumerable
+  - `each_with_object`
+  - `each_with_index` (with arguments)
 
-*  Enumerator
-  * `new` (with block)
+#### Enumerator
+  - `new` (with block)
 
-*  File
-  * `binread`
-  * `to_path`
-  * All class methods accepting filenames will accept files or anything
+#### File
+  - `binread`
+  - `to_path`
+  - All class methods accepting filenames will accept files or anything
         with a `#to_path` method.
-  * `File.open` accepts an options hash.
-
-*  Float
-  * `round`
-
-*  Hash
-  * `assoc`, `rassoc`
-  * `key`
-  * `try_convert`
-  * `default_proc=`
-
-*  Integer
-  * `magnitude`
-  * `round`
-
-*  IO
-  * `bin_read`
-  * `try_convert`
-  * `ungetbyte`
-  * `IO.open` accepts an options hash.
-
-*  Kernel
-  * `require_relative`
-
-*  Math
-  * `log` (with base)
-  * `log2`
-
-*  Numeric
-  * `round`
-
-*  Object
-  * `define_singleton_method`
-  * `public_method`
-  * `public_send`
-
-*  Proc
-  * `yield`
-  * `lambda?`
-  * `curry`
-  * `===`
-
-*  Range
-  * `cover?`
-
-*  Regexp
-  * `try_convert`
-
-*  String
-  * `ascii_only?`
-  * `chr`
-  * `clear`
-  * `codepoints`, `each_codepoint`
-  * `get_byte`, `set_byte`
-  * `ord`
-  * `try_convert`
+  - `File.open` accepts an options hash.
+
+#### Float
+  - `round`
+
+#### Hash
+  - `assoc`, `rassoc`
+  - `key`
+  - `try_convert`
+  - `default_proc=`
+
+#### Integer
+  - `magnitude`
+  - `round`
+
+#### IO
+  - `bin_read`
+  - `try_convert`
+  - `ungetbyte`
+  - `IO.open` accepts an options hash.
+
+#### Kernel
+  - `require_relative`
+
+#### Math
+  - `log` (with base)
+  - `log2`
+
+#### Numeric
+  - `round`
+
+#### Object
+  - `define_singleton_method`
+  - `public_method`
+  - `public_send`
+
+#### Proc
+  - `yield`
+  - `lambda?`
+  - `curry`
+  - `===`
+
+#### Range
+  - `cover?`
+
+#### Regexp
+  - `try_convert`
+
+#### String
+  - `ascii_only?`
+  - `chr`
+  - `clear`
+  - `codepoints`, `each_codepoint`
+  - `get_byte`, `set_byte`
+  - `ord`
+  - `try_convert`
 
 `Enumerator` can be accessed directly (instead of `Enumerable::Enumerator`)
 
@@ -439,9 +444,9 @@ Complete Ruby 1.8.7 backporting (core language). Refer to the official list of
 backports!
 
 Only exceptions:
-*  String#gsub (the form returning an enumerator)
-*  GC.stress=  (not implemented)
-*  Array#choice (removed in 1.9, use 1.9.1's Array#sample instead)
+#### String#gsub (the form returning an enumerator)
+#### GC.stress=  (not implemented)
+#### Array#choice (removed in 1.9, use 1.9.1's Array#sample instead)
 
 ## Libraries
 
@@ -451,18 +456,18 @@ The backports would be automatically used after requiring 'backports/std_lib' bu
 
 The following libraries are up to date with Ruby 1.9.3:
 
-*  Matrix
-*  Prime
-*  Set
+#### Matrix
+#### Prime
+#### Set
 
 The following library is to date with Ruby 2.0.0:
 
-*  OpenStruct (ostruct)
+#### OpenStruct (ostruct)
 
 I am aware of the following backport gem, which probably won't make it into
 this gem:
 
-*  Net::SMTP for Ruby 1.8.6:
+#### Net::SMTP for Ruby 1.8.6:
     [smtp_tls](http://seattlerb.rubyforge.org/smtp_tls/)
 
 Requiring backports for a given version of Ruby will also load
@@ -474,14 +479,14 @@ Some backports would create incompatibilities in their current Ruby version
 but could be useful in some projects. It is possible to request such
 incompatible changes. Backports currently supports the following:
 
-*  Hash
-  * `select` (returns a Hash instead of an Array)
+#### Hash
+  - `select` (returns a Hash instead of an Array)
 
-*  Enumerable / Array
-  * `map` (returns an enumerator when called without a block)
+#### Enumerable / Array
+  - `map` (returns an enumerator when called without a block)
 
-*  String
-  * `length`, `size` (for UTF-8 support)
+#### String
+  - `length`, `size` (for UTF-8 support)
 
 These must be imported in addition to the backports gem, for example:
 
@@ -492,10 +497,10 @@ These must be imported in addition to the backports gem, for example:
 
 Thanks for the bug reports and patches, in particular the repeat offenders:
 
-*  Arto Bendiken ( [bendiken](http://github.com/bendiken) )
-*  Konstantin Haase ( [rkh](https://github.com/rkh) )
-*  Roger Pack ( [rdp](http://github.com/rdp) )
-*  Victor Shepelev ( [zverok](http://github.com/zverok) )
+#### Arto Bendiken ( [bendiken](http://github.com/bendiken) )
+#### Konstantin Haase ( [rkh](https://github.com/rkh) )
+#### Roger Pack ( [rdp](http://github.com/rdp) )
+#### Victor Shepelev ( [zverok](http://github.com/zverok) )
 
 ## Contributing