range_extd 0.4 → 1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9e1551349faa64451f2d3cb0d0105e0e36d031822fd6d614ff6c641be3ae6091
-  data.tar.gz: 9cfe5dce8e2e887bd8536c37e6e81e47566c477158cdecc5e4dba4ed48aed058
+  metadata.gz: 32649fb2085566146ed0bd20a5f1198f4030f56477ea64cb4f7822ce6288ff24
+  data.tar.gz: 3fe7fb3ee23f9cd41550445e1482f86292b84dad8b13f0a3984b5e077a16a740
 SHA512:
-  metadata.gz: fed26ea14419c50417d319f54e1fc40d33e5fd95d92f2e19b110c6ebb001fb86581097de95c4551e1d50a4c4919e9c33ffef11a2c8837ffc03f3413cf6a091cf
-  data.tar.gz: e3cd288b44a7d42c9a8b8e947cb4bf030e4b906096bd779d304690708815e8eeabf916893ab334456a69a153504e73364f57e9a5167607b73d64f02f372fb5e4
+  metadata.gz: bc7050082f5af7734ee5946c1f51d21ed633ed275ef93ed9adf9844c8a965f9acab24eef8658cdb06891b852b05ab27bd8a81d0904bce15fbb9a0b0dfb0ba7e1
+  data.tar.gz: 4bf22fb1d18614b5afed4bb8bed88bea3aeb0f90fa8da4c3345be3ee58561313b28453244910c7bac306592945768208dc03cb866c67201eea6c13bc4dbedc34

data/ChangeLog

@@ -1,3 +1,24 @@
+-----
+(Version: 1.0)
+2019-10-30  Masa Sakano
+  * Release of Ver.1.0.
+  * Endless Range introduced in Ruby 2.6 is now fully supported.
+  * RangeError is raised now when it is appropriate in initialisation, where ArgumentError used to be raised.
+
+-----
+(Version: 1.0)
+2019-10-30  Masa Sakano
+  * Release of Ver.1.0.
+  * Endless Range introduced in Ruby 2.6 is now fully supported.
+  * RangeError is raised now when it is appropriate in initialisation, where ArgumentError used to be raised.
+
+-----
+(Version: 1.0)
+2019-10-30  Masa Sakano
+  * Release of Ver.1.0.
+  * Endless Range introduced in Ruby 2.6 is now fully supported.
+  * RangeError is raised now when it is appropriate in initialisation, where ArgumentError used to be raised.
+
 -----
 (Version: 0.4)
 2019-10-30  Masa Sakano

data/News

@@ -1,3 +1,7 @@
+-----
+(Version: 1.0) 2019-10-30
+ * Release of Ver.1.0.  Supports Endless Range in Ruby 2.6.
+
 -----
 (Version: 0.4.0) 2014-05-10
  * Added Range#equiv? method.

data/README.en.rdoc

@@ -63,12 +63,16 @@ not 100 per cent trivial.  The definition I adopt for the behaviour of
 RangeExtd is probably not the only solution.  Personally, I am content
 with it, and I think it achieves the good logical completeness within the frame.
 
-I hope you find it to be useful.
+I hope you find this package to be useful.
 
