xqsr3 0.38.2 → 0.39.1

data/lib/xqsr3/hash_utilities/deep_transform.rb

@@ -2,16 +2,16 @@
 # ######################################################################## #
 # File:     lib/xqsr3/hash_utilities/deep_transform.rb
 #
-# Purpose:  Definition of the Xqsr3::HashUtilities::DeepTransform module
+# Purpose:  Definition of the ::Xqsr3::HashUtilities::DeepTransform module
 #
 # Created:  3rd June 2017
-# Updated:  11th December 2023
+# Updated:  29th March 2024
 #
 # Home:     http://github.com/synesissoftware/xqsr3
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2023, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2017-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -58,94 +58,94 @@ module HashUtilities
 
 module DeepTransform
 
-	private
-	def self.do_deep_transform_on_hashlike_ h, &block # :nodoc:
+  private
+  def self.do_deep_transform_on_hashlike_ h, &block # :nodoc:
 
-		::Xqsr3::Quality::ParameterChecking.check_parameter h, 'h', responds_to: [ :map ]
+    ::Xqsr3::Quality::ParameterChecking.check_parameter h, 'h', responds_to: [ :map ]
 
-		case block.arity
-		when 1
+    case block.arity
+    when 1
 
-			h =
-			Hash[h.map do |k, v|
+      h =
+      Hash[h.map do |k, v|
 
-				k = k.deep_transform(&block) if ::Hash === k
-				v = v.deep_transform(&block) if ::Hash === v
+        k = k.deep_transform(&block) if ::Hash === k
+        v = v.deep_transform(&block) if ::Hash === v
 
-				[yield(k), v]
-			end]
-		when 2
+        [yield(k), v]
+      end]
+    when 2
 
-			h =
-			Hash[h.map do |k, v|
+      h =
+      Hash[h.map do |k, v|
 
-				k = k.deep_transform(&block) if ::Hash === k
-				v = v.deep_transform(&block) if ::Hash === v
+        k = k.deep_transform(&block) if ::Hash === k
+        v = v.deep_transform(&block) if ::Hash === v
 
-				yield(k, v)
-			end]
-		else
+        yield(k, v)
+      end]
+    else
 
-			raise ArgumentError, "block arity must be 1 or 2"
-		end
+      raise ArgumentError, "block arity must be 1 or 2"
+    end
 
-		h
-	end
+    h
+  end
 
-	def do_deep_transform_on_self_ &block # :nodoc:
+  def do_deep_transform_on_self_ &block # :nodoc:
 
-		::Xqsr3::Quality::ParameterChecking.check_parameter h, 'h', responds_to: [ :[]=, :delete, :keys ]
+    ::Xqsr3::Quality::ParameterChecking.check_parameter h, 'h', responds_to: [ :[]=, :delete, :keys ]
 
-		case block.arity
-		when 1
+    case block.arity
+    when 1
 
-			self.keys.each do |k|
+      self.keys.each do |k|
 
-				v	=	self.delete k
+        v = self.delete k
 
-				k	=	k.deep_transform(&block) if ::Hash === k
-				v	=	v.deep_transform(&block) if ::Hash === v
+        k = k.deep_transform(&block) if ::Hash === k
+        v = v.deep_transform(&block) if ::Hash === v
 
-				self[yield(k)] = v
-			end
-		when 2
+        self[yield(k)] = v
+      end
+    when 2
 
-			self.keys.each do |k|
+      self.keys.each do |k|
 
-				v	=	self.delete k
+        v = self.delete k
 
-				k	=	k.deep_transform(&block) if ::Hash === k
-				v	=	v.deep_transform(&block) if ::Hash === v
+        k = k.deep_transform(&block) if ::Hash === k
+        v = v.deep_transform(&block) if ::Hash === v
 
-				k, v	=	yield(k, v)
-			end
-		else
+        k, v = yield(k, v)
+      end
+    else
 
-			raise ArgumentError, "block arity must be 1 or 2"
-		end
-	end
-	public
+      raise ArgumentError, "block arity must be 1 or 2"
+    end
+  end
+  public
 
-	# Executes the given mandatory 1- or 2-parameter block on the receiving
-	# instance, which must be a Hash or a type that responds to the +map+
-	# message, returning a copy of the instance in which keys (1-parameter
-	# block) or keys and values (2-parameter block) are transformed.
-	def deep_transform &block
+  # Executes the given mandatory 1- or 2-parameter block on the receiving
+  # instance, which must be a Hash or a type that responds to the +map+
+  # message, returning a copy of the instance in which keys (1-parameter
+  # block) or keys and values (2-parameter block) are transformed.
+  def deep_transform &block
 
