xqsr3 0.38.1.1 → 0.38.2

data/lib/xqsr3/string_utilities/starts_with.rb

@@ -1,17 +1,17 @@
 
 # ######################################################################## #
-# File:         lib/xqsr3/string_utilities/starts_with.rb
+# File:     lib/xqsr3/string_utilities/starts_with.rb
 #
-# Purpose:      Definition of the ::Xqsr3::StringUtilities::StartsWith
-#               module
+# Purpose:  Definition of the Xqsr3::StringUtilities::StartsWith module
 #
-# Created:      13th April 2016
-# Updated:      15th April 2019
+# Created:  13th April 2016
+# Updated:  11th December 2023
 #
-# Home:         http://github.com/synesissoftware/xqsr3
+# Home:     http://github.com/synesissoftware/xqsr3
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
+# Copyright (c) 2019-2023, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2016-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -26,7 +26,7 @@
 #   notice, this list of conditions and the following disclaimer in the
 #   documentation and/or other materials provided with the distribution.
 #
-# * Neither the names of the copyright holder nor the names of its
+# * Neither the names of the copyright holders nor the names of its
 #   contributors may be used to endorse or promote products derived from
 #   this software without specific prior written permission.
 #

data/lib/xqsr3/string_utilities/to_symbol.rb

@@ -1,17 +1,17 @@
 
 # ######################################################################## #
-# File:         lib/xqsr3/string_utilities/to_symbol.rb
+# File:     lib/xqsr3/string_utilities/to_symbol.rb
 #
-# Purpose:      Definition of the ::Xqsr3::StringUtilities::ToSymbol
-#               module
+# Purpose:  Definition of the Xqsr3::StringUtilities::ToSymbol module
 #
-# Created:      14th April 2016
-# Updated:      15th April 2019
+# Created:  14th April 2016
+# Updated:  11th December 2023
 #
-# Home:         http://github.com/synesissoftware/xqsr3
+# Home:     http://github.com/synesissoftware/xqsr3
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
+# Copyright (c) 2019-2023, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2016-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -26,7 +26,7 @@
 #   notice, this list of conditions and the following disclaimer in the
 #   documentation and/or other materials provided with the distribution.
 #
-# * Neither the names of the copyright holder nor the names of its
+# * Neither the names of the copyright holders nor the names of its
 #   contributors may be used to endorse or promote products derived from
 #   this software without specific prior written permission.
 #

data/lib/xqsr3/string_utilities/truncate.rb

@@ -1,17 +1,17 @@
 
 # ######################################################################## #
-# File:         lib/xqsr3/string_utilities/truncate.rb
+# File:     lib/xqsr3/string_utilities/truncate.rb
 #
-# Purpose:      Definition of the ::Xqsr3::StringUtilities::Truncate
-#               module
+# Purpose:  Definition of the Xqsr3::StringUtilities::Truncate module
 #
-# Created:      12th April 2018
-# Updated:      15th April 2019
+# Created:  12th April 2018
+# Updated:  11th December 2023
 #
-# Home:         http://github.com/synesissoftware/xqsr3
+# Home:     http://github.com/synesissoftware/xqsr3
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
+# Copyright (c) 2019-2023, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2018-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -26,7 +26,7 @@
 #   notice, this list of conditions and the following disclaimer in the
 #   documentation and/or other materials provided with the distribution.
 #
-# * Neither the names of the copyright holder nor the names of its
+# * Neither the names of the copyright holders nor the names of its
 #   contributors may be used to endorse or promote products derived from
 #   this software without specific prior written permission.
 #
@@ -134,4 +134,3 @@ end # module Xqsr3
 
 # ############################## end of file ############################# #
 
-

data/lib/xqsr3/version.rb

@@ -1,17 +1,17 @@
 
 # ######################################################################## #
-# File:         lib/xqsr3/version.rb
+# File:     lib/xqsr3/version.rb
 #
-# Purpose:      Version for Xqsr3 library
+# Purpose:  Version for Xqsr3 library
 #
-# Created:      3rd April 2016
-# Updated:      4th November 2023
+# Created:  3rd April 2016
+# Updated:  1st January 2024
 #
-# Home:         http://github.com/synesissoftware/xqsr3
+# Home:     http://github.com/synesissoftware/xqsr3
 #
-# Author:       Matthew Wilson
+# 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) 2016-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -26,7 +26,7 @@
 #   notice, this list of conditions and the following disclaimer in the
 #   documentation and/or other materials provided with the distribution.
 #
