xqsr3 0.27.2 → 0.29.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 786185c865b23fafc7fc1ebc7d81cf0bf5f39f36
-  data.tar.gz: a16dcecb9fed63c95545371cae951c4ced42f43f
+  metadata.gz: 67a291e75a1f5250c92410e09cb8ce4afc2e706b
+  data.tar.gz: 17b2fd750488be59288a0ac67df35253455eadcd
 SHA512:
-  metadata.gz: '098d22e4dbee898ba1ab8f44ffa48114890a5c289afcf079ec5da96809e5218d387ff614fb049601d4cfadf8a3976d2066d0fe86f8a772d0ed07d75186a93f03'
-  data.tar.gz: 565ce70a0c6ecbc82f87d9c57e534fddceaab7a8c33c71ee568385b4edda3406693f4c7a7e82265bef85d1016fd6adf9fc3a3c8af68a7eecea166abe3035a5ea
+  metadata.gz: e2210e3dfc465b1c899c5dff468349d5c1df6d24aeecf96fc2c9bcb7186d1dbb1923bee39ee1e940493bb4f16b9b70c4c74e21f23752cb7977267f8beb83c7ca
+  data.tar.gz: 83e3b052e816d7eaf90dc5e27c2c8565693fe84108456f8f0417fdc156ef7c2cd3b5953443b20ebd7c66c94cb59e65dc8416baf45e8aa312daa652e91a26e717

data/lib/xqsr3/containers/frequency_map.rb

@@ -5,13 +5,13 @@
 # Purpose:      FrequencyMap container
 #
 # Created:      28th January 2005
-# Updated:      30th July 2017
+# Updated:      13th October 2018
 #
 # Home:         http://github.com/synesissoftware/xqsr3
 #
 # Author:       Matthew Wilson
 #
-# Copyright (c) 2005-2017, Matthew Wilson and Synesis Software
+# Copyright (c) 2005-2018, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without
@@ -225,13 +225,9 @@ class FrequencyMap
 		tm = {}
 		@counts.each do |element, frequency|
 
-			if not tm.has_key? frequency
+			tm[frequency]	=	[]	unless tm.has_key?(frequency)
 
-				tm[frequency] = [element]
-			else
-
-				tm[frequency].push element
-			end
+			tm[frequency].push element
 		end
 
 		keys = tm.keys.sort.reverse

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

@@ -5,7 +5,7 @@
 # Purpose:      Definition of the WithCause inclusion module
 #
 # Created:      16th December 2017
-# Updated:      14th March 2018
+# Updated:      5th September 2018
 #
 # Home:         http://github.com/synesissoftware/xqsr3
 #
@@ -66,6 +66,8 @@ module Exceptions
 #
 module WithCause
 
+	INSPECT_HIDDEN_FIELDS = [ 'has_implicit_message', 'uses_cause_message' ]
+
 	# Defines an initializer for an exception class that allows a cause (aka
 	# an inner exception) to be specified, either as the first or last
 	# argument or as a +:cause+ option

data/lib/xqsr3/diagnostics/inspect_builder.rb