-		DeepTransform.do_deep_transform_on_hashlike_(self, &block)
-	end
+    DeepTransform.do_deep_transform_on_hashlike_(self, &block)
+  end
 
-	# Executes the given mandatory 1- or 2-parameter block on the receiving
-	# instance, whihc must be a Hash or a type that responds to +[]+,
-	# +delete+, and +keys+ messages, changing the keys (1-parameter block)
-	# or keys and values (2-parameter block).
-	#
-	# @note This method is not strongly exception-safe - failure during
-	#  transformation can result in a partially transformed instance
-	def deep_transform! &block
+  # Executes the given mandatory 1- or 2-parameter block on the receiving
+  # instance, whihc must be a Hash or a type that responds to +[]+,
+  # +delete+, and +keys+ messages, changing the keys (1-parameter block)
+  # or keys and values (2-parameter block).
+  #
+  # @note This method is not strongly exception-safe - failure during
+  #  transformation can result in a partially transformed instance
+  def deep_transform! &block
 
-		do_deep_transform_on_self_(&block)
-	end
+    do_deep_transform_on_self_(&block)
+  end
 
 end # module DeepTransform
 

data/lib/xqsr3/hash_utilities/key_matching.rb

@@ -2,16 +2,16 @@
 # ######################################################################## #
 # File:     lib/xqsr3/hash_utilities/key_matching.rb
 #
-# Purpose:  Definition of the Xqsr3::HashUtilities::KeyMatching module
+# Purpose:  Definition of the ::Xqsr3::HashUtilities::KeyMatching module
 #
 # Created:  15th November 2017
-# Updated:  11th December 2023
+# Updated:  29th March 2024
 #
 # Home:     http://github.com/synesissoftware/xqsr3
 #
 # Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2023, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2017-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -60,113 +60,113 @@ module HashUtilities
 # and #match methods
 module KeyMatching
 
-	private
-	def self.do_match_ h, re, **options # :nodoc:
+  private
+  def self.do_match_ h, re, **options # :nodoc:
 
-		::Xqsr3::Quality::ParameterChecking.check_parameter h, 'h', responds_to: [ :[], :has_key?, :each ]
+    ::Xqsr3::Quality::ParameterChecking.check_parameter h, 'h', responds_to: [ :[], :has_key?, :each ]
 
-		return h[re] if h.has_key? re
+    return h[re] if h.has_key? re
 
-		case re
-		when ::Regexp
+    case re
+    when ::Regexp
 
-			h.each do |k, v|
+      h.each do |k, v|
 
-				case k
-				when ::Regexp
+        case k
+        when ::Regexp
 
-					next
-				else
+          next
+        else
 
-					return v if k.to_s =~ re
-				end
-			end
-		else
+          return v if k.to_s =~ re
+        end
+      end
+    else
 
-			h.each do |k, v|
+      h.each do |k, v|
 
-				case k
-				when ::Regexp
+        case k
+        when ::Regexp
 
-					return v if re.to_s =~ k
-				else
+          return v if re.to_s =~ k
+        else
 
-					next
-				end
-			end
-		end
+          next
+        end
+      end
+    end
 
-		nil
-	end
+    nil
+  end
 
-	def self.do_has_match_ h, re, **options # :nodoc:
+  def self.do_has_match_ h, re, **options # :nodoc:
 
-		::Xqsr3::Quality::ParameterChecking.check_parameter h, 'h', responds_to: [ :[], :has_key?, :each ]
+    ::Xqsr3::Quality::ParameterChecking.check_parameter h, 'h', responds_to: [ :[], :has_key?, :each ]
 
-		return true if h.has_key? re
+    return true if h.has_key? re
 
-		case re
-		when ::Regexp
+    case re
+    when ::Regexp
 
-			h.each do |k, v|
+      h.each do |k, v|
 
-				case k
-				when ::Regexp
+        case k
+        when ::Regexp
 
-					next
-				else
+          next
+        else
 
-					return true if k.to_s =~ re
-				end
-			end
-		else
+          return true if k.to_s =~ re
+        end
+      end
+    else
 
-			h.each do |k, v|
+      h.each do |k, v|
 
-				case k
-				when ::Regexp
+        case k
+        when ::Regexp
 
-					return true if re.to_s =~ k
-				else
+          return true if re.to_s =~ k
+        else
 
-					next
-				end
-			end
-		end
+          next
+        end
+      end
+    end
 
-		false
-	end
-	public
+    false
+  end
+  public
 
-	# Retrieves the value object corresponding to the first key object that
-	# matches the given +re+, in the hash +h+, according to the given
-	# options.
-	def self.match h, re, **options
+  # Retrieves the value object corresponding to the first key object that
+  # matches the given +re+, in the hash +h+, according to the given
+  # options.
+  def self.match h, re, **options
 