-# * Neither the names of the copyright holder nor the names of its
+# * Neither the names of the copyright holders nor the names of its
 #   contributors may be used to endorse or promote products derived from
 #   this software without specific prior written permission.
 #
@@ -51,7 +51,7 @@
 module Xqsr3
 
 	# Current version of the Xqsr3 library
-	VERSION				=	'0.38.1.1'
+	VERSION				=	'0.38.2'
 
 	private
 	VERSION_PARTS_		=	VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:
@@ -67,4 +67,3 @@ end # module Xqsr3
 
 # ############################## end of file ############################# #
 
-

data/test/performance/frequency_map.rb

@@ -1,18 +1,4 @@
-#!/usr/bin/env ruby
-
-#############################################################################
-# File:         test/performance/frequency_map.rb
-#
-# Purpose:      COMPLETE_ME
-#
-# Created:      13th October 2018
-# Updated:      13th October 2018
-#
-# Author:       Matthew Wilson
-#
-# Copyright:    <<TBD>>
-#
-#############################################################################
+#! /usr/bin/env ruby
 
 $:.unshift File.join(File.dirname($0), *(['..'] * 2), 'lib')
 

data/test/scratch/test_assert_raise_with_message.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#! /usr/bin/env ruby
 
 $:.unshift File.join(File.dirname(__FILE__), '../../lib')
 
@@ -28,4 +28,3 @@ class Test_assert_raise_with_message < Test::Unit::TestCase
 	end
 end
 
-

data/test/unit/array_utilities/tc_join_with_or.rb

@@ -211,5 +211,3 @@ class Test_Xqsr3_ArrayUtilities_join_with_or_by_include < Test::Unit::TestCase
 	end
 end
 
-
-

data/test/unit/containers/tc_frequency_map.rb

@@ -532,7 +532,34 @@ class Test_Xqsr3_Containers_FrequencyMap < Test::Unit::TestCase
 		assert_equal 0, fm.count
 	end
 
-	def test_eql?
+	def test_op_equal
+		# `==` evaluates logical equality (except for `Object`)
+
+		fm1 = FrequencyMap.new
+		fm2 = FrequencyMap.new
+
+		assert fm1 == fm1
+		assert fm2 == fm2
+		assert fm1 == fm2
+
+		fm1 << :abc << :def
+
+		assert fm1 == fm1
+		assert fm2 == fm2
+		assert_not fm1 == fm2
+
+		fm2 << :def << :abc
+
+		assert fm1 == fm1
+		assert fm2 == fm2
+		assert fm1 == fm2
+
+		assert_equal 2, fm1.size
+		assert_equal 2, fm1.count
+	end
+
+	def test_eql
+		# `eql?` evaluates equality based on #hash
 
 		fm1 = FrequencyMap.new
 		fm2 = FrequencyMap.new
@@ -557,6 +584,32 @@ class Test_Xqsr3_Containers_FrequencyMap < Test::Unit::TestCase
 		assert_equal 2, fm1.count
 	end
 
+	def test_equal
+		# `eql?` evaluates identity
+
+		fm1 = FrequencyMap.new
+		fm2 = FrequencyMap.new
+
+		assert fm1.equal? fm1
+		assert fm2.equal? fm2
+		assert_not fm1.equal? fm2
+
+		fm1 << :abc << :def
+
+		assert fm1.equal? fm1
+		assert fm2.equal? fm2
+		assert_not fm1.equal? fm2
+
+		fm2 << :def << :abc
+
+		assert fm1.equal? fm1
+		assert fm2.equal? fm2
+		assert_not fm1.equal? fm2
+
+		assert_equal 2, fm1.size
+		assert_equal 2, fm1.count
+	end
+
 	def test_fetch
 
 		fm = FrequencyMap.new
@@ -596,7 +649,7 @@ class Test_Xqsr3_Containers_FrequencyMap < Test::Unit::TestCase
 		assert_equal [:def, 2, :abc, 1], fm.flatten
 	end
 
-	def test_has_key?
+	def test_has_key
 
 		fm = FrequencyMap.new
 
@@ -617,7 +670,7 @@ class Test_Xqsr3_Containers_FrequencyMap < Test::Unit::TestCase
 		assert fm.has_key? 'abc'
 	end
 
-	def test_has_value?
+	def test_has_value
 
 		fm = FrequencyMap.new
 

data/test/unit/containers/tc_multi_map.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#! /usr/bin/env ruby
 
 $:.unshift File.join(File.dirname(__FILE__), '../../../lib')
 
