xqsr3 0.39.6 → 0.39.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6370aea72b56e6222b5bceb189340a255b87da7c047b058cbd67d6d4eb0b4bd9
-  data.tar.gz: db1fb7918b2737221db358636c2bdbb684d6f791a42582cee8df758b41f7ab2c
+  metadata.gz: 7e1df2847a524be64578ba040be65911b413eccbe2affbf7e4d3bac710a505d8
+  data.tar.gz: 4c2360c637d977e9cdb2f88b01455aa565ea0dc11225b09be357a35094daff22
 SHA512:
-  metadata.gz: c9d4ba6de8d0390831931f32a0d8a41962d7fad41769d2e437aa566c0e89589a5df5bd33de774eb58ecff452695b8653d65ea49e30a4efe96a09a1f4975d8897
-  data.tar.gz: 04f7391d0212d72ad5c09a4aa2fd4c3b33304f9132f48b81f83e851b7fdad9027be7ea9344c8514be9c400fd8b072d9123d5b1268013a3f924a6f8c2bd2c03d2
+  metadata.gz: 52ab95d6b63616544f08c3dd482ca1695aebc51fe70d01cf60c76ce7a737d5285fb61c32d4978da6f87a0f986cc02b279f1a5ee3680aa0c47b52a3e30e52fa6f
+  data.tar.gz: f774505ffcc560824ea2671624f07907d503791f53c0963a9a22cf233d39d1337f5d1044e9814977455d9e6d5f4f2079a006a36c0d5bd3a2090b6ff8ad23c414

data/CHANGES.md

@@ -1,6 +1,18 @@
 # xqsr3 - Changes <!-- omit in toc -->
 
 
