xqsr3 0.39.3.1 → 0.39.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7dd39b2f95697c84c5d7e599dd3feb956883e0d5950ed9d2894e9ef5829a0e53
-  data.tar.gz: ab426c419cd34a2c44ee75b3e866b40d34cbd4c33873fd343ca468460652de4b
+  metadata.gz: 4e63b8dde2a14ae264102be78c1da869c7f7dcc810633eb074077f21b7b54080
+  data.tar.gz: 7148e5f24c3d9583d67c4bd13561538e2b07bd785b4e7c8fcc365a4fac2b2d6b
 SHA512:
-  metadata.gz: dcbb5b6926e7c4fb9c0763b081e473fa5c77ff7f1ae76b371e375b3b82fdc629180fc414fe3aa242599352ddaecbabcd26af759c50960b71618456f19ce5c0a9
-  data.tar.gz: 2208ff7f78a3db75dd7262a3e5849c4534b02a4ae923a5d48e7a66ed516c4d702a101d1419eb437a7868c7526d7fce7be011213a1d97279ce7cd86c10e18f0c9
+  metadata.gz: 954a1646bcc17c2a08ebfb420d480fa207aaa6c0f5da8fdad255d44b2e65cc953bc8ae9a8d269356e6cb1b586f3e9631b2602a8510baa40be40f96aa8ee9e52b
+  data.tar.gz: a06d5f01e2b87d3a0483958a26bbdbc45ad1a5df58a3b6381b914106e4f996cf12fe01bfaedc144689fdf69ae94ab251fb644e7287e9e290a2aba0b9a185521a

data/README.md

@@ -1,8 +1,13 @@
 # xqsr3 <!-- omit in toc -->
 