@@ -0,0 +1,176 @@
+
+# ######################################################################## #
+# File:         lib/xqsr3/diagnostics/inspect_builder.rb
+#
+# Purpose:      ::Xqsr3::Diagnostics::InspectBuilder module
+#
+# Created:      4th September 2018
+# Updated:      5th September 2018
+#
+# Home:         http://github.com/synesissoftware/xqsr3
+#
+# Author:       Matthew Wilson
+#
+# Copyright (c) 2018, Matthew Wilson and Synesis Software
+# 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 names 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.
+#
+# ######################################################################## #
+
+
+require 'xqsr3/string_utilities/truncate'
+
+=begin
+=end
+
+module Xqsr3
+module Diagnostics
+
+module InspectBuilder
+
+	module InspectBuilder_Utilities
+
+		NORMALISE_FUNCTION	=	lambda { |ar| ar.map { |v| v.to_s }.map { |v| '@' == v[0] ? v : "@#{v}" } }
+	end # module InspectBuilder_Utilities
+
+	#
+	# === Signature
+	#
+	# * *Parameters:*
+	#  @param +o+:: The target of the +inspect+ message for which a message
+	#   will be built
+	#
+	# * *Options:*
+	#  @option +:no_class+:: (boolean) Elides the class qualification
+	#  @option +:no_object_id+:: (boolean) Elides the object id
+	#  @option +:show_fields+:: (boolean) Shows (all) object fields
+	#  @option +:hidden_fields+:: ([ String ]) Names of fields to be omitted
+	#   (when +:show_fields+ is specified). Overridden by +:shown_fields+
+	#  @option +:shown_fields+:: ([ String ]) Names of fields to be shown
+	#   (when +:show_fields+ is specified). Overrides +:hidden_fields+
+	#  @option +:truncate_width+:: (Integer) Specifies a maximum width for
+	#   the values of fields
+	#  @option +:deep_inspect+:: (boolean) Causes fields' values to be
+	#   obtained via their own +inspect+ methods
+	def self.make_inspect o, **options
+
+		r	=	''
+
+		unless options[:no_class]
+
+			r	+=	o.class.to_s
+		end
+
+		unless options[:no_object_id]
+
+			r	+=	':' unless r.empty?
+			r	+=	"0x#{o.object_id.to_s.rjust(16, '0')}"
+		end
+
+		if options[:show_fields]
+
+			normalise	=	InspectBuilder_Utilities::NORMALISE_FUNCTION
+
+			hide_fields	=	normalise.call(options[:hidden_fields] || [])
+			show_fields	=	normalise.call(options[:shown_fields] || [])
+			trunc_w		=	options[:truncate_width]
+			ivars		=	normalise.call(o.instance_variables)
+
+			unless show_fields.empty?
+
+				ivars	=	ivars & show_fields
+			else
+
+				o.class.ancestors.each do |ancestor|
+
+					ihf_constant = :INSPECT_HIDDEN_FIELDS
+
+					if ancestor.const_defined? ihf_constant
+
+						ihfs	=	ancestor.const_get ihf_constant
+
+						if ::Array === ihfs && ihfs.all? { |c| ::String === c }
+
+							hide_fields += normalise.call(ihfs)
+						else
+
+							warn "class/module #{ancestor}'s #{ihf_constant} should be an array of strings"
+						end
+					end
+				end
+
+				ivars	=	ivars - hide_fields
+			end
+
+			els = ivars.sort.map do |iv_name|
+
+				iv_value	=	o.instance_variable_get(iv_name)
+				iv_class	=	iv_value.class
+				iv_value	=	::Xqsr3::StringUtilities::Truncate.string_truncate(iv_value.to_s, trunc_w) if trunc_w
+				if options[:deep_inspect]
+
+					iv_value	=	iv_value.inspect
+				else
+
+					case iv_value
+					when ::Array
+
+
+					when ::String
+
+						iv_value	=	"'#{iv_value}'"
+					end
+				end
+
+				"#{iv_name}(#{iv_class})=#{iv_value}"
+			end.join('; ')
+
+			r	+=	': ' unless r.empty?
+			r	+=	els
+		end
+
+		r	=	'#<' + r + '>'
+
+		r
+	end
+
+	# Creates an inspect string from self
+	def make_inspect **options
+
+		::Xqsr3::Diagnostics::InspectBuilder.make_inspect self, **options
+	end
+
+end # module InspectBuilder
+
+end # module Diagnostics
+end # module Xqsr3
+
+# ############################## end of file ############################# #
+
+

data/lib/xqsr3/quality/parameter_checking.rb

@@ -5,7 +5,7 @@
 # Purpose:      Definition of the ParameterChecking module
 #
 # Created:      12th February 2015
-# Updated:      29th July 2018
+# Updated:      20th September 2018
 #
 # Home:         http://github.com/synesissoftware/xqsr3
 #
@@ -81,17 +81,18 @@ module ParameterChecking
 			RECOGNISED_OPTION_NAMES = %w{
 
 				allow_nil
+				ignore_case
+				message
 				nil
-				types
-				type
-				values
-				responds_to
+				nothrow
 				reject_empty
 				require_empty
-				nothrow
-				message
+				responds_to
 				strip_str_whitespace
 				treat_as_option
+				type
+				types
+				values
 			}.map { |v| v.to_sym }
 
 		end # module Constants