-		Xqsr3::HashUtilities::KeyMatching.do_match_ h, re, **options
-	end
+    Xqsr3::HashUtilities::KeyMatching.do_match_ h, re, **options
+  end
 
-	# Returns true if the hash +h+ contains a key object that matches the
-	# given +re+, according to the given options
-	def self.has_match? h, re, **options
+  # Returns true if the hash +h+ contains a key object that matches the
+  # given +re+, according to the given options
+  def self.has_match? h, re, **options
 
-		Xqsr3::HashUtilities::KeyMatching.do_has_match_ h, re, **options
-	end
+    Xqsr3::HashUtilities::KeyMatching.do_has_match_ h, re, **options
+  end
 
-	# Retrieves the value object corresponding to the first key object that
-	# matches the given +re+, in the hash +h+, according to the given
-	# options.
-	def match h, re, **options
+  # Retrieves the value object corresponding to the first key object that
+  # matches the given +re+, in the hash +h+, according to the given
+  # options.
+  def match h, re, **options
 
-		Xqsr3::HashUtilities::KeyMatching.do_match_ h, re, **options
-	end
+    Xqsr3::HashUtilities::KeyMatching.do_match_ h, re, **options
+  end
 
-	# Returns true if the hash +h+ contains a key object that matches the
-	# given +re+, according to the given options
-	def has_match? h, re, **options
+  # Returns true if the hash +h+ contains a key object that matches the
+  # given +re+, according to the given options
+  def has_match? h, re, **options
 
-		Xqsr3::HashUtilities::KeyMatching.do_has_match_ h, re, **options
-	end
+    Xqsr3::HashUtilities::KeyMatching.do_has_match_ h, re, **options
+  end
 
 end # module KeyMatching
 

data/lib/xqsr3/hash_utilities.rb

@@ -1,11 +1,11 @@
 
 %w{
 
-	deep_transform
-	key_matching
+  deep_transform
+  key_matching
 }.each do |name|
 
-	require File.join(File.dirname(__FILE__), 'hash_utilities', name)
+  require File.join(File.dirname(__FILE__), 'hash_utilities', name)
 end
 
 

data/lib/xqsr3/internal_/test_unit_version_.rb

@@ -49,128 +49,128 @@ require 'test/unit'
 
 begin
 
-	require 'test/unit/version'
+  require 'test/unit/version'
 
-	# :stopdoc:
-	# @!visibility private
-	module Xqsr3
-	# @!visibility private
-	module Internal_ # :nodoc:
-	# @!visibility private
-	module TestUnitVersion_ # :nodoc:
+  # :stopdoc:
+  # @!visibility private
+  module Xqsr3
+  # @!visibility private
+  module Internal_ # :nodoc:
+  # @!visibility private
+  module TestUnitVersion_ # :nodoc:
 
-		# @!visibility private
-		TEST_UNIT_VERSION_	=	Test::Unit::VERSION # :nodoc:
-	end # module TestUnitVersion_
-	end # module Internal_
-	end # module Xqsr3
+    # @!visibility private
+    TEST_UNIT_VERSION_ = Test::Unit::VERSION # :nodoc:
+  end # module TestUnitVersion_
+  end # module Internal_
+  end # module Xqsr3
 
-	# :startdoc:
-rescue LoadError
+  # :startdoc:
+  rescue LoadError
 
-	# :stopdoc:
-	# @!visibility private
-	module Xqsr3
-	# @!visibility private
-	module Internal_ # :nodoc:
-	# @!visibility private
-	module TestUnitVersion_ # :nodoc:
+  # :stopdoc:
+  # @!visibility private
+  module Xqsr3
+  # @!visibility private
+  module Internal_ # :nodoc:
+  # @!visibility private
+  module TestUnitVersion_ # :nodoc:
 
-		# @!visibility private
-		TEST_UNIT_VERSION_	=	:not_found # :nodoc:
-	end # module TestUnitVersion_
-	end # module Internal_
-	end # module Xqsr3
+    # @!visibility private
+    TEST_UNIT_VERSION_ = :not_found # :nodoc:
+  end # module TestUnitVersion_
+  end # module Internal_
+  end # module Xqsr3
 
-	# :startdoc:
-end
+  # :startdoc:
+  end
 
-# :stopdoc:
+  # :stopdoc:
 
-module Xqsr3
-module Internal_ # :nodoc:
-module TestUnitVersion_ # :nodoc:
+  module Xqsr3
+  module Internal_ # :nodoc:
+  module TestUnitVersion_ # :nodoc:
 
-	if TEST_UNIT_VERSION_ == :not_found
+  if TEST_UNIT_VERSION_ == :not_found
 