+![Language](https://img.shields.io/badge/Ruby-CC342D?style=flat&logo=ruby&logoColor=white)
+[![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+[![Gem Version](https://badge.fury.io/rb/xqsr3.svg)](https://badge.fury.io/rb/xqsr3)
+[![Last Commit](https://img.shields.io/github/last-commit/synesissoftware/xqsr3)](https://github.com/synesissoftware/xqsr3/commits/master)
+[![Ruby](https://github.com/synesissoftware/xqsr3/actions/workflows/ruby.yml/badge.svg)](https://github.com/synesissoftware/xqsr3/actions/workflows/ruby.yml)
+
 e**X**tensions by fine **Q**uantum for **S**tandard **R**uby and **3**rd-party libraries
 
-[![Gem Version](https://badge.fury.io/rb/xqsr3.svg)](https://badge.fury.io/rb/xqsr3)
 
 ## Introduction
 
@@ -24,6 +29,7 @@ It may be pronounced (lamely) as "excusers".
 	- [Related projects](#related-projects)
 	- [License](#license)
 
+
 ## Installation
 
 Install via **gem** as in:
@@ -50,6 +56,7 @@ require 'xqsr3/extensions/test/unit'
 
 which brings in nine extensions.
 
+
 ## Components
 
 **xqsr3** provides components in the following categories:
@@ -77,20 +84,25 @@ and extensions to the following standard library components:
 * String extensions
 * test/unit extensions
 
+
 ## Examples
 
 Examples are provided in the ```examples``` directory, along with a markdown description for each. A detailed list TOC of them is provided in [EXAMPLES.md](./EXAMPLES.md).
 
+
 ## Project Information
 
+
 ### Where to get help
 
 [GitHub Page](https://github.com/synesissoftware/xqsr3 "GitHub Page")
 
+
 ### Contribution guidelines
 
 Defect reports, feature requests, and pull requests are welcome on https://github.com/synesissoftware/xqsr3.
 
+
 ### Related projects
 
 **xqsr3** is a runtime dependency of:
@@ -109,6 +121,7 @@ and a development dependency of:
 * the **[recls.Ruby](https://github.com/synesissoftware/recls.Ruby)** library;
 * the **[Quench.Ruby](https://github.com/synesissoftware/Quench.Ruby)** library.
 
+
 ### License
 
 **xqsr3** is released under the 3-clause BSD license. See [LICENSE](./LICENSE) for details.

data/Rakefile

@@ -0,0 +1,19 @@
+# Rakefile for xqsr3
+
+require 'rake/testtask'
+
+
+Rake::TestTask.new do |tt|
+
+  tt.libs << "lib"
+  tt.name = "test"
+  tt.test_files = FileList['test/**/tc_*.rb']
+  tt.verbose = true
+end
+
+
+task :default => :test
+
+
+# ############################## end of file ############################# #
+

data/lib/xqsr3/internal_/test_ruby_version_.rb

@@ -0,0 +1,132 @@
+
+# ######################################################################## #
+# File:     lib/xqsr3/internal_/test_ruby_version_.rb
+#
+# Purpose:  Provides reliable mechanism for checking the version of the
+#           Test::Unit module
+#
+# Created:  29th August 2025
+# Updated:  29th August 2025
+#
+# Home:     http://github.com/synesissoftware/xqsr3
+#
+# Author:   Matthew Wilson
+#
+# Copyright (c) 2025, Matthew Wilson and Synesis Information Systems
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions are
+# met:
+#
+# * Redistributions of source code must retain the above copyright notice,
+#   this list of conditions and the following disclaimer.
+#
+# * Redistributions in binary form must reproduce the above copyright
+#   notice, this list of conditions and the following disclaimer in the
+#   documentation and/or other materials provided with the distribution.
+#
+# * Neither the name of the copyright holder nor the names of its
+#   contributors may be used to endorse or promote products derived from
+#   this software without specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
+# IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
+# THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
+# CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+# EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+# PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+# PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+# LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+# NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+#
+# ######################################################################## #
+
+
+# :stopdoc:
+
+module Xqsr3
+module Internal_ # :nodoc:
+module TestRubyVersion_ # :nodoc:
+
+  RUBY_VERSION_PARTS_ = RUBY_VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:
+
+  RUBY_VERSION_MAJOR_ = RUBY_VERSION_PARTS_[0] # :nodoc:
+  RUBY_VERSION_MINOR_ = RUBY_VERSION_PARTS_[1] # :nodoc:
+  RUBY_VERSION_PATCH_ = RUBY_VERSION_PARTS_[2] # :nodoc:
+
+  # @!visibility private
+  def self.less_ a1, a2 # :nodoc:
+
+    n_common = a1.size < a2.size ? a1.size : a2.size
+
+    (0...n_common).each do |ix|
+
+      v1 = a1[ix]
+      v2 = a2[ix]
+
+      if v1 == v2
+
+        next
+      end
+
+      if v1 < v2
+
+        return true
+      else
+
+        return false
+      end
+    end
+
+    if n_common != a2.size
+
+      return true
+    else
+
+      return false
+    end
+  end
+
+  # @!visibility private
+  def self.is_major_at_least? j # :nodoc:
+
+    return unless RUBY_VERSION_MAJOR_
+
+    return j >= RUBY_VERSION_MAJOR_
+  end
+
+  # @!visibility private
+  def self.is_minor_at_least? n # :nodoc:
+
+    return unless RUBY_VERSION_MINOR_
+
+    return n >= RUBY_VERSION_MINOR_
+  end
+
+  # @!visibility private
+  def self.is_at_least? v # :nodoc:
+
+    v = v.split(/\./).collect { |n| n.to_i } if String === v
+
+    return !less_(RUBY_VERSION_PARTS_, v)
+  end
+
+  # @!visibility private
+  def self.is_less? v # :nodoc:
+
+    v = v.split(/\./).collect { |n| n.to_i } if String === v
+
+    return less_(RUBY_VERSION_PARTS_, v)
+  end
+
+end # module TestRubyVersion_
+end # module Internal_
+end # module Xqsr3
+
+# :startdoc:
+
+# ############################## end of file ############################# #
+

data/lib/xqsr3/quality/parameter_checking.rb

@@ -5,13 +5,13 @@
 # Purpose:  Definition of the ParameterChecking module
 #
 # Created:  12th February 2015
-# Updated:  12th April 2024
+# Updated:  29th August 2025
 #
 # Home:     http://github.com/synesissoftware/xqsr3
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2025, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2016-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -254,11 +254,11 @@ module Quality
 
         unless unrecognised_option_names.empty?
 
-          s = "#{self}::check_parameter: the following options are not recognised:"
+          warn_msg = "#{self}::check_parameter: the following options are not recognised:"
 
-          unrecognised_option_names.each { |n| s += "\n\t'#{n}'" }
+          unrecognised_option_names.each { |n| warn_msg += "\n\t'#{n}'" }
 
-          warn s
+          warn warn_msg
         end
       end
 
@@ -603,7 +603,7 @@ module Quality
                 value_uc = value.upcase
               when :array_of_strings
 
-                value_uc = value.map { |s| s.upcase }
+                value_uc = value.map(&:upcase)
                 value_uc = value_uc.sort if io
               end
             end
@@ -622,7 +622,7 @@ module Quality
                 end
               when :array_of_strings
 
-                v_uc = v.map { |s| s.upcase }
+                v_uc = v.map(&:upcase)
                 v_uc = v_uc.sort if io
 
                 if value_uc == v_uc

data/lib/xqsr3/version.rb

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

data/test/unit/containers/tc_multi_map.rb

@@ -8,12 +8,16 @@ require 'xqsr3/containers/multi_map'
 require 'xqsr3/extensions/test/unit'
 require 'test/unit'
 
+require 'xqsr3/internal_/test_ruby_version_'
+
 
 include ::Xqsr3::Containers
 
 
 class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
 
+  RUBY_IS_3_4_OR_LATER = Xqsr3::Internal_::TestRubyVersion_.is_at_least? [ 3, 4 ]
+
   def test_class_operator_subscript_1
 
     mm = MultiMap[]
@@ -908,21 +912,49 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
 
     assert_equal "{}", mm.to_s
 
+
     mm.store :abc
 
-    assert_equal "{:abc=>[]}", mm.to_s
+    if RUBY_IS_3_4_OR_LATER
+
+      assert_equal "{abc: []}", mm.to_s
+    else
+
+      assert_equal "{:abc=>[]}", mm.to_s
+    end
+
 
     mm.store :abc, 1
 
-    assert_equal "{:abc=>[1]}", mm.to_s
+    if RUBY_IS_3_4_OR_LATER
+
+      assert_equal "{abc: [1]}", mm.to_s
+    else
+
+      assert_equal "{:abc=>[1]}", mm.to_s
+    end
+
 
     mm.store :abc, 1, 23
 
-    assert_equal "{:abc=>[1, 23]}", mm.to_s
+    if RUBY_IS_3_4_OR_LATER
+
+      assert_equal "{abc: [1, 23]}", mm.to_s
+    else
+
+      assert_equal "{:abc=>[1, 23]}", mm.to_s
+    end
+
 
     mm.store :def, *(0...10).to_a
 
-    assert_equal "{:abc=>[1, 23], :def=>[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]}", mm.to_s
+    if RUBY_IS_3_4_OR_LATER
+
+      assert_equal "{abc: [1, 23], def: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9]}", mm.to_s
+    else
+
+      assert_equal "{:abc=>[1, 23], :def=>[0, 1, 2, 3, 4, 5, 6, 7, 8, 9]}", mm.to_s
+    end
   end
 end
 

data/test/unit/diagnostics/exceptions/tc_with_cause.rb

@@ -5,11 +5,17 @@ $:.unshift File.join(File.dirname(__FILE__), '../../../../lib')
 
 require 'xqsr3/diagnostics/exceptions/with_cause'
 
+require 'xqsr3/extensions/test/unit'
 require 'test/unit'
 
+require 'xqsr3/internal_/test_ruby_version_'
+
+
 
 class Test_WithCause < Test::Unit::TestCase
 
+  RUBY_IS_3_4_OR_LATER = Xqsr3::Internal_::TestRubyVersion_.is_at_least? [ 3, 4 ]
+
   class SomeExceptionWithCause < ::Exception
 
     include ::Xqsr3::Diagnostics::Exceptions::WithCause
@@ -179,6 +185,8 @@ end
 
 class Test_WithCause_throwing < Test::Unit::TestCase
 
+  RUBY_IS_3_4_OR_LATER = Xqsr3::Internal_::TestRubyVersion_.is_at_least? [ 3, 4 ]
+
   class SomeExceptionWithCause < ::Exception
 
     include ::Xqsr3::Diagnostics::Exceptions::WithCause
@@ -226,9 +234,12 @@ class Test_WithCause_throwing < Test::Unit::TestCase
       assert_empty x.chainees
       assert_not_empty x.backtrace
 
+
       x_bt0 = x.backtrace[0]
 
-      assert (/:in\s+\`f\'\s*$/ =~ x_bt0), 'not receieved from f()'
+      re = RUBY_IS_3_4_OR_LATER ? /:\d+:in\s+'#{self.class.name}#f'\s*$/ : /:\d+:in\s+\`f'\s*$/
+
+      assert_match(re, x_bt0, "The received backtrace line '#{x_bt0}' in the exception received from `f()` did not match the expected pattern '#{re}'")
     end
   end
 
@@ -249,13 +260,20 @@ class Test_WithCause_throwing < Test::Unit::TestCase
       assert_not_empty x.backtrace
       assert_not_empty x.cause.backtrace
 
+
       x_bt0 = x.backtrace[0]
 
-      assert (/:in\s+\`rescue in g\'\s*$/ =~ x_bt0), 'not receieved from g()'
+      re_x = RUBY_IS_3_4_OR_LATER ? /\d+:in\s+'#{self.class.name}#g'\s*$/ : /\d+:in\s+\`rescue in g'\s*$/
+
+      assert_match(re_x, x_bt0, "The received backtrace line '#{x_bt0}' in the exception received from `g()` did not match the expected pattern '#{re_x}'")
+
 
       c_bt0 = x.cause.backtrace[0]
 
-      assert (/:in\s+\`f\'\s*$/ =~ c_bt0), 'not receieved from f()'
+      re_c = RUBY_IS_3_4_OR_LATER ? /:in\s+'#{self.class.name}#f'\s*$/ : /:\d+:in\s+\`f'\s*$/
+
+      assert_match(re_c, c_bt0, "The received backtrace line '#{x_bt0}' in the exception received from `f()` (via `g()`) did not match the expected pattern '#{re_c}'")
+
 
       assert_not_empty x.chained_backtrace
     end

metadata

@@ -1,19 +1,33 @@
 --- !ruby/object:Gem::Specification
 name: xqsr3
 version: !ruby/object:Gem::Version
-  version: 0.39.3.1
+  version: 0.39.4
 platform: ruby
 authors:
 - Matt Wilson
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-03-06 00:00:00.000000000 Z
-dependencies: []
+date: 2025-08-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2'
 description: |
   eXtensions by fine Quantum for Standard Ruby and 3rd-party libraries is a
-  lightweight, low-coupling library of assorted extensions to standard Ruby and
-  3rd-party libraries.
+  lightweight, low-coupling library of assorted extensions to standard Ruby
+  and 3rd-party libraries.
 email: matthew@synesis.com.au
 executables: []
 extensions: []
@@ -21,6 +35,7 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- Rakefile
 - examples/count_word_frequencies.md
 - examples/count_word_frequencies.rb
 - lib/xqsr3/all_extensions.rb
@@ -82,6 +97,7 @@ files:
 - lib/xqsr3/hash_utilities.rb
 - lib/xqsr3/hash_utilities/deep_transform.rb
 - lib/xqsr3/hash_utilities/key_matching.rb
+- lib/xqsr3/internal_/test_ruby_version_.rb
 - lib/xqsr3/internal_/test_unit_version_.rb
 - lib/xqsr3/io/writelines.rb
 - lib/xqsr3/quality.rb
@@ -160,7 +176,7 @@ homepage: http://github.com/synesissoftware/xqsr3
 licenses:
 - BSD-3-Clause
 metadata: {}
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -178,8 +194,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.15
-signing_key:
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
 summary: xqsr3
 test_files: []