@@ -114,6 +115,9 @@ module ParameterChecking
 	# @option +:allow_nil+:: (boolean) The +value+ must not be +nil+ unless
 	#          this option is true
 	# @option +:nil+:: an alias for +:allow_nil+
+	# @option +:ignore_case+:: (boolean) When +:values+ is specified,
+	#  comparisons of strings, or arrays of strings, will be carried out in
+	#  a case-insensitive manner
 	# @option +: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
@@ -182,6 +186,9 @@ module ParameterChecking
 	# @option +:allow_nil+:: (boolean) The +value+ must not be +nil+ unless
 	#          this option is true
 	# @option +:nil+:: an alias for +:allow_nil+
+	# @option +:ignore_case+:: (boolean) When +:values+ is specified,
+	#  comparisons of strings, or arrays of strings, will be carried out in
+	#  a case-insensitive manner
 	# @option +: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
@@ -339,6 +346,7 @@ module ParameterChecking
 				types	<<	options[:type] if types.empty?
 			end
 			types		=	[value.class] if types.empty?
+			types		=	types.map { |type| :boolean == type ? [ ::TrueClass, ::FalseClass ] : type }.flatten if types.include?(:boolean)
 
 			warn "#{self}::check_parameter: options[:types] of type #{types.class} - should be #{::Array}" unless types.is_a?(Array)
 			warn "#{self}::check_parameter: options[:types] - '#{types}' - should contain only classes or arrays of classes" if types.is_a?(::Array) && !types.all? { |c| ::Class === c || (::Array === c && c.all? { |c2| ::Class === c2 }) }
@@ -449,6 +457,7 @@ module ParameterChecking
 					unless options[:nothrow]
 
 						unless message
+
 							s_name		=	name.is_a?(String) ? "'#{name}' " : ''
 
 							message		=	"#{param_s} #{s_name}must be empty"
@@ -462,14 +471,32 @@ module ParameterChecking
 
 		# check value(s)
 
-		unless value.nil?
-
-			values	=	options[:values] || [ value ]
+		unless value.nil? || !(values = options[:values])
 
 			warn "#{self}::check_parameter: options[:values] of type #{values.class} - should be #{::Array}" unless values.is_a?(Array)
 
 			found	=	false
 
+			io		=	options[:ignore_order] && ::Array === value
+
+			do_case	=	options[:ignore_case] ? lambda do |v|
+
+				case v
+				when ::String
+
+					return :string
+				when ::Array
+
+					return :array_of_strings if v.all? { |s| ::String === s }
+				end
+
+				nil
+			end : lambda { |v| nil }
+
+			value_ic	=	do_case.call(value)
+			value_io	=	nil
+			value_uc	=	nil
+
 			values.each do |v|
 
 				if ::Range === v && !(::Range === value) && v.cover?(value)
@@ -483,6 +510,66 @@ module ParameterChecking
 					found = true
 					break
 				end
+
+				# ignore-case comparing
+
+				if value_ic
+
+					unless value_uc
+
+						case value_ic
+						when :string
+
+							value_uc	=	value.upcase
+						when :array_of_strings
+
+							value_uc	=	value.map { |s| s.upcase }
+							value_uc	=	value_uc.sort if io
+						end
+					end
+
+					v_ic	=	do_case.call(v)
+
+					if v_ic == value_ic
+
+						case v_ic
+						when :string
+
+							if value_uc == v.upcase
+
+								found = true
+								break
+							end
+						when :array_of_strings
+
+							v_uc	=	v.map { |s| s.upcase }
+							v_uc	=	v_uc.sort if io
+
+							if value_uc == v_uc
+
+								found = true
+								break
+							end
+						end
+					end
+				elsif io
+
+					unless value_io
+
+						value_io	=	value.sort
+					end
+
+					if ::Array === v
+
+						v_io		=	v.sort
+
+						if value_io == v_io
+
+							found = true
+							break
+						end
+					end
+				end
 			end
 
 			unless found
@@ -492,6 +579,7 @@ module ParameterChecking
 				unless options[:nothrow]
 
 					unless message