@@ -410,7 +410,33 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
 		assert_not mm.empty?
 	end
 
-	def test_eql?
+	def test_op_equal
+		# `==` evaluates logical equality (except for `Object`)
+
+		mm1 = MultiMap.new
+		mm2 = MultiMap.new
+
+		assert mm1 == mm1
+		assert mm2 == mm2
+		assert mm1 == mm2
+
+		mm1.push :abc
+		mm1.push :def
+
+		assert mm1 == mm1
+		assert mm2 == mm2
+		assert_not mm1 == mm2
+
+		mm2.push :def
+		mm2.push :abc
+
+		assert mm1 == mm1
+		assert mm2 == mm2
+		assert mm1 == mm2
+	end
+
+	def test_eql
+		# `eql?` evaluates equality based on #hash
 
 		mm1 = MultiMap.new
 		mm2 = MultiMap.new
@@ -434,6 +460,31 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
 		assert mm1.eql? mm2
 	end
 
+	def test_equal
+		# `eql?` evaluates identity
+
+		mm1 = MultiMap.new
+		mm2 = MultiMap.new
+
+		assert mm1.equal? mm1
+		assert mm2.equal? mm2
+		assert_not mm1.equal? mm2
+
+		mm1.push :abc
+		mm1.push :def
+
+		assert mm1.equal? mm1
+		assert mm2.equal? mm2
+		assert_not mm1.equal? mm2
+
+		mm2.push :def
+		mm2.push :abc
+
+		assert mm1.equal? mm1
+		assert mm2.equal? mm2
+		assert_not mm1.equal? mm2
+	end
+
 	def test_fetch
 
 		mm = MultiMap.new
@@ -475,7 +526,7 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
 		assert_equal [ :abc, 1, :abc, 2, :abc, 3, :abc, 4, :abc, 5, :def, [] ], mm.flatten
 	end
 
-	def test_has_key?
+	def test_has_key
 
 		mm = MultiMap.new
 
@@ -490,7 +541,7 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
 		assert_not mm.has_key? :abc
 	end
 
-	def test_has_value?
+	def test_has_value
 
 		mm = MultiMap.new
 
@@ -507,7 +558,7 @@ class Test_Xqsr3_Containers_MultiMap < Test::Unit::TestCase
 		assert_not mm.has_value? :abc
 	end
 
-	def test_has_values?
+	def test_has_values
 
 		mm = MultiMap.new
 

data/test/unit/conversion/tc_integer_parser.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#! /usr/bin/env ruby
 
 $:.unshift File.join(File.dirname(__FILE__), '../../../lib')
 

data/test/unit/conversion/tc_to_bool.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#! /usr/bin/env ruby
 
 $:.unshift File.join(File.dirname(__FILE__), '../../../lib')
 

data/test/unit/extensions/hash/tc_hash.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#! /usr/bin/env ruby
 
 $:.unshift File.join(File.dirname(__FILE__), '../../../../lib')
 

data/test/unit/extensions/hash/tc_slice.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#! /usr/bin/env ruby
 
 $:.unshift File.join(File.dirname(__FILE__), '../../../../lib')
 

data/test/unit/extensions/object/tc_inspect.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#! /usr/bin/env ruby
 
 $:.unshift File.join(File.dirname(__FILE__), '../../../../lib')
 

data/test/unit/io/tc_writelines.rb

@@ -196,5 +196,3 @@ class Test_Xqsr3_IO_writelines < Test::Unit::TestCase
 	end
 end
 
-# ############################## end of file ############################# #
-

data/test/unit/quality/tc_parameter_checking.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#! /usr/bin/env ruby
 
 $:.unshift File.join(File.dirname(__FILE__), '../../../..', 'lib')
 

data/test/unit/string_utilities/tc_truncate.rb

@@ -1,4 +1,4 @@
-#!/usr/bin/env ruby
+#! /usr/bin/env ruby
 
 $:.unshift File.join(File.dirname(__FILE__), *(['..'] * 3), 'lib')
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: xqsr3
 version: !ruby/object:Gem::Version
-  version: 0.38.1.1
+  version: 0.38.2
 platform: ruby
 authors:
 - Matt Wilson
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-12-01 00:00:00.000000000 Z
+date: 2024-01-01 00:00:00.000000000 Z
 dependencies: []
 description: |
   eXtensions by fine Quantum for Standard Ruby and 3rd-party libraries is a