-		TEST_UNIT_VERSION_PARTS_	=	[]
+    TEST_UNIT_VERSION_PARTS_ = []
 
-		TEST_UNIT_VERSION_MAJOR_	=	nil # :nodoc:
-		TEST_UNIT_VERSION_MINOR_	=	nil # :nodoc:
-		TEST_UNIT_VERSION_PATCH_	=	nil # :nodoc:
-	else
+    TEST_UNIT_VERSION_MAJOR_ = nil # :nodoc:
+    TEST_UNIT_VERSION_MINOR_ = nil # :nodoc:
+    TEST_UNIT_VERSION_PATCH_ = nil # :nodoc:
+  else
 
-		TEST_UNIT_VERSION_PARTS_	=	TEST_UNIT_VERSION_.split(/[.]/).collect { |n| n.to_i } # :nodoc:
+    TEST_UNIT_VERSION_PARTS_ = TEST_UNIT_VERSION_.split(/[.]/).collect { |n| n.to_i } # :nodoc:
 
-		TEST_UNIT_VERSION_MAJOR_	=	TEST_UNIT_VERSION_PARTS_[0] # :nodoc:
-		TEST_UNIT_VERSION_MINOR_	=	TEST_UNIT_VERSION_PARTS_[1] # :nodoc:
-		TEST_UNIT_VERSION_PATCH_	=	TEST_UNIT_VERSION_PARTS_[2] # :nodoc:
-	end
+    TEST_UNIT_VERSION_MAJOR_ = TEST_UNIT_VERSION_PARTS_[0] # :nodoc:
+    TEST_UNIT_VERSION_MINOR_ = TEST_UNIT_VERSION_PARTS_[1] # :nodoc:
+    TEST_UNIT_VERSION_PATCH_ = TEST_UNIT_VERSION_PARTS_[2] # :nodoc:
+  end
 
-	# @!visibility private
-	def self.less_ a1, a2 # :nodoc:
+  # @!visibility private
+  def self.less_ a1, a2 # :nodoc:
 
-		n_common	=	a1.size < a2.size ? a1.size : a2.size
+    n_common = a1.size < a2.size ? a1.size : a2.size
 
-		(0...n_common).each do |ix|
+    (0...n_common).each do |ix|
 
-			v1	=	a1[ix]
-			v2	=	a2[ix]
+      v1 = a1[ix]
+      v2 = a2[ix]
 
-			if v1 == v2
+      if v1 == v2
 
-				next
-			end
+        next
+      end
 
-			if v1 < v2
+      if v1 < v2
 
-				return true
-			else
+        return true
+      else
 
-				return false
-			end
-		end
+        return false
+      end
+    end
 
-		if n_common != a2.size
+    if n_common != a2.size
 
-			return true
-		else
+      return true
+    else
 
-			return false
-		end
-	end
+      return false
+    end
+  end
 
-	# @!visibility private
-	def self.is_major_at_least? j # :nodoc:
+  # @!visibility private
+  def self.is_major_at_least? j # :nodoc:
 
-		return unless TEST_UNIT_VERSION_MAJOR_
+    return unless TEST_UNIT_VERSION_MAJOR_
 
-		return j >= TEST_UNIT_VERSION_MAJOR_
-	end
+    return j >= TEST_UNIT_VERSION_MAJOR_
+  end
 
-	# @!visibility private
-	def self.is_minor_at_least? n # :nodoc:
+  # @!visibility private
+  def self.is_minor_at_least? n # :nodoc:
 
-		return unless TEST_UNIT_VERSION_MINOR_
+    return unless TEST_UNIT_VERSION_MINOR_
 
-		return n >= TEST_UNIT_VERSION_MINOR_
-	end
+    return n >= TEST_UNIT_VERSION_MINOR_
+  end
 
-	# @!visibility private
-	def self.is_at_least? v # :nodoc:
+  # @!visibility private
+  def self.is_at_least? v # :nodoc:
 
-		v	=	v.split(/\./).collect { |n| n.to_i } if String === v
+    v = v.split(/\./).collect { |n| n.to_i } if String === v
 
-		return !less_(TEST_UNIT_VERSION_PARTS_, v)
-	end
+    return !less_(TEST_UNIT_VERSION_PARTS_, v)
+  end
 
-	# @!visibility private
-	def self.is_less? v # :nodoc:
+  # @!visibility private
+  def self.is_less? v # :nodoc:
 
-		v	=	v.split(/\./).collect { |n| n.to_i } if String === v
+    v = v.split(/\./).collect { |n| n.to_i } if String === v
 
-		return less_(TEST_UNIT_VERSION_PARTS_, v)
-	end
+    return less_(TEST_UNIT_VERSION_PARTS_, v)
+  end
 
 end # module TestUnitVersion_
 end # module Internal_