+
 						s_name		=	name.is_a?(String) ? "'#{name}' " : ''
 
 						message		=	"#{param_s} #{s_name}value '#{value}' not found equal/within any of required values or ranges"

data/lib/xqsr3/version.rb

@@ -5,7 +5,7 @@
 # Purpose:      Version for Xqsr3 library
 #
 # Created:      3rd April 2016
-# Updated:      24th August 2018
+# Updated:      13th October 2018
 #
 # Home:         http://github.com/synesissoftware/xqsr3
 #
@@ -50,7 +50,7 @@
 module Xqsr3
 
 	# Current version of the Xqsr3 library
-	VERSION				=	'0.27.2'
+	VERSION				=	'0.29.2'
 
 	private
 	VERSION_PARTS_		=	VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:

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

@@ -0,0 +1,100 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), '../../../../lib')
+
+require 'xqsr3/diagnostics/inspect_builder'
+
+require 'xqsr3/extensions/test/unit'
+require 'test/unit'
+
+class Test_X_Object_inspect < Test::Unit::TestCase
+
+	class Example1
+
+		include ::Xqsr3::Diagnostics::InspectBuilder
+
+		def initialize **inspect_options
+
+			@alphabet			=	'abcdefghijklmnopqrstuvwxyz'
+			@letters			=	@alphabet.chars.map { |c| c.upcase }
+			@inspect_options	=	inspect_options
+		end
+
+		def inspect
+
+			make_inspect **@inspect_options
+		end
+	end
+
+	class ExampleWithHiddenFields < Example1
+
+		INSPECT_HIDDEN_FIELDS = [ 'letters' ]
+	end
+
+	def test_default_use
+
+		ex	=	Example1.new
+
+		assert_match /\A#<Test_X_Object_inspect::Example1:0x\d+>\z/, ex.inspect
+
+		ex2	=	ExampleWithHiddenFields.new
+
+		assert_match /\A#<Test_X_Object_inspect::ExampleWithHiddenFields:0x\d+>\z/, ex2.inspect
+	end
+
+	def test_no_class
+
+		ex	=	Example1.new(no_class: true)
+
+		assert_match /\A#<0x\d+>\z/, ex.inspect
+
+		ex2	=	ExampleWithHiddenFields.new(no_class: true)
+
+		assert_match /\A#<0x\d+>\z/, ex2.inspect
+	end
+
+	def test_no_object_id
+
+		ex	=	Example1.new(no_object_id: true)
+
+		assert_match /\A#<Test_X_Object_inspect::Example1>\z/, ex.inspect
+
+		ex2	=	ExampleWithHiddenFields.new(no_object_id: true)
+
+		assert_match /\A#<Test_X_Object_inspect::ExampleWithHiddenFields>\z/, ex2.inspect
+	end
+
+	def test_show_fields
+
+		ex	=	Example1.new(show_fields: true)
+
+		assert_match /\A#<Test_X_Object_inspect::Example1:0x\d+:\s*@alphabet\(String\)='abcdefghijklmnopqrstuvwxyz';\s*@inspect_options.*;\s*@letters.*>\z/, ex.inspect
+
+		ex2	=	ExampleWithHiddenFields.new(show_fields: true)
+
+		assert_match /\A#<Test_X_Object_inspect::ExampleWithHiddenFields:0x\d+:\s*@alphabet\(String\)='abcdefghijklmnopqrstuvwxyz';\s*@inspect_options\(.+\)=[^;]+>\z/, ex2.inspect
+	end
+
+	def test_show_fields_hidden
+
+		ex	=	Example1.new(show_fields: true, hidden_fields: [ 'inspect_options' ])
+
+		assert_match /\A#<Test_X_Object_inspect::Example1:0x\d+:\s*@alphabet\(String\)='abcdefghijklmnopqrstuvwxyz';\s*@letters.*>\z/, ex.inspect
+
+		ex2	=	ExampleWithHiddenFields.new(show_fields: true, hidden_fields: [ 'inspect_options' ])
+
+		assert_match /\A#<Test_X_Object_inspect::ExampleWithHiddenFields:0x\d+:\s*@alphabet\(String\)='abcdefghijklmnopqrstuvwxyz'>\z/, ex2.inspect
+	end
+
+	def test_show_fields_truncated
+
+		ex	=	Example1.new(show_fields: true, truncate_width: 10)
+
+		assert_match /\A#<Test_X_Object_inspect::Example1:0x\d+:\s*@alphabet\(String\)='abcdefg...';\s*@inspect_options.*;\s*@letters.*>\z/, ex.inspect
+
+		ex2	=	ExampleWithHiddenFields.new(show_fields: true, truncate_width: 10)
+
+		assert_match /\A#<Test_X_Object_inspect::ExampleWithHiddenFields:0x\d+:\s*@alphabet\(String\)='abcdefg...';\s*@inspect_options.*>\z/, ex2.inspect
+	end
+end
+

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