+## 0.39.7 - 19th August 2026
+
+* fixed **MultiMap**: no longer subclasses +Hash+ (data lived only in +@inner+, so inherited +keys+/+key?+ lied); added +keys+/+key?+/+include?+/+member?+; fixed +to_hash+; deep-copy on +dup+/+clone+; +MultiMap[]+ no longer mutates nested arrays; Hash merges splat array values consistently with +MultiMap[]+ / +to_h+;
+* fixed `IO.writelines` Hash EOL lookahead (+each_with_index+ was not destructuring key/value pairs);
+* aligned `xqsr3/extensions` (and thus `xqsr3/all_extensions`) with documented extension packs — now loads **integer**, **kernel**, and **string** as well as **enumerable/detect_map**;
+* fixed **FrequencyMap** (+#store(0)+ removes key; +#to_h+/+#to_hash+ return copies; +#[]+ / +#each_by_key+ docs);
+* fixed **ParameterChecking** (+#ignore_order+ recognised; +:types+ no longer mutates caller array) and **join_with_or** (+treat_as_option:+);
+* fixed `Enumerable#detect_map` to return falsy hits (+nil+ means continue);
+* fixed `Integer#to_s_grp` to honour +:separator+ for the single-group path;
+* fixed `ExceptionUtilities.raise_with_options` to use +set_backtrace+ instead of deprecated 3-arg +raise+; documented **WithCause** +#cause+ shadowing;
+
+
 ## 0.39.6 - 18th August 2026
 
 * fixed **BoolParser** default matching to require whole-string `true`/`false` (case-insensitive), aligned `:default_value` / `:true_value` / `:false_value` options with documented names (legacy `:default` / `:true` / `:false` still accepted), and allowed falsy override values;

data/NEWS.md

@@ -2,6 +2,7 @@
 
 | Date               | News Item                   |
 | ------------------ | --------------------------- |
+| 19th August 2026   | [**xqsr3** 0.39.7](https://github.com/synesissoftware/xqsr3/releases/tag/0.39.7) |
 | 18th August 2026   | [**xqsr3** 0.39.6](https://github.com/synesissoftware/xqsr3/releases/tag/0.39.6) |
 | 14th August 2026   | [**xqsr3** 0.39.5](https://github.com/synesissoftware/xqsr3/releases/tag/0.39.5) |
 | 12th August 2026   | [**xqsr3** 0.39.4.1](https://github.com/synesissoftware/xqsr3/releases/tag/0.39.4.1) |

data/README.md

@@ -87,6 +87,7 @@ and extensions to the following standard library components:
 * Array extensions
 * Enumerable extensions
 * Hash extensions
+* Integer extensions
 * IO extensions
 * Kernel extensions
 * String extensions

data/lib/xqsr3/array_utilities/join_with_or.rb

@@ -77,10 +77,10 @@ module ArrayUtilities
       ::Xqsr3::Quality::ParameterChecking.check_parameter ar, 'ar', type: ::Array, allow_nil: true
       ::Xqsr3::Quality::ParameterChecking.check_parameter options, 'options', type: ::Hash, allow_nil: false
 
-      ::Xqsr3::Quality::ParameterChecking.check_parameter options[:or], ':or', type: ::String, option: true, allow_nil: true
-      ::Xqsr3::Quality::ParameterChecking.check_parameter options[:oxford_comma], ':oxford_comma', types: [ ::FalseClass, ::TrueClass ], option: true, allow_nil: true
-      ::Xqsr3::Quality::ParameterChecking.check_parameter options[:quote_char], ':quote_char', type: ::String, option: true, allow_nil: true
-      ::Xqsr3::Quality::ParameterChecking.check_parameter options[:separator], ':separator', type: ::String, option: true, allow_nil: true
+      ::Xqsr3::Quality::ParameterChecking.check_parameter options[:or], ':or', type: ::String, treat_as_option: true, allow_nil: true
+      ::Xqsr3::Quality::ParameterChecking.check_parameter options[:oxford_comma], ':oxford_comma', types: [ ::FalseClass, ::TrueClass ], treat_as_option: true, allow_nil: true
+      ::Xqsr3::Quality::ParameterChecking.check_parameter options[:quote_char], ':quote_char', type: ::String, treat_as_option: true, allow_nil: true
+      ::Xqsr3::Quality::ParameterChecking.check_parameter options[:separator], ':separator', type: ::String, treat_as_option: true, allow_nil: true
 
       return '' if ar.nil?
       return '' if ar.empty?

data/lib/xqsr3/containers/frequency_map.rb

@@ -5,13 +5,13 @@
 # Purpose:  FrequencyMap container
 #
 # Created:  28th January 2005
-# Updated:  24th July 2024
+# Updated:  15th August 2026
 #
 # Home:     http://github.com/synesissoftware/xqsr3
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2005-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -203,7 +203,7 @@ module Containers
       false
     end
 
-    # Obtains the count for a given key, or +nil+ if the key does not exist
+    # Obtains the count for a given key, or +0+ if the key does not exist
     #
     # === Signature
     #
@@ -294,7 +294,8 @@ module Containers
     # Enumerates each entry pair - element + frequency - in key order
     #
     # Note: this method is more expensive than +each+ because an array of
-    # keys must be created and sorted from which enumeration is directed
+    # keys must be created and sorted from which enumeration is directed.
+    # Keys must be mutually comparable via +<=>+.
     def each_by_key
 
       sorted_elements = @elements.sort { |a, b| a[0] <=> b[0] }
@@ -588,7 +589,8 @@ module Containers
 
     # Causes an element with the given +key+ and +count+ to be stored. If an
     # element with the given +key+ already exists, its count will be adjusted,
-    # as will the total count
+    # as will the total count. A +count+ of +0+ removes the key (consistent
+    # with +#push+ reducing a count to zero).
     #
     # === Return
     #  +true+ if the element was inserted; +false+ if the element was
@@ -599,7 +601,13 @@ module Containers
 
       old_count = @elements[key] || 0
 
-      @elements.store key, count
+      if 0 == count
+
+        @elements.delete key
+      else
+
+        @elements.store key, count
+      end
 
       @count += count - old_count
 
@@ -612,16 +620,16 @@ module Containers
       @elements.to_a
     end
 
-    # Obtains reference to internal hash instance (which must *not* be modified)
+    # Obtains a +Hash+ copy of the instance contents
     def to_h
 
-      @elements.to_h
+      @elements.dup
     end
 
     # Obtains equivalent hash to instance
     def to_hash
 
-      @elements.to_hash
+      @elements.dup
     end
 
     # A string-form of the instance

data/lib/xqsr3/containers/multi_map.rb

@@ -5,13 +5,13 @@
 # Purpose:  multimap container
 #
 # Created:  21st March 2007
-# Updated:  24th July 2024
+# Updated:  15th August 2026
 #
 # Home:     http://github.com/synesissoftware/xqsr3
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2007-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -51,8 +51,8 @@
 module Xqsr3
 module Containers
 
-  # Hash-like class that stores as mapped values in arrays
-  class MultiMap < ::Hash
+  # Hash-like class that stores mapped values in arrays
+  class MultiMap
 
     include Enumerable
 
@@ -102,9 +102,10 @@ module Containers
 
               raise ArgumentError, "cannot pass an empty array in array of arrays initialiser" if ar.empty?
 
-              key = ar.shift
+              key = ar[0]
+              values = ar[1 ... ar.size]
 
-              ar.each { |value| h[key] << value }
+              values.each { |value| h[key] << value }
             end
 
             return self.[](h)
@@ -136,6 +137,18 @@ module Containers
       @inner = Hash.new
     end
 
+    # Deep-copies +@inner+ (and each values array) after +dup+/+clone+
+    def initialize_copy other
+
+      @merge_is_multi = other.instance_variable_get(:@merge_is_multi)
+      @inner = {}
+
+      other.instance_variable_get(:@inner).each do |k, vals|
+
+        @inner[k] = vals.dup
+      end
+    end
+
     # Obtains the values, if any, for the given key; returns +nil+ if no
     # values are stored
     def [] key
@@ -412,6 +425,16 @@ module Containers
       @inner.has_key? key
     end
 
+    alias include? has_key?
+    alias key? has_key?
+    alias member? has_key?
+
+    # An array of all keys in the instance
+    def keys
+
+      @inner.keys
+    end
+
     # Returns +true+ if any key has the given +value+; +false+ otherwise
     #
     # === Signature
@@ -533,18 +556,25 @@ module Containers
       case other
       when self.class
 
-        ;
+        other.each do |k, v|
+
+          self.push k, v
+        end
       when ::Hash
 
-        ;
-      else
+        other.each do |k, v|
 
-        raise TypeError, "parameter must be an instance of #{self.class} or #{Hash}"
-      end
+          if ::Array === v
+
+            self.push k, *v
+          else
 
-      other.each do |k, v|
+            self.push k, v
+          end
+        end
+      else
 
-        self.push k, v
+        raise TypeError, "parameter must be an instance of #{self.class} or #{Hash}"
       end
 
       self
@@ -598,7 +628,13 @@ module Containers
 
         other.each do |k, v|
 
-          self.store k, v
+          if ::Array === v
+
+            self.store k, *v
+          else
+
+            self.store k, v
+          end
         end
       else
 
@@ -680,10 +716,17 @@ module Containers
       @inner.to_h
     end
 
-    # Obtains equivalent hash to instance
+    # Obtains equivalent hash to instance (independent copy)
     def to_hash
 
-      @elements.to_hash
+      h = {}
+
+      @inner.each do |k, vals|
+
+        h[k] = vals.dup
+      end
+
+      h
     end
 
     # A string-form of the instance

data/lib/xqsr3/diagnostics/exception_utilities.rb

@@ -180,7 +180,8 @@ module Diagnostics
 
           bt = x.backtrace
           (0..called_indirectly).each { bt.shift }
-          Kernel.raise x, x.message, bt
+          x.set_backtrace bt
+          Kernel.raise x
         end
       end
 
@@ -204,7 +205,8 @@ module Diagnostics
 
         bt = x.backtrace
         (0..called_indirectly).each { bt.shift }
-        Kernel.raise x, x.message, bt
+        x.set_backtrace bt
+        Kernel.raise x
       end
     end
   end # module ExceptionUtilities

data/lib/xqsr3/diagnostics/exceptions/with_cause.rb

@@ -133,7 +133,9 @@ module Exceptions
     end
 
     # The cause / inner-exception, if any, specified to the instance
-    # initialiser
+    # initialiser. This attribute shadows +Exception#cause+ (the interpreter's
+    # raise-chain cause); for includers, +#cause+ refers to this module's
+    # +@cause+.
     attr_reader :cause
 
     # The options passed to the initialiser, with +:cause+ removed, if

data/lib/xqsr3/extensions/enumerable/detect_map.rb

@@ -5,13 +5,13 @@
 # Purpose:  ::Enumerable#detect_map extension
 #
 # Created:  3rd December 2017
-# Updated:  29th March 2024
+# Updated:  15th August 2026
 #
 # Home:     http://github.com/synesissoftware/xqsr3
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2017-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -54,13 +54,15 @@ module Enumerable
   # of a particular value in a collection. The only constraint is that you
   # get back the object unchanged.
   #
-  # The +Enumerable+#+map+ method provides a way to transform the contents of
-  # a collection. The only constraint is that you get back another
+  # The +Enumerable+#+map+ method provides a way to transform the contents
+  # of a collection. The only constraint is that you get back another
   # collection.
   #
   # This extension method, +Enumerable+#+detect_map+ combines the features
   # of both, in that it detects the presence of a particular value in a
-  # collection and transform the detected value.
+  # collection and transform the detected value. The block should return
+  # +nil+ to continue searching; any other value (including +false+ or +0+)
+  # is treated as a hit and returned immediately.
   #
   #  [ 1, 2, 3 ].detect_map { |v| -2 * v if v > 2 } # => -6
   #
@@ -75,13 +77,17 @@ module Enumerable
 
       self.each do |v|
 
-        r = yield(v) and return r
+        r = yield(v)
+
+        return r unless r.nil?
       end
     when 2
 
       self.each do |k, v|
 
-        r = yield(k, v) and return r
+        r = yield(k, v)
+
+        return r unless r.nil?
       end
     else
 

data/lib/xqsr3/extensions/enumerable.rb

@@ -1,4 +1,5 @@
 
 require 'xqsr3/extensions/enumerable/collect_with_index'
+require 'xqsr3/extensions/enumerable/detect_map'
 require 'xqsr3/extensions/enumerable/unique'
 

data/lib/xqsr3/extensions/integer/to_s_grp.rb

@@ -83,7 +83,7 @@ class Integer
       return self.to_s
     when 1
 
-      return self.to_s.chars.to_a.reverse.each_slice(numbers[0]).map(&:join).join(',').reverse
+      return self.to_s.chars.to_a.reverse.each_slice(numbers[0]).map(&:join).join(separator).reverse
     else
 
       reversed_chars = self.to_s.chars.to_a#.reverse

data/lib/xqsr3/extensions.rb

@@ -4,7 +4,10 @@
   array
   enumerable
   hash
+  integer
   io
+  kernel
+  string
 }.each do |name|
 
   require File.join(File.dirname(__FILE__), 'extensions', name)

data/lib/xqsr3/io/writelines.rb

@@ -5,13 +5,13 @@
 # Purpose:  Adds a writelines() method to the IO module
 #
 # Created:  13th April 2007
-# Updated:  12th April 2024
+# Updated:  15th August 2026
 #
 # Home:     http://github.com/synesissoftware/xqsr3
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2007-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -125,7 +125,7 @@ module IO
 
     if contents.instance_of? ::Hash
 
-      contents.each_with_index do |k, v, index|
+      contents.each_with_index do |(k, v), index|
 
         if eol_lookahead_limit && eol_lookahead_limit == index
 

data/lib/xqsr3/quality/parameter_checking.rb

@@ -82,6 +82,7 @@ module Quality
 
           allow_nil
           ignore_case
+          ignore_order
           message
           nil
           nothrow
@@ -118,6 +119,7 @@ module Quality
     #   - +:allow_nil+ (boolean) The +value+ must not be +nil+ unless this option is true;
     #   - +:nil+ an alias for +:allow_nil+;
     #   - +:ignore_case+ (boolean) When +:values+ is specified, comparisons of strings, or arrays of strings, will be carried out in a case-insensitive manner;
+    #   - +:ignore_order+ (boolean) When +:values+ is specified and +value+ is an +Array+, comparisons may ignore element order;
     #   - +:types+ (+Array+) An array of types one of which +value+ must be (or must be derived from). One of these types may be an array of types, in which case +value+ may be an array that must consist wholly of those types;
     #   - +:type+ (+Class+) A single type parameter, used only if +:types+ is not specified;
     #   - +:values+ (+Array+) an array of values one of which +value+ must be;
@@ -174,6 +176,7 @@ module Quality
     #   - +:allow_nil+ (boolean) The +value+ must not be +nil+ unless this option is true;
     #   - +:nil+ an alias for +:allow_nil+;
     #   - +:ignore_case+ (boolean) When +:values+ is specified, comparisons of strings, or arrays of strings, will be carried out in a case-insensitive manner;
+    #   - +:ignore_order+ (boolean) When +:values+ is specified and +value+ is an +Array+, comparisons may ignore element order;
     #   - +:types+ (+Array+) An array of types one of which +value+ must be (or must be derived from). One of these types may be an array of types, in which case +value+ may be an array that must consist wholly of those types;
     #   - +:type+ (+Class+) A single type parameter, used only if +:types+ is not specified;
     #   - +:values+ (+Array+) an array of values one of which +value+ must be;
@@ -328,7 +331,7 @@ module Quality
 
         # types
 
-        types = options[:types] || []
+        types = (options[:types] || []).dup
         if options.has_key? :type
 
           types << options[:type] if types.empty?

data/lib/xqsr3/version.rb

@@ -5,7 +5,7 @@
 # Purpose:  Version for Xqsr3 library
 #
 # Created:  3rd April 2016
-# Updated:  18th August 2026
+# Updated:  19th August 2026
 #
 # Home:     http://github.com/synesissoftware/xqsr3
 #
@@ -51,7 +51,7 @@
 module Xqsr3
 
   # Current version of the Xqsr3 library
-  VERSION           = '0.39.6'
+  VERSION           = '0.39.7'
 
   private
   VERSION_PARTS_    = VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:

data/test/unit/containers/tc_frequency_map.rb

@@ -889,6 +889,13 @@ class Test_Xqsr3_Containers_FrequencyMap < Test::Unit::TestCase
     assert_equal 2, fm.size
 
     assert_raise(::TypeError) { fm.store :ghi, :blah }
+
+    fm.store :abc, 0
+
+    assert_not fm.has_key?(:abc)
+    assert_equal 2, fm.count
+    assert_equal 1, fm.size
+    assert_equal 0, fm[:abc]
   end
 
   def test_to_a
@@ -918,7 +925,18 @@ class Test_Xqsr3_Containers_FrequencyMap < Test::Unit::TestCase
 
     fm << :def << :def << :def
 
-    assert_equal ({:abc => 2, :def => 3}), fm.to_h
+    h = fm.to_h
+
+    assert_equal ({:abc => 2, :def => 3}), h
+    assert_equal h, fm.to_hash
+    assert_not_same fm.instance_variable_get(:@elements), h
+
+    h[:abc] = 99
+    h[:xyz] = 1
+
+    assert_equal 2, fm[:abc]
+    assert_equal 5, fm.count
+    assert_not fm.has_key?(:xyz)
   end
 
   def test_values

data/test/unit/containers/tc_multi_map.rb

@@ -69,10 +69,12 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
   def test_class_operator_subscript_6
 
     ar = [ [ :abc, '1' ] ]
+    nested = ar[0]
 
     mm = MultiMap[ar]
 
     assert_equal 1, ar.size
+    assert_equal [ :abc, '1' ], nested
     assert_equal 1, mm.size
     assert_equal [ '1' ], mm[:abc]
 
@@ -81,6 +83,8 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
     mm = MultiMap[ar]
 
     assert_equal 2, ar.size
+    assert_equal [ :abc, '1' ], ar[0]
+    assert_equal [ :def, '2' ], ar[1]
     assert_equal 2, mm.size
     assert_equal [ '1' ], mm[:abc]
     assert_equal [ '2' ], mm[:def]
@@ -253,6 +257,18 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
     mm2 = mm1.dup
 
     assert_eql mm1, mm2
+
+    mm2.push :xyz, 'x1'
+
+    assert_not mm1.has_key?(:xyz)
+    assert mm2.has_key?(:xyz)
+    assert_equal 3, mm1.size
+    assert_equal 4, mm2.size
+
+    mm2[:abc] << 'a5'
+
+    assert_equal [ 'a1', 'a2', 'a3', 'a4' ], mm1[:abc]
+    assert_equal [ 'a1', 'a2', 'a3', 'a4', 'a5' ], mm2[:abc]
   end
 
   def test_each
@@ -538,16 +554,35 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
     mm = MultiMap.new
 
     assert_not mm.has_key? :abc
+    assert_not mm.key? :abc
+    assert_not mm.include? :abc
+    assert_not mm.member? :abc
 
     mm.push :abc, *[ :v1, :v2 ]
 
     assert mm.has_key? :abc
+    assert mm.key? :abc
+    assert mm.include? :abc
+    assert mm.member? :abc
 
     mm.delete :abc
 
     assert_not mm.has_key? :abc
   end
 
+  def test_keys
+
+    mm = MultiMap.new
+
+    assert_equal [], mm.keys
+
+    mm.push :def
+    mm.push :abc, 'a1'
+    mm.push :ghi, 'g1', 'g2'
+
+    assert_equal [ :abc, :def, :ghi ], mm.keys.sort
+  end
+
   def test_has_value?
 
     mm = MultiMap.new
@@ -705,6 +740,10 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
     mm1.multi_merge! h
 
     assert_equal [ :abc, 1, :abc, 2, :abc, 3, :abc, 4, :abc, 5, :def, 'a', :ghi, 'x' ], mm1.flatten
+
+    mm1.multi_merge!({ abc: [ 6 ], jkl: [ 'y', 'z' ] })
+
+    assert_equal [ :abc, 1, :abc, 2, :abc, 3, :abc, 4, :abc, 5, :abc, 6, :def, 'a', :ghi, 'x', :jkl, 'y', :jkl, 'z' ], mm1.flatten
   end
 
   def test_strict_merge
@@ -868,6 +907,26 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
     assert_equal ({ abc: [ 1, 2, 3, 4, 5 ], def: [] }), mm.to_h
   end
 
+  def test_to_hash
+
+    mm = MultiMap.new
+
+    mm.push :abc, 1, 2
+    mm.push :def, 'd'
+
+    h = mm.to_hash
+
+    assert_equal ({ abc: [ 1, 2 ], def: [ 'd' ] }), h
+    assert_equal h, mm.to_h
+    assert_not_same mm.to_h, h
+
+    h[:abc] << 3
+    h[:ghi] = [ 'x' ]
+
+    assert_equal [ 1, 2 ], mm[:abc]
+    assert_not mm.has_key?(:ghi)
+  end
+
   def test_values_unflattened
 
     mm = MultiMap.new

data/test/unit/extensions/enumerable/tc_detect_map.rb

@@ -22,6 +22,9 @@ class Test_Enumerable_detect_map < Test::Unit::TestCase
     assert_nil [].detect_map { |v| return -2 * v }
     assert_equal(-2, [ 1, 2, 3, 4, 5 ].detect_map { |v| -2 * v })
     assert_equal(-4, [ 1, 2, 3, 4, 5 ].detect_map { |v| -2 * v if 2 == v })
+
+    assert_equal false, [ 1, 2, 3 ].detect_map { |v| false if 1 == v }
+    assert_equal 0, [ 1, 2, 3 ].detect_map { |v| 0 if 2 == v }
   end
 
   def test_with_hash

data/test/unit/extensions/integer/tc_to_s_grp.rb

@@ -22,6 +22,9 @@ class Test_X_Integer_to_s_grp < Test::Unit::TestCase
     assert_equal "8,7,6,5,4,3,2,1", 87654321.to_s_grp(1)
 
     assert_equal "876,54321", 87654321.to_s_grp(5)
+
+    assert_equal "87 654 321", 87654321.to_s_grp(3, separator: ' ')
+    assert_equal "87_654_321", 87654321.to_s_grp(3, separator: '_')
   end
 
   def test_array_with_single_number

data/test/unit/extensions/tc_extensions_pack.rb

@@ -0,0 +1,35 @@
+#! /usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), '../../../lib')
+
+
+require 'xqsr3/extensions'
+
+require 'xqsr3/extensions/test/unit'
+require 'test/unit'
+
+
+class Test_Xqsr3_extensions_pack < Test::Unit::TestCase
+
+  def test_extensions_pack_loads_documented_surfaces
+
+    assert [].respond_to?(:join_with_or)
+    assert [].respond_to?(:collect_with_index)
+    assert [].respond_to?(:detect_map)
+    assert [].respond_to?(:unique)
+    assert Hash.new.respond_to?(:deep_transform)
+    assert 1234.respond_to?(:to_s_grp)
+    assert ::IO.respond_to?(:writelines)
+    assert ''.respond_to?(:starts_with?)
+    assert ''.respond_to?(:truncate)
+    assert_equal 16, Integer('10', 16)
+  end
+
+  def test_all_extensions_loads_test_unit_assertions
+
+    require 'xqsr3/all_extensions'
+
+    assert self.respond_to?(:assert_true)
+    assert self.respond_to?(:assert_raise_with_message)
+  end
+end

data/test/unit/io/tc_writelines.rb

@@ -182,6 +182,30 @@ class Test_Xqsr3_IO_writelines < Test::Unit::TestCase
     assert_equal "abc\ndef\nghi\n", s.string
   end
 
+  def test_hash_value_with_embedded_eol
+
+    input = { 'ab' => "c\nmore", 'de' => 'f' }
+
+    s = StringIO.new
+
+    r = ::Xqsr3::IO.writelines s, input
+
+    assert_equal 2, r
+    assert_equal "abc\nmoredef", s.string
+  end
+
+  def test_hash_key_with_embedded_eol
+
+    input = { "ab\nx" => 'c', 'de' => 'f' }
+
+    s = StringIO.new
+
+    r = ::Xqsr3::IO.writelines s, input
+
+    assert_equal 2, r
+    assert_equal "ab\nxcdef", s.string
+  end
+
   def test_strings_with_cr_in_array_and_line_sep
 
     input = [ "abc\n", "def\n", "ghi\n" ]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: xqsr3
 version: !ruby/object:Gem::Version
-  version: 0.39.6
+  version: 0.39.7
 platform: ruby
 authors:
 - Matt Wilson
@@ -136,7 +136,7 @@ files:
 - test/unit/extensions/kernel/ts_all.rb
 - test/unit/extensions/object/tc_inspect.rb
 - test/unit/extensions/object/ts_all.rb
-- test/unit/extensions/string/tc_bool.tb
+- test/unit/extensions/string/tc_bool.rb
 - test/unit/extensions/string/tc_ends_with.rb
 - test/unit/extensions/string/tc_map_option_string.rb
 - test/unit/extensions/string/tc_nil_if_empty.rb
@@ -146,6 +146,7 @@ files:
 - test/unit/extensions/string/tc_to_symbol.rb
 - test/unit/extensions/string/tc_truncate.rb
 - test/unit/extensions/string/ts_all.rb
+- test/unit/extensions/tc_extensions_pack.rb
 - test/unit/extensions/test/ts_all.rb
 - test/unit/extensions/test/unit/tc_assert_raise_with_message.rb
 - test/unit/extensions/test/unit/tc_assert_subclass_of.rb