+=== News: Endless Range supported
+
+Now, as of 2019 October, this fully supports {Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
+introduced in Ruby 2.6.  It is released as Version 1.0 finally!
 
 ==== NOTE: Relationship with Rangesmaller
 
-This package supercedes the obsolete {Rangesmaller}[https://rubygems.org/gems/rangesmaller] package and class,
+This package supersedes the obsolete {Rangesmaller}[https://rubygems.org/gems/rangesmaller] package and class,
 with the added open-ended feature, and a different interface in
 creating a new instance.
 https://rubygems.org/gems/rangesmaller
@@ -78,7 +82,7 @@ https://rubygems.org/gems/rangesmaller
 The class to handle multiple Ranges with objects of the same class
 (most typically Float),
 {Rangeary}[https://rubygems.org/gems/rangeary] uses this library to
-fullest, because the concept of potentially open-ended Range ato both
+fullest, because the concept of potentially open-ended Range on both
 begin and end is essential to realise Rangeary.
 https://rubygems.org/gems/rangeary
 
@@ -176,7 +180,7 @@ All the methods that are in the built-in Range can be used.
 
 == Description
 
-Once the file range_extd.rb is required, the two classes are defined:
+Once the file +range_extd/range_extd.rb+ is required, the two classes are defined:
 
 * RangeExtd
 * RangeExtd::Infinity
@@ -209,8 +213,16 @@ those two constants, as long as the cmp method of the class is written
 politely.
 
 For more detail, see its documents (YARD or RDoc-style
-documents embedded in the code, or see RubyGems webpage).
+documents embedded in the code, or see {RubyGems webpage}[http://rubygems.org/gems/range_extd]).
 
+**Note** +RangeExtd::Infinity::POSITIVE+ is practically the same as
+{Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
+introduced in Ruby 2.6 released in 2018 December!!  In other words,
+the official Ruby has finally implement a part of this library!
+However, +RangeExtd::Infinity::NEGATIVE+ is not yet implemented in the
+official Ruby Range (it has no "boundless begin"), and hence this library still has some use, which
+supplements the mathematical incompleteness of the standard Range in
+the official Ruby.
 
 === RangeExtd Class
 
@@ -308,18 +320,14 @@ existing code in principle.
 
 == Known bugs
 
-* As of Ruby 2.6, {Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
-  is introduced.  As a result, Range#end sometimes raises RangeError.
-  However, this library does not yet take it into account, and it may
-  raises Exception when encountering an endless Range.
 * Note this library does not work in Ruby 1.8 or earlier.
   For Ruby 1.9.3 it is probably all right, though I have never tested it.
 * Some unusual (rare) boundary conditions are found to vary from
-  version to version in Ruby, such as a comparison between
-  Float::INFINITY-s.  Though the test scripts are pretty extensive,
+  version to version in Ruby, such as an implementation of +Hash#=>+.
+  Though the test scripts are pretty extensive,
   they have not been performed over many different versions of Ruby.
-  In some versions, some features may not work well, although such
-  occasions should be very rare.
+  Hence, some features may not work well in some particular versions, although such
+  cases should be very rare.
 * {RangeExtd#hash} method does not theoretically guarantee to return a unique
   number for a {RangeExtd} object, though to encounter a hash number that is
   used elsewhere is extremely unlikely to happen in reality.
@@ -329,7 +337,7 @@ Extensive tests have been performed, as included in the package.
 
 == ToDo
 
-* Handle the Ruby-2.6 new feature {Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1].
+Nothing on the horizon.
 
 
 == Final notes
@@ -369,7 +377,7 @@ License:: MIT.
 Warranty:: No warranty whatsoever.
 Versions:: The versions of this package follow Semantic Versioning (2.0.0) http://semver.org/
 
-
+----------
 
 = RangeExtd - 拡張Rangeクラス - exclude_begin と無限大に開いた範囲と
 
@@ -435,6 +443,11 @@ Versions:: The versions of this package follow Semantic Versioning (2.0.0) http:
 このクラスが少なからぬ人に有用なものであることを願ってここにリリースします。
 
 
+=== News: Endless Range サポートしました
+
+2019年10月より、本パッケージは、Ruby 2.6 で導入された {Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
+(終端のない Range)を正式サポートしました。よって、Version 1.0 をリリースしました!
+
 ==== 注: Rangesmallerとの関係
 
 このパッケージは、(今やサポートされていない) {Rangesmaller}[https://rubygems.org/gems/rangesmaller] パッケージ及びクラスを
@@ -544,7 +557,7 @@ https://rubygems.org/gems/rangeary
 
 == 詳説
 
-ファイル range_extd.rb が読まれた段階で、次の二つのクラスが定義されます。
+ファイル +range_extd/range_extd.rb+ が読まれた段階で、次の二つのクラスが定義されます。
 
 * RangeExtd
 * RangeExtd::Infinity
@@ -575,7 +588,15 @@ https://rubygems.org/gems/rangeary
 る、という前提で。
 
 さらに詳しくは、マニュアルを参照して下さい(YARD　または RDoc形式で書かれた文書が
-コード内部に埋込まれていますし、それが RubyGemsのウェブサイトでも閲覧できます。
+コード内部に埋込まれていますし、{RubyGemsのウェブサイト}[http://rubygems.org/gems/range_extd]でも閲覧できます。
+
+**(注)** +RangeExtd::Infinity::POSITIVE+ は、
+2018年12月に公式リリースされたRuby 2.6で導入された
+{Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
+(終端のないRange)で実用上同一です!! 言葉を替えれば、公式Rubyがついに本
+ライブラリの一部をサポートしました! ただし、公式Rubyには、
++RangeExtd::Infinity::NEGATIVE+ は依然ありません(始端のないRangeがない)。
+本ライブラリにより、組込Rangeに欠けている数学的不完全性を補うことができます。
 
 
 === RangeExtd クラス
@@ -665,10 +686,6 @@ RangeExtd と別の RangeExtd または Rangeの比較 (<tt><=></tt>) におい
 
 == 既知のバグ
 
-
-* Ruby 2.6 では、後ろに無限に開いたRange({Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1])
-  が導入されました。本ライブラリでは、まだそれには対応していません。
-  したがって、Endless Rangeを本クラスに適用した場合、問題が起きるでしょう。
 * このライブラリは Ruby 1.8 およびそれ以前のバージョンでは動作しません。
   Ruby 1.9.3 ではおそらく大丈夫でしょうが、私は試したことがありません。
 * いくつかの極めて稀な境界条件に於ける挙動は、Rubyのバージョンごとにあ
@@ -685,7 +702,7 @@ RangeExtd と別の RangeExtd または Rangeの比較 (<tt><=></tt>) におい
 
 == 開発項目
 
-* Ruby 2.6の後ろに無限に開いたRange({Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1])に対応する。
+特になし。
 
 
 == 終わりに

data/README.ja.rdoc

@@ -63,12 +63,16 @@ not 100 per cent trivial.  The definition I adopt for the behaviour of
 RangeExtd is probably not the only solution.  Personally, I am content
 with it, and I think it achieves the good logical completeness within the frame.
 
-I hope you find it to be useful.
+I hope you find this package to be useful.
 
+=== News: Endless Range supported
+
+Now, as of 2019 October, this fully supports {Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
+introduced in Ruby 2.6.  It is released as Version 1.0 finally!
 
 ==== NOTE: Relationship with Rangesmaller
 
-This package supercedes the obsolete {Rangesmaller}[https://rubygems.org/gems/rangesmaller] package and class,
+This package supersedes the obsolete {Rangesmaller}[https://rubygems.org/gems/rangesmaller] package and class,
 with the added open-ended feature, and a different interface in
 creating a new instance.
 https://rubygems.org/gems/rangesmaller
@@ -78,7 +82,7 @@ https://rubygems.org/gems/rangesmaller
 The class to handle multiple Ranges with objects of the same class
 (most typically Float),
 {Rangeary}[https://rubygems.org/gems/rangeary] uses this library to
-fullest, because the concept of potentially open-ended Range ato both
+fullest, because the concept of potentially open-ended Range on both
 begin and end is essential to realise Rangeary.
 https://rubygems.org/gems/rangeary
 
@@ -176,7 +180,7 @@ All the methods that are in the built-in Range can be used.
 
 == Description
 
-Once the file range_extd.rb is required, the two classes are defined:
+Once the file +range_extd/range_extd.rb+ is required, the two classes are defined:
 
 * RangeExtd
 * RangeExtd::Infinity
@@ -209,8 +213,16 @@ those two constants, as long as the cmp method of the class is written
 politely.
 
 For more detail, see its documents (YARD or RDoc-style
-documents embedded in the code, or see RubyGems webpage).
+documents embedded in the code, or see {RubyGems webpage}[http://rubygems.org/gems/range_extd]).
 
+**Note** +RangeExtd::Infinity::POSITIVE+ is practically the same as
+{Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
+introduced in Ruby 2.6 released in 2018 December!!  In other words,
+the official Ruby has finally implement a part of this library!
+However, +RangeExtd::Infinity::NEGATIVE+ is not yet implemented in the
+official Ruby Range (it has no "boundless begin"), and hence this library still has some use, which
+supplements the mathematical incompleteness of the standard Range in
+the official Ruby.
 
 === RangeExtd Class
 
@@ -308,18 +320,14 @@ existing code in principle.
 
 == Known bugs
 
-* As of Ruby 2.6, {Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
-  is introduced.  As a result, Range#end sometimes raises RangeError.
-  However, this library does not yet take it into account, and it may
-  raises Exception when encountering an endless Range.
 * Note this library does not work in Ruby 1.8 or earlier.
   For Ruby 1.9.3 it is probably all right, though I have never tested it.
 * Some unusual (rare) boundary conditions are found to vary from
-  version to version in Ruby, such as a comparison between
-  Float::INFINITY-s.  Though the test scripts are pretty extensive,
+  version to version in Ruby, such as an implementation of +Hash#=>+.
+  Though the test scripts are pretty extensive,
   they have not been performed over many different versions of Ruby.
-  In some versions, some features may not work well, although such
-  occasions should be very rare.
+  Hence, some features may not work well in some particular versions, although such
+  cases should be very rare.
 * {RangeExtd#hash} method does not theoretically guarantee to return a unique
   number for a {RangeExtd} object, though to encounter a hash number that is
   used elsewhere is extremely unlikely to happen in reality.
@@ -329,7 +337,7 @@ Extensive tests have been performed, as included in the package.
 
 == ToDo
 
-* Handle the Ruby-2.6 new feature {Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1].
+Nothing on the horizon.
 
 
 == Final notes
@@ -369,7 +377,7 @@ License:: MIT.
 Warranty:: No warranty whatsoever.
 Versions:: The versions of this package follow Semantic Versioning (2.0.0) http://semver.org/
 
-
+----------
 
 = RangeExtd - 拡張Rangeクラス - exclude_begin と無限大に開いた範囲と
 
@@ -435,6 +443,11 @@ Versions:: The versions of this package follow Semantic Versioning (2.0.0) http:
 このクラスが少なからぬ人に有用なものであることを願ってここにリリースします。
 
 
+=== News: Endless Range サポートしました
+
+2019年10月より、本パッケージは、Ruby 2.6 で導入された {Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
+(終端のない Range)を正式サポートしました。よって、Version 1.0 をリリースしました!
+
 ==== 注: Rangesmallerとの関係
 
 このパッケージは、(今やサポートされていない) {Rangesmaller}[https://rubygems.org/gems/rangesmaller] パッケージ及びクラスを
@@ -544,7 +557,7 @@ https://rubygems.org/gems/rangeary
 
 == 詳説
 
-ファイル range_extd.rb が読まれた段階で、次の二つのクラスが定義されます。
+ファイル +range_extd/range_extd.rb+ が読まれた段階で、次の二つのクラスが定義されます。
 
 * RangeExtd
 * RangeExtd::Infinity
@@ -575,7 +588,15 @@ https://rubygems.org/gems/rangeary
 る、という前提で。
 
 さらに詳しくは、マニュアルを参照して下さい(YARD　または RDoc形式で書かれた文書が
-コード内部に埋込まれていますし、それが RubyGemsのウェブサイトでも閲覧できます。
+コード内部に埋込まれていますし、{RubyGemsのウェブサイト}[http://rubygems.org/gems/range_extd]でも閲覧できます。
+
+**(注)** +RangeExtd::Infinity::POSITIVE+ は、
+2018年12月に公式リリースされたRuby 2.6で導入された
+{Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1]
+(終端のないRange)で実用上同一です!! 言葉を替えれば、公式Rubyがついに本
+ライブラリの一部をサポートしました! ただし、公式Rubyには、
++RangeExtd::Infinity::NEGATIVE+ は依然ありません(始端のないRangeがない)。
+本ライブラリにより、組込Rangeに欠けている数学的不完全性を補うことができます。
 
 
 === RangeExtd クラス
@@ -665,10 +686,6 @@ RangeExtd と別の RangeExtd または Rangeの比較 (<tt><=></tt>) におい
 
 == 既知のバグ
 
-
-* Ruby 2.6 では、後ろに無限に開いたRange({Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1])
-  が導入されました。本ライブラリでは、まだそれには対応していません。
-  したがって、Endless Rangeを本クラスに適用した場合、問題が起きるでしょう。
 * このライブラリは Ruby 1.8 およびそれ以前のバージョンでは動作しません。
   Ruby 1.9.3 ではおそらく大丈夫でしょうが、私は試したことがありません。
 * いくつかの極めて稀な境界条件に於ける挙動は、Rubyのバージョンごとにあ
@@ -685,7 +702,7 @@ RangeExtd と別の RangeExtd または Rangeの比較 (<tt><=></tt>) におい
 
 == 開発項目
 
-* Ruby 2.6の後ろに無限に開いたRange({Endless Range}[https://rubyreferences.github.io/rubychanges/2.6.html#endless-range-1])に対応する。
+特になし。
 
 
 == 終わりに

data/lib/range_extd/range_extd.rb

@@ -62,6 +62,12 @@ class RangeExtd < Range
 
   @@middle_strings = []
 
+  # Error messages
+  ERR_MSGS = {
+    infinity_compare: 'Float::INFINITY is not mathematically comparable with another Infinity.',
+  }
+  private_constant :ERR_MSGS
+
   # @note The flag of exclude_begin|end can be given in the arguments in a couple of ways.
   #  If there is any duplication, those specified in the optional hash have the highest
   #  priority.  Then the two descrete Boolean parameters have the second.
@@ -103,9 +109,18 @@ class RangeExtd < Range
   #   @option opts [Boolean] :exclude_end If specified, this has the higher priority, or false in default.
   #
   # Note if you use the third form with "string_form" with the user-defined string
-  # (via {RangeExtd.middle_strings=}()), make 100 per cent sure
-  # of what you are doing.  If the string is ambiguous, the result may differ
+  # (via {RangeExtd.middle_strings=}()), make 100 per cent sure you know
+  # what you are doing.  If the string is ambiguous, the result may differ
   # from what you thought you would get!  See {RangeExtd.middle_strings=}() for detail.
+  # Below are a couple of examples:
+  #
+  #   RangeExtd.new(5, '....', 6)      # => RangeError because (5..("....")) is an invalid Range.
+  #   RangeExtd.new("%", '....', "y")  # => ("%" <.. "....")
+  #                                    #   n.b., "y" is interpreted as TRUE for
+  #                                    #   the flag for "exclude_begin?"
+  #   RangeExtd.new("x", '....', "y")  # => RangeError because ("x" <..("....")) is an invalid RangeExte,
+  #                                    #   in the sense String "...." is *smaller* than "x"
+  #                                    #   in terms of the "<=>" operator comparison.
   #
   # @raise [ArgumentError] particularly if the range to be created is not {#valid?}.
   def initialize(*inar, **hsopt)	# **k expression from Ruby 1.9?
@@ -118,8 +133,9 @@ class RangeExtd < Range
       return
     end
 
-    # [RangeBeginValue, RangeEndValue, exclude_end?, exclude_begin?]
-    arout = RangeExtd.class_eval{ _get_init_args(*inar, hsopt) }	# class_eval from Ruby 1.8.7 (?)
+    # Note: the order of exclude_begin? and end? is reversed from the input!
+    arout = RangeExtd.send(:_get_init_args, *inar, hsopt)
+    # == [RangeBeginValue, RangeEndValue, exclude_end?, exclude_begin?]
 
     ### The following routine is obsolete.
     ### Users, if they wish, should call RangeExtd::Infinity.overwrite_compare() beforehand.
@@ -151,7 +167,7 @@ class RangeExtd < Range
     # end
 
     if ! RangeExtd.valid?(*arout)
-      raise ArgumentError, "the argument can not consist of a RangeExtd instance."
+      raise RangeError, "the combination of the arguments does not constitute a valid RangeExtd instance."
     end
 
     @exclude_begin = arout.pop
@@ -820,6 +836,8 @@ class RangeExtd < Range
   ##################################################
 
   # Private class method to evaluate the arguments.
+  #
+  # @raise [ArgumentError] if the input format is invalid (otherwise the caller may raise RangeError (it depends))
   def self._get_init_args(*inar, **hsopt)
     nMin = 1; nMax = 5
     if inar.size < nMin || nMax < inar.size
@@ -875,11 +893,11 @@ class RangeExtd < Range
       # Now, checking if the form is the String one, and if so, process it.
       arMid = @@middle_strings.map{|i| Regexp.quote(i)}	# See self.middle_strings=(ary) for description.
 
-      # Originally, defined?(inar[1].=~) seemed enough.  But as of Ruby 2.6,
+      # Originally, defined?(inar[1].=~) seemed enough.  But as of Ruby 2.6 (maybe even before),
       # Numeric has :=~ method as well!
-      if inar.size > 2 &&
-         inar[1].class.method_defined?(:=~) &&
-         inar[1].class.method_defined?(:to_str)
+      if (inar.size > 2 &&
+          inar[1].class.method_defined?(:=~) &&
+          inar[1].class.method_defined?(:to_str))
         begin
           cmp = (inar[0] <=> inar[2]).abs
         rescue
@@ -934,7 +952,6 @@ class RangeExtd < Range
     if hsopt.has_key?(:exclude_end)
       exclude_end   = (hsopt[:exclude_end] && true)
     end
-
     # [RangeBeginValue, RangeEndValue, exclude_end?, exclude_begin?]
     beginend + [exclude_end, exclude_begin]
 
@@ -954,13 +971,17 @@ class RangeExtd < Range
   #
   # What is valid is defined as follows:
   #
-  # 1. Both {#begin} and {#end} elements must be Comparable to each other,
+  # 1. The {#begin} and {#end} elements must be Comparable to each other,
   #    and the comparison results must be consistent betwen the two.
-  #    The sole exception is {RangeExtd::NONE}, which is valid.
+  #    The two sole exceptions are {RangeExtd::NONE} and Endless Range
+  #    introduced in Ruby 2.6 (see below for the exceptions), both of which are valid.
   #    For example, (nil..nil) is NOT valid (nb., it raised Exception in Ruby 1.8).
-  # 2. {#begin} must be smaller than or equal to {#end},
+  # 2. Except for {RangeExtd::NONE}, {#begin} must have the method +<=+.
+  #    Therefore, some Endless Ranges (Ruby 2.6 and upwards) like (true..) are *not* valid.
+  #    Note even "true" has the method +<=>+ and hence checking +<=+ is essential.
+  # 3. {#begin} must be smaller than or equal to {#end},
   #    that is, ({#begin} <=> {#end}) must be either -1 or 0.
-  # 3. If {#begin} is equal to {#end}, namely, ({#begin} <=> {#end}) == 0,
+  # 4. If {#begin} is equal to {#end}, namely, ({#begin} <=> {#end}) == 0,
   #    the exclude status of the both ends must agree.
   #    That is, if the {#begin} is excluded, {#end} must be also excluded,
   #    and vice versa.
@@ -981,6 +1002,8 @@ class RangeExtd < Range
   #    RangeExtd.valid?(nil...nil)    # => false
   #    RangeExtd.valid?(0..0)         # => true
   #    RangeExtd.valid?(0...0)        # => false
+  #    RangeExtd.valid?(0...)         # => true
+  #    RangeExtd.valid?(true..)       # => false
   #    RangeExtd.valid?(0..0,  true)  # => false
   #    RangeExtd.valid?(0...0, true)  # => true
   #    RangeExtd.valid?(2..-1)        # => false
@@ -998,13 +1021,13 @@ class RangeExtd < Range
   #  in the parameter are used.  In default, both of them are false.
   #
   # @overload new(range, [exclude_begin=false, [exclude_end=false]])
-  #   @param [Object] range Instance of Range or its subclasses, including RangeExtd
+  #   @param range [Object] Instance of Range or its subclasses, including RangeExtd
   #   @param exclude_begin [Boolean] If specified, this has the higher priority, or false in default.
   #   @param exclude_end [Boolean] If specified, this has the higher priority, or false in default.
   #
   # @overload new(obj_begin, obj_end, [exclude_begin=false, [exclude_end=false]])
   #   @param obj_begin [Object] Any object that is {Comparable} with end
-  #   @param obj_end [Object] Any object that is Comparable with begin
+  #   @param obj_end [Object] Any object that is Comparable with begin (or nil, for Ruby 2.6 onwards)
   #   @param exclude_begin [Boolean] If specified, this has the lower priority, or false in default.
   #   @param exclude_end [Boolean] If specified, this has the lower priority, or false in default.
   #
@@ -1014,15 +1037,23 @@ class RangeExtd < Range
     if defined?(inar[0].is_none?) && inar[0].is_none? && exc_beg && exc_end
       return true
     end
-      
     begin
       t = (vbeg <=> vend)
       begin
+        if vend.nil?
+          begin
+            _ = (vbeg..nil)  # Endless Range introduced in Ruby 2.6
+            return vbeg.class.method_defined?(:<=)
+          rescue ArgumentError
+            # Before Ruby 2.6
+            return false
+          end
+        end
         return false if t != -1*(vend <=> vbeg)	# false if not commutative, or possibly exception (such as -1*nil).
       rescue NoMethodError, TypeError
         if (Float === vend && defined?(vbeg.infinity?) && vbeg.infinity?) ||
            (Float === vbeg && defined?(vend.infinity?) && vend.infinity?)
-          warn "Float::INFINITY is not comparable with other Infinity."
+          warn self.const_get(:ERR_MSGS)[:infinity_compare]  # one of the tests comes here.
         end
         return false	# return
       end
@@ -1043,7 +1074,7 @@ class RangeExtd < Range
       else
         if (Float === vend && defined?(vbeg.infinity?) && vbeg.infinity?) ||
            (Float === vbeg && defined?(vend.infinity?) && vend.infinity?)
-          warn "Float::INFINITY is not comparable with other Infinity."
+          warn self.const_get(:ERR_MSGS)[:infinity_compare]  # not tested so far?
         end
         false	# Not Comparable.
       end	# case t

data/test/test_range_extd.rb

@@ -250,6 +250,17 @@ gem "minitest"
       assert_equal RangeExtd::Infinity::NEGATIVE, r.begin
     end	# def test_rangeextd_new_infinity_c3
 
+    def test_get_init_args
+      begin
+        _ = (0..nil)
+      rescue ArgumentError
+        return  # Before Ruby 2.6
+      end
+      arout = RangeExtd.class_eval{ _get_init_args(3, nil) }	# class_eval from Ruby 1.8.7 (?)
+      assert_equal [3, nil, F, F], arout
+      arout = RangeExtd.class_eval{ _get_init_args(3, nil, F, T) }  # true == exclude_end?
+      assert_equal [3, nil, T, F], arout
+    end
 
     def test_new
       e22 = RangeExtd.new(@s22)
@@ -283,6 +294,28 @@ gem "minitest"
       assert_equal(-@ib, j22.end)
     end
 
+    def test_new_endless_range01
+      ra00 = (-2..)
+      rae0 = RangeExtd.new(ra00)
+      assert rae0.valid?
+      assert_equal(-2,  rae0.begin)
+      assert_nil        rae0.end
+      assert_equal Float::INFINITY,   rae0.size
+      assert_equal ra00.exclude_end?, rae0.exclude_end?
+      refute                          rae0.exclude_begin?
+    end
+
+    def test_new_endless_range02
+      ra00 = (Float::INFINITY...)
+      rae0 = RangeExtd.new(ra00)
+      assert rae0.valid?
+      assert_equal Float::INFINITY,   rae0.begin
+      assert_nil        rae0.end
+      assert_equal Float::INFINITY,   rae0.size
+      assert_equal ra00.exclude_end?, rae0.exclude_end?
+      refute                          rae0.exclude_begin?
+    end
+
     def test_new_middle_strings
       aru = ['[','(in)','(ex)',', ','(ex)','(in)',']']
       ark = [nil, :math, aru, :default]
@@ -339,9 +372,21 @@ gem "minitest"
       assert_equal(-@ie, m22.begin)
       assert_equal(-@ib, m22.end)
 
-      assert_raises(ArgumentError){ RangeExtd.new(@ib, '....', @ie) }	# => the argument can not consist of a RangeExtd instance.
+      assert_raises(RangeError){ RangeExtd.new(@ib, '....', @ie) }	# => the combination of the arguments does not constitute a valid RangeExtd instance.
+        # Basically, for @ib, @ie == [1, 6],
+        # the user may intend to write "1....6", but it is interpreted as
+        #   ((1..("....")), exclude_begin: (!!6))
+        # hence it is RangeError (as opposed to ArgumentError)
+
+      rt0 = RangeExtd.new("%", '....', "y")
+      assert_equal "%",    rt0.begin
+      assert_equal '....', rt0.end
+      assert               rt0.exclude_begin?
+      refute               rt0.exclude_end?
+
       RangeExtd.middle_strings = :math
-      assert_raises(ArgumentError){ RangeExtd.new(@ib, '..', @ie) }	# => the argument can not consist of a RangeExtd instance.
+      assert_raises(RangeError){ RangeExtd.new(@ib, '..', @ie) }	# => the combination of the arguments does not constitute a valid RangeExtd instance.
+
       RangeExtd.middle_strings = :default
       assert_raises(ArgumentError){ RangeExtd.new(@ib, '..', @ie, T, nil, T) }	# => wrong number of arguments (6 for 1..5)
       assert_raises(ArgumentError){ RangeExtd.new(@ib, @ie, T, nil, T) }	# => wrong number of arguments (5 for 2..4)
@@ -354,6 +399,7 @@ gem "minitest"
 
     def test_new_invalid
       ae = ArgumentError
+      re = RangeError
       # Wrong number of parameters
       assert_raises(ae){ RangeExtd() }
       assert_raises(ae){ RangeExtd(1,2,3,4,5) }
@@ -362,39 +408,39 @@ gem "minitest"
       assert_raises(ae){ RangeExtd(1..1,2,3,{},5) }
 
       # Wrong range (Object input)
-      assert_raises(ae){ RaE(2, -1) }
-      assert_raises(ae){ RaE(nil, nil) }
-      assert_raises(ae){ RaE(nil, false) }
-      assert_raises(ae){ RaE(?d..?a) }
-      assert_raises(ae){ RaE(?a, 5) }
-      assert_raises(ae){ RaE(0, 0, true, false) }
-      assert_raises(ae){ RaE(0, 0, nil,  1) }
+      assert_raises(re){ RaE(2, -1) }
+      assert_raises(re){ RaE(nil, nil) }
+      assert_raises(re){ RaE(nil, false) }
+      assert_raises(re){ RaE(?d..?a) }
+      assert_raises(re){ RaE(?a, 5) }
+      assert_raises(re){ RaE(0, 0, true, false) }
+      assert_raises(re){ RaE(0, 0, nil,  1) }
       assert_equal RangeExtd::NONE, RaE(0, 0, true, true)
       assert_equal RangeExtd::NONE, RaE(?a, ?a, true, true)
       assert_equal (0..0), RaE(0, 0, false, false)
 
       # Wrong range (Infinity input)
-      assert_raises(ae){ RaE(?a, RangeExtd::Infinity::NEGATIVE) }
+      assert_raises(re){ RaE(?a, RangeExtd::Infinity::NEGATIVE) }
       assert_equal (RangeExtd::Infinity::NEGATIVE..?a),  RaE(RangeExtd::Infinity::NEGATIVE, ?a)
       assert_equal (RangeExtd::Infinity::NEGATIVE...?a), RaE(RangeExtd::Infinity::NEGATIVE, ?a, nil, 3)
       assert_equal (?a..RangeExtd::Infinity::POSITIVE),  RaE(?a, RangeExtd::Infinity::POSITIVE)
       assert_equal RangeExtd, RaE(?a, RangeExtd::Infinity::POSITIVE, 1).class
-      assert_raises(ae){ RaE(RangeExtd::Infinity::NEGATIVE,  Float::INFINITY) }	# Float::INFINITY is an exception - you should not mix it up.
-      assert_raises(ae){ RaE(-Float::INFINITY, RangeExtd::Infinity::POSITIVE) }	# Float::INFINITY is an exception - you should not mix it up.
-      assert_raises(ae){ RaE(RangeExtd::Infinity::POSITIVE, ?a) }
-      assert_raises(ae){      RaE(RangeExtd::Infinity::POSITIVE, RangeExtd::Infinity::NEGATIVE) }
+      assert_raises(re){ RaE(RangeExtd::Infinity::NEGATIVE,  Float::INFINITY) }	# Float::INFINITY is an exception - you should not mix it up.
+      assert_raises(re){ RaE(-Float::INFINITY, RangeExtd::Infinity::POSITIVE) }	# Float::INFINITY is an exception - you should not mix it up.
+      assert_raises(re){ RaE(RangeExtd::Infinity::POSITIVE, ?a) }
+      assert_raises(re){      RaE(RangeExtd::Infinity::POSITIVE, RangeExtd::Infinity::NEGATIVE) }
       assert_equal RangeExtd, RaE(RangeExtd::Infinity::NEGATIVE, RangeExtd::Infinity::POSITIVE).class
-      assert_raises(ae){ RaE(RangeExtd::Infinity::NEGATIVE, 0, false, false) }	# For Numeric, you should use -Float::INFINITY
-      assert_raises(ae){ RaE(0, RangeExtd::Infinity::POSITIVE, false, false) }	# For Numeric, you should use  Float::INFINITY
+      assert_raises(re){ RaE(RangeExtd::Infinity::NEGATIVE, 0, false, false) }	# For Numeric, you should use -Float::INFINITY
+      assert_raises(re){ RaE(0, RangeExtd::Infinity::POSITIVE, false, false) }	# For Numeric, you should use  Float::INFINITY
       assert_equal RangeExtd, RaE(RangeExtd::Infinity::NEGATIVE, ?a, false, false).class
       assert_equal RangeExtd, RaE(?a, RangeExtd::Infinity::POSITIVE, false, false).class
       # assert_raises(ae){ RaE(RangeExtd::Infinity::NEGATIVE, ?a, true) }	#### No exception.  Is it OK???
       # assert_raises(ae){ RaE(?a, RangeExtd::Infinity::POSITIVE, nil, 1) }	#### No exception.  Is it OK???
 
       # Wrong range (Range input)
-      assert_raises(ae){ RangeExtd(2..-1) }
-      assert_raises(ae){ RangeExtd(nil..nil) }
-      assert_raises(ae){ RangeExtd(?d..?a) }
+      assert_raises(re){ RangeExtd(2..-1) }
+      assert_raises(re){ RangeExtd(nil..nil) }
+      assert_raises(re){ RangeExtd(?d..?a) }
 
       # Range with contradictory boundary
       assert_equal ?a..?e,  RaE(?a...?e, nil, nil)
@@ -402,10 +448,19 @@ gem "minitest"
       assert_equal ?a..?a,  RaE(?a...?a, nil, nil)
       assert_equal RangeExtd::NONE, RaE(?a...?a, 1, 1)
       assert_equal RangeExtd::NONE, RaE(?a..?b,  1, 1)
-      assert_raises(ae){ RaE(?a..?a, true, nil) }
-      assert_raises(ae){ RaE(?a..?a,  nil,   1) }
+      assert_raises(re){ RaE(?a..?a, true, nil) }
+      assert_raises(re){ RaE(?a..?a,  nil,   1) }
     end
 
+    def test_new_invalid_endless_range01
+      ra00 = (nil..)
+      refute RangeExtd.valid?(ra00)
+      assert_raises(RangeError){ RangeExtd.new(ra00) }
+
+      ra01 = (true..)
+      refute RangeExtd.valid?(ra01)
+      assert_raises(RangeError){ RangeExtd.new(ra01) }
+    end
 
     def test_new_exclude_begin_end
       # Form 1: 1 parameters
@@ -502,10 +557,10 @@ gem "minitest"
       assert_raises ArgumentError do
         RangeExtd.new(5)
       end
-      assert_raises ArgumentError do
+      assert_raises RangeError do
         RangeExtd.new(nil,5)
       end
-      assert_raises ArgumentError do
+      assert_raises RangeError do
         RangeExtd.new(nil,5,true)
       end
     end	# def test_exclude_begin
@@ -638,7 +693,7 @@ gem "minitest"
       assert_equal(@ib+1, @s21.first(1)[0])
       assert_equal(@ib+1, @s22.first(1)[0])
 
-      assert_raises ArgumentError do
+      assert_raises RangeError do
         RangeExtd(9, 3, true)
       end
       assert_raises ArgumentError do
@@ -670,7 +725,7 @@ gem "minitest"
       end
 
       ## Else
-      assert_raises ArgumentError do
+      assert_raises RangeError do
         RangeExtd.new(nil..nil, true)
       end
 
@@ -898,11 +953,11 @@ gem "minitest"
       inf = Float::INFINITY
       excl_ini = true
       assert_equal inf, RangeExtd(-inf, 1).size
-      assert_raises ArgumentError do
+      assert_raises RangeError do
         RangeExtd(-inf, -inf, excl_ini)	# exclde_begin yet !exclude_end
       end
       assert_equal inf, RangeExtd(-inf,    1, excl_ini).size
-      assert_raises ArgumentError do
+      assert_raises RangeError do
         RangeExtd( inf,  inf, excl_ini)	# exclde_begin yet !exclude_end
       end
       assert_equal inf, RangeExtd(   1,  inf, excl_ini).size
@@ -1058,6 +1113,17 @@ gem "minitest"
       assert  RangeExtd(RangeExtd::Infinity::NEGATIVE..?b).valid?
     end		# def test_Range_valid
 
+    # For Ruby 2.6 and onwards
+    def test_endlessRange_valid
+      assert  (0..).valid?
+      assert  (0...).valid?
+      refute  (true..).valid?
+      refute  (nil...).valid?
+      refute  (nil..nil).valid?
+      assert   (Float::INFINITY..Float::INFINITY).valid?
+      assert  (-Float::INFINITY..Float::INFINITY).valid?
+      assert  (-Float::INFINITY...Float::INFINITY).valid?
+    end
 
     def test_Range_empty
       assert  RangeExtd::NONE.empty?

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: range_extd
 version: !ruby/object:Gem::Version
-  version: '0.4'
+  version: '1.0'
 platform: ruby
 authors:
 - Masa Sakano