@@ -0,0 +1,12 @@
+#! /usr/bin/env ruby
+#
+# executes all other tests
+
+this_dir    =   File.expand_path(File.dirname(__FILE__))
+
+# all tc_*rb in current directory
+Dir[File.join(this_dir, 'tc_*rb')].each { |file| require file }
+
+# all ts_*rb in immediate sub-directories
+Dir[File.join(this_dir, '*', 'ts_*rb')].each { |file| require file }
+

data/test/unit/quality/tc_parameter_checking.rb

@@ -103,6 +103,7 @@ class Test_parameter_checks_as_included_module < Test::Unit::TestCase
 	def test_2
 
 		assert_equal true, check_method_2(true, [ ::TrueClass ])
+		assert_equal true, check_method_2(true, [ :boolean ])
 		assert_equal true, check_method_2(true, [ ::TrueClass, ::String, ::Symbol ])
 		assert_raise TypeError do
 			check_method_2(true, [ ::String, ::Symbol, ::FalseClass ])
@@ -568,5 +569,41 @@ end
 
 		assert_nil(check_parameter(nil, 'the_param', nil: true))
 	end
+
+
+	# test_ignore_case
+
+	def test_ignore_case
+
+		assert_not_nil check_parameter('TheString', 'the_param', values: [ 'TheString', 'the-string' ])
+
+		assert_raise_with_message(::ArgumentError, /parameter.*the_param.*not found.*values/) { check_parameter('THESTRING', 'the_param', values: [ 'TheString', 'the-string' ]) }
+
+		assert_not_nil check_parameter('TheString', 'the_param', values: [ 'THESTRING', 'the-string' ], ignore_case: true)
+	end
+
+	def test_ignore_case_in_array
+
+		assert_not_nil check_parameter([ 'abc', 'def' ], 'the_param', values: [ [ 'ABC', 'DEF' ], [ 'abc', 'def' ] ])
+
+		assert_raise_with_message(::ArgumentError, /parameter.*the_param.*not found.*values/) { check_parameter([ 'Abc', 'Def' ], 'the_param', values: [ [ 'ABC', 'DEF' ], [ 'abc', 'def' ] ]) }
+
+		assert_not_nil check_parameter([ 'Abc', 'Def' ], 'the_param', values: [ [ 'ABC', 'DEF' ], [ 'abc', 'def' ] ], ignore_case: true)
+
+		assert_raise_with_message(::ArgumentError, /parameter.*the_param.*not found.*values/) { check_parameter([ 'Def', 'Abc' ], 'the_param', values: [ [ 'ABC', 'DEF' ], [ 'abc', 'def' ] ], ignore_case: true) }
+
+	end
+
+	def test_ignore_case_and_order_in_array
+
+		assert_not_nil check_parameter([ 'Def', 'Abc', 'Ghi' ], 'the_param', values: [ [ 'GHI', 'ABC', 'DEF' ], [ 'ghi', 'abc', 'def' ] ], ignore_case: true, ignore_order: true)
+	end
+
+	def test_ignore_order_in_array
+
+		assert_raise(::ArgumentError) { check_parameter([ 'abc', 'def', 'ghi' ], 'the_param', values: [ [ 'ghi', 'def', 'abc' ], [ 'ghi', 'abc', 'def' ] ]) }
+
+		assert_not_nil check_parameter([ 'abc', 'def', 'ghi' ], 'the_param', values: [ [ 'ghi', 'def', 'abc' ], [ 'ghi', 'abc', 'def' ] ], ignore_order: true)
+	end
 end
 

data/test/unit/string_utilities/tc_truncate.rb

@@ -0,0 +1,50 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__), *(['..'] * 3), 'lib')
+
+require 'xqsr3/string_utilities/truncate'
+
+require 'xqsr3/extensions/test/unit'
+require 'test/unit'
+
+class Test_StringUtilities_Truncate < ::Test::Unit::TestCase
+
+	Truncator = ::Xqsr3::StringUtilities::Truncate
+
+	def test_truncate_of_empty_string
+
+		assert_equal '', Truncator.string_truncate('', 0)
+		assert_equal '', Truncator.string_truncate('', 1)
+		assert_equal '', Truncator.string_truncate('', 10)
+	end
+
+	def test_truncate_of_smallest_string
+
+		assert_equal '', Truncator.string_truncate('a', 0)
+		assert_equal 'a', Truncator.string_truncate('a', 1)
+		assert_equal 'a', Truncator.string_truncate('a', 10)
+	end
+
+	def test_truncate_of_smaller_string
+
+		assert_equal '', Truncator.string_truncate('abc', 0)
+		assert_equal '.', Truncator.string_truncate('abc', 1)
+		assert_equal '..', Truncator.string_truncate('abc', 2)
+		assert_equal 'abc', Truncator.string_truncate('abc', 3)
+		assert_equal 'abc', Truncator.string_truncate('abc', 4)
+		assert_equal 'abc', Truncator.string_truncate('abc', 10)
+	end
+
+	def test_truncate_of_small_string
+
+		assert_equal '', Truncator.string_truncate('abcdefghijklmnopqrstuvwxyz', 0)
+		assert_equal '.', Truncator.string_truncate('abcdefghijklmnopqrstuvwxyz', 1)
+		assert_equal '..', Truncator.string_truncate('abcdefghijklmnopqrstuvwxyz', 2)
+		assert_equal '...', Truncator.string_truncate('abcdefghijklmnopqrstuvwxyz', 3)
+		assert_equal 'a...', Truncator.string_truncate('abcdefghijklmnopqrstuvwxyz', 4)
+		assert_equal 'abcdefg...', Truncator.string_truncate('abcdefghijklmnopqrstuvwxyz', 10)
+	end
+
+
+end
+

data/test/unit/string_utilities/ts_all.rb

@@ -0,0 +1,12 @@
+#! /usr/bin/env ruby
+#
+# executes all other tests
+
+this_dir    =   File.expand_path(File.dirname(__FILE__))
+
+# all tc_*rb in current directory
+Dir[File.join(this_dir, 'tc_*rb')].each { |file| require file }
+
+# all ts_*rb in immediate sub-directories
+Dir[File.join(this_dir, '*', 'ts_*rb')].each { |file| require file }
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: xqsr3
 version: !ruby/object:Gem::Version
-  version: 0.27.2
+  version: 0.29.2
 platform: ruby
 authors:
 - Matt Wilson
@@ -29,6 +29,7 @@ files:
 - lib/xqsr3/conversion/integer_parser.rb
 - lib/xqsr3/diagnostics/exception_utilities.rb
 - lib/xqsr3/diagnostics/exceptions/with_cause.rb
+- lib/xqsr3/diagnostics/inspect_builder.rb
 - lib/xqsr3/doc_.rb
 - lib/xqsr3/extensions/array/join_with_or.rb
 - lib/xqsr3/extensions/enumerable.rb
@@ -104,6 +105,8 @@ files:
 - test/unit/extensions/kernel/tc_integer.rb
 - test/unit/extensions/kernel/tc_raise_with_options.rb
 - 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_ends_with.rb
 - test/unit/extensions/string/tc_map_option_string.rb
@@ -127,6 +130,8 @@ files:
 - test/unit/io/ts_all.rb
 - test/unit/quality/tc_parameter_checking.rb
 - test/unit/quality/ts_all.rb
+- test/unit/string_utilities/tc_truncate.rb
+- test/unit/string_utilities/ts_all.rb
 - test/unit/tc_version.rb
 - test/unit/ts_all.rb
 - test/unit/xml/ts_all.rb