libpath-ruby 0.2.2 → 0.2.2.2

data/lib/libpath/util.rb

@@ -3,40 +3,40 @@ require 'libpath/internal_/platform'
 
 if ::LibPath::Internal_::Platform::Constants::PLATFORM_IS_WINDOWS then
 
-	require 'libpath/util/windows'
+  require 'libpath/util/windows'
 else
 
-	require 'libpath/util/unix'
+  require 'libpath/util/unix'
 end
 
-module LibPath # :nodoc:
-module Util # :nodoc:
 
-	if ::LibPath::Internal_::Platform::Constants::PLATFORM_IS_WINDOWS then
+module LibPath
+module Util
 
-		extend ::LibPath::Util::Windows
-		include ::LibPath::Util::Windows
-	else
+  if ::LibPath::Internal_::Platform::Constants::PLATFORM_IS_WINDOWS then
 
-		extend ::LibPath::Util::Unix
-		include ::LibPath::Util::Unix
-	end
+    extend ::LibPath::Util::Windows
+    include ::LibPath::Util::Windows
+  else
 
-	# @!visibility private
-	def self.extended receiver # :nodoc:
+    extend ::LibPath::Util::Unix
+    include ::LibPath::Util::Unix
+  end
 
-		$stderr.puts "#{receiver} extended by #{self}" if $DEBUG
-	end
+  # @!visibility private
+  def self.extended receiver # :nodoc:
 
-	# @!visibility private
-	def self.included receiver # :nodoc:
+    $stderr.puts "#{receiver} extended by #{self}" if $DEBUG
+  end
 
-		$stderr.puts "#{receiver} included #{self}" if $DEBUG
-	end
+  # @!visibility private
+  def self.included receiver # :nodoc:
 
+    $stderr.puts "#{receiver} included #{self}" if $DEBUG
+  end
 end # module Util
 end # module LibPath
 
-# ############################## end of file ############################# #
 
+# ############################## end of file ############################# #
 

data/lib/libpath/version.rb

@@ -1,16 +1,16 @@
-
 # ######################################################################## #
-# File:         libpath/version.rb
+# File:     libpath/version.rb
 #
-# Purpose:      Version for libpath.Ruby library
+# Purpose:  Version for libpath.Ruby library
 #
-# Created:      8th January 2019
-# Updated:      18th May 2019
+# Created:  8th January 2019
+# Updated:  7th April 2024
 #
-# Home:         http://github.com/synesissoftware/libpath.Ruby
+# Home:     http://github.com/synesissoftware/libpath.Ruby
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
+# Copyright (c) 2019-2024, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -44,31 +44,30 @@
 # ######################################################################## #
 
 
-
 =begin
 =end
 
-module LibPath # :nodoc:
-
-	# Current version of the libpath.Ruby library
-	VERSION				=	'0.2.2'
+module LibPath
 
-	private
-	VERSION_PARTS_		=	VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:
-	public
-	# Major version of the libpath.Ruby library
-	VERSION_MAJOR		=	VERSION_PARTS_[0] # :nodoc:
-	# Minor version of the libpath.Ruby library
-	VERSION_MINOR		=	VERSION_PARTS_[1] # :nodoc:
-	# Patch version of the libpath.Ruby library
-	VERSION_PATCH		=	VERSION_PARTS_[2] # :nodoc:
-	# Revision version of the libpath.Ruby library
-	VERSION_REVISION	=	VERSION_PATCH # :nodoc:
-	# Sub-patch version of the libpath.Ruby library
-	VERSION_SUBPATCH	=	VERSION_PARTS_[3] # :nodoc:
+  # Current version of the libpath.Ruby library
+  VERSION           = '0.2.2.2'
 
+  private
+  # @!visibility private
+  VERSION_PARTS_    = VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:
+  public
+  # Major version of the libpath.Ruby library
+  VERSION_MAJOR     = VERSION_PARTS_[0]
+  # Minor version of the libpath.Ruby library
+  VERSION_MINOR     = VERSION_PARTS_[1]
+  # Patch version of the libpath.Ruby library
+  VERSION_PATCH     = VERSION_PARTS_[2]
+  # Revision version of the libpath.Ruby library
+  VERSION_REVISION  = VERSION_PATCH
+  # Sub-patch version of the libpath.Ruby library
+  VERSION_SUBPATCH  = VERSION_PARTS_[3]
 end # module LibPath
 
-# ############################## end of file ############################# #
 
+# ############################## end of file ############################# #
 

data/lib/libpath.rb

@@ -7,6 +7,6 @@ require 'libpath/util'
 
 require 'libpath/version'
 
-# ############################## end of file ############################# #
 
+# ############################## end of file ############################# #
 

data/test/performance/benchmark_drive_letter.rb

@@ -1,31 +1,71 @@
 #! /usr/bin/env ruby
 
 #############################################################################
-# File:         test/performance/benchmark_drive_letter.rb
+# File:     test/performance/benchmark_drive_letter.rb
 #
-# Purpose:      Determines whether it's better to use String-case of regex
-#               to match Windows-drive letters
+# Purpose:  Determines whether it's better to use String-case of regex to
+#           match Windows-drive letters
 #
-# Created:      8th January 2019
-# Updated:      9th January 2019
+# Created:  8th January 2019
+# Updated:  6th April 2024
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
 #############################################################################
 
+
 $:.unshift File.join(File.dirname(__FILE__), *(['..'] * 2), 'lib')
 
+
 require 'libpath/internal_/windows/drive'
 
 require 'benchmark'
 
-ITERATIONS	=	100000
 
-ITEMS		=	(0...ITERATIONS).map { rand(0...100) }.map { |n| n > 51 ? ' ' : (n % 26 + (n < 26 ? 'A' : 'a').ord).chr }
+include ::LibPath::Internal_::Windows
+
+
+ITERATIONS  = 100000
+
+ITEMS       = (0...ITERATIONS).map { rand(0...100) }.map { |n| n > 51 ? ' ' : (n % 26 + (n < 26 ? 'A' : 'a').ord).chr }
+
+def is_drive_letter_1? c
+
+  if c.valid_encoding?
+
+    co = c.ord
+
+    return true if co >= 65 && co <= 90
+
+    return true if co >= 97 && co <= 122
+
+    return false
+  end
+end
+
+def is_drive_letter_2? c
+
+  co = c.ord
+
+  return true if (64..90).include? co
+
+  return true if (97..122).include? co
+
+  return false
+end
+
+
+# benchmark
 
 Benchmark.bm(10) do |x|
 
-	x.report('Regex:') { ITEMS.each { |ch| /^[a-z]/i =~ ch } }
-	x.report('cidl?:') { ITEMS.each { |ch| ::LibPath::Internal_::Windows::Drive.character_is_drive_letter?(ch) } }
+  x.report('Regex:') { ITEMS.each { |ch| /^[a-zA-Z]/ =~ ch } }
+  x.report('Regex/i:') { ITEMS.each { |ch| /^[a-z]/i =~ ch } }
+  x.report('cidl?:') { ITEMS.each { |ch| Drive.character_is_drive_letter?(ch) } }
+  x.report('idl-1?:') { ITEMS.each { |ch| is_drive_letter_1?(ch) } }
+  x.report('idl-2?:') { ITEMS.each { |ch| is_drive_letter_2?(ch) } }
 end
 
+
+# ############################## end of file ############################# #
+

data/test/performance/benchmark_gsub_string_or_regex.rb

@@ -1,45 +1,49 @@
 #! /usr/bin/env ruby
 
 #############################################################################
-# File:         test/performance/benchmark_gsub_string_or_regex.rb
+# File:     test/performance/benchmark_gsub_string_or_regex.rb
 #
-# Purpose:      Determine whether gsub using a string is faster than using a
-#               regex
+# Purpose:  Determine whether gsub using a string is faster than using regex
 #
-# Created:      27th January 2019
-# Updated:      27th January 2019
+# Created:  27th January 2019
+# Updated:  6th April 2024
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
 #############################################################################
 
+
 $:.unshift File.join(File.dirname(__FILE__), *(['..'] * 2), 'lib')
 
+
 require 'benchmark'
 
-ITERATIONS	=	100000
 
-STRINGS	=	[
+ITERATIONS = 100000
+
+STRINGS = [
 
-	'abcdefghijklmnopqrstuvwxyz',
-	'a\\b/c\\d/e\\f/g\\h/i\\j/k\\l/m\\n/o\\p/q\\r/s\\t/u\\v/w\\x/y\\z/',
-	''
+  'abcdefghijklmnopqrstuvwxyz',
+  'a\\b/c\\d/e\\f/g\\h/i\\j/k\\l/m\\n/o\\p/q\\r/s\\t/u\\v/w\\x/y\\z/',
+  ''
 ]
 
-h = {
-	'/'	=>	'\\'
-}
 
-Benchmark.bm(24) do |x|
+# benchmark
 
-	x.report('gsub by str:') { (0...ITERATIONS).each { STRINGS.each { |s| s.gsub('/', '\\') }}}
-	x.report('gsub by str (?):') { (0...ITERATIONS).each { STRINGS.each { |s| s.gsub('/', '\\') if s.include?('/') }}}
-	x.report('gsub by regex:') { (0...ITERATIONS).each { STRINGS.each { |s| s.gsub(/\//, '\\') }}}
-	x.report('gsub by regex (?):') { (0...ITERATIONS).each { STRINGS.each { |s| s.gsub(/\//, '\\') if s.include?('/') }}}
-	x.report('tr:') { (0...ITERATIONS).each { STRINGS.each { |s| s.tr('/', '\\') }}}
-	x.report('tr (?):') { (0...ITERATIONS).each { STRINGS.each { |s| s.tr('/', '\\') if s.include?('/') }}}
-	x.report('tr!:') { (0...ITERATIONS).each { STRINGS.each { |s| s.tr!('/', '\\') }}}
+Benchmark.bm(20) do |x|
 
-	puts
+  x.report('gsub by str:') { (0...ITERATIONS).each { STRINGS.each { |s| s.gsub('/', '\\') }}}
+  x.report('gsub by str (?):') { (0...ITERATIONS).each { STRINGS.each { |s| s.gsub('/', '\\') if s.include?('/') }}}
+  x.report('gsub by regex:') { (0...ITERATIONS).each { STRINGS.each { |s| s.gsub(/\//, '\\') }}}
+  x.report('gsub by regex (?):') { (0...ITERATIONS).each { STRINGS.each { |s| s.gsub(/\//, '\\') if s.include?('/') }}}
+  x.report('tr:') { (0...ITERATIONS).each { STRINGS.each { |s| s.tr('/', '\\') }}}
+  x.report('tr (?):') { (0...ITERATIONS).each { STRINGS.each { |s| s.tr('/', '\\') if s.include?('/') }}}
+  x.report('tr!:') { (0...ITERATIONS).each { STRINGS.each { |s| s.tr!('/', '\\') }}}
+
+  puts
 end
 
+
+# ############################## end of file ############################# #
+

data/test/performance/benchmark_rindex2.rb

@@ -1,109 +1,117 @@
 #! /usr/bin/env ruby
 
 #############################################################################
-# File:         test/performance/benchmark_rindex2.rb
+# File:     test/performance/benchmark_rindex2.rb
 #
-# Purpose:      Determines whether it's better to use rindex() twice for
-#               Windows-slashes or once with a regex
+# Purpose:  Determines whether it's better to use rindex() twice for
+#           Windows-slashes or once with a regex
 #
-# Created:      8th January 2019
-# Updated:      8th January 2019
+# Created:  8th January 2019
+# Updated:  6th April 2024
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
 #############################################################################
 
+
 $:.unshift File.join(File.dirname(__FILE__), *(['..'] * 2), 'lib')
 
+
 require 'benchmark'
 
-ITERATIONS	=	100000
 
-SMALL_STRINGS	=	[
+ITERATIONS = 100000
 
-	'C:\dir0\dir1/dir2',
-	'C:\dir0\dir1/dir2\dir3\dir4/',
-	'C:/dir0/dir1\dir2',
+LONG_STRINGS = [
+
+  'C:' + '\dir' * 1000,
+  'C:' + '/dir' * 1000,
+  'C:' + '\dir/dir' * 500,
 ]
 
-LONG_STRINGS	=	[
+SMALL_STRINGS = [
 
-	'C:' + '\dir' * 1000,
-	'C:' + '/dir' * 1000,
-	'C:' + '\dir/dir' * 500,
+  'C:\dir0\dir1/dir2',
+  'C:\dir0\dir1/dir2\dir3\dir4/',
+  'C:/dir0/dir1\dir2',
 ]
 
+
 def by_two_calls(s)
 
-	ri_backward	=	s.rindex('\\')
-	ri_forward	=	s.rindex('/')
+  ri_backward = s.rindex('\\')
+  ri_forward  = s.rindex('/')
 
-	if ri_backward
+  if ri_backward
 
-		if ri_forward
+    if ri_forward
 
-			ri_forward > ri_backward ? ri_forward : ri_backward
-		else
+      ri_forward > ri_backward ? ri_forward : ri_backward
+    else
 
-			ri_backward
-		end
-	else
+      ri_backward
+    end
+  else
 
-		ri_forward
-	end
+    ri_forward
+  end
 end
 
 def by_regex(s)
 
-	s.rindex(/[\\\/]/)
+  s.rindex(/[\\\/]/)
 end
 
 def by_manual(s)
 
-	(1..s.size).each do |ix|
+  (1..s.size).each do |ix|
 
-		ch = s[-ix]
+    ch = s[-ix]
 
-		if '/' == ch || '\\' == ch
+    if '/' == ch || '\\' == ch
 
-			return s.size - ix
-		end
-	end
+      return s.size - ix
+    end
+  end
 end
 
+
 # check
 
 SMALL_STRINGS.each do |ss|
 
-	r_2c	=	by_two_calls(ss)
-	r_re	=	by_regex(ss)
-	r_man	=	by_manual(ss)
+  r_2c  = by_two_calls(ss)
+  r_re  = by_regex(ss)
+  r_man = by_manual(ss)
 
-	if r_2c != r_re || r_2c != r_man
+  if r_2c != r_re || r_2c != r_man
 
-		abort "For string '#{ss}' results differ: by_two_calls()=#{r_2c}; by_regex()=#{r_re}; by_manual()=#{r_man}"
-	end
+    abort "For string '#{ss}' results differ: by_two_calls()=#{r_2c}; by_regex()=#{r_re}; by_manual()=#{r_man}"
+  end
 end
 
 LONG_STRINGS.each do |ss|
 
-	r_2c	=	by_two_calls(ss)
-	r_re	=	by_regex(ss)
-	r_man	=	by_manual(ss)
+  r_2c  = by_two_calls(ss)
+  r_re  = by_regex(ss)
+  r_man = by_manual(ss)
 
-	if r_2c != r_re || r_2c != r_man
+  if r_2c != r_re || r_2c != r_man
 
-		abort "For string '#{ss}' results differ: by_two_calls()=#{r_2c}; by_regex()=#{r_re}; by_manual()=#{r_man}"
-	end
+    abort "For string '#{ss}' results differ: by_two_calls()=#{r_2c}; by_regex()=#{r_re}; by_manual()=#{r_man}"
+  end
 end
 
+
 # benchmark
 
 Benchmark.bm(12) do |x|
 
-	x.report('rindex x 2:') { (0...ITERATIONS).each { SMALL_STRINGS.each { |ss| by_two_calls(ss) } } }
-	x.report('Regex:') { (0...ITERATIONS).each { SMALL_STRINGS.each { |ss| by_regex(ss) } } }
-	x.report('manual:') { (0...ITERATIONS).each { SMALL_STRINGS.each { |ss| by_manual(ss) } } }
+  x.report('rindex x 2:') { (0...ITERATIONS).each { SMALL_STRINGS.each { |ss| by_two_calls(ss) } } }
+  x.report('Regex:') { (0...ITERATIONS).each { SMALL_STRINGS.each { |ss| by_regex(ss) } } }
+  x.report('manual:') { (0...ITERATIONS).each { SMALL_STRINGS.each { |ss| by_manual(ss) } } }
 end
 
 
+# ############################## end of file ############################# #
+

data/test/performance/benchmark_split.rb

@@ -1,32 +1,38 @@
 #! /usr/bin/env ruby
 
 #############################################################################
-# File:         test/performance/benchmark_split.rb
+# File:     test/performance/benchmark_split.rb
 #
-# Purpose:      Determines whether split is faster without regex
+# Purpose:  Determines whether split is faster without regex
 #
-# Created:      15th January 2019
-# Updated:      15th January 2019
+# Created:  15th January 2019
+# Updated:  6th April 2024
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
 #############################################################################
 
+
 $:.unshift File.join(File.dirname(__FILE__), *(['..'] * 2), 'lib')
 
+
 require 'benchmark'
 
-ITERATIONS	=	10
 
-STRINGS		=	(1..1000).map { |n| '/abc' * n }
+ITERATIONS = 10
+
+STRINGS = (1..1000).map { |n| '/abc' * n }
+
 
 # benchmark
 
 Benchmark.bm(15) do |x|
 
-	x.report('by char:') { (0...ITERATIONS).each { STRINGS.each { |s| s.split('/') } } }
-	x.report('by regex:') { (0...ITERATIONS).each { STRINGS.each { |s| s.split(/\//) } } }
-	x.report('by regex (sl):') { (0...ITERATIONS).each { STRINGS.each { |s| s.split(/[\\\/]/) } } }
+  x.report('by char:') { (0...ITERATIONS).each { STRINGS.each { |s| s.split('/') } } }
+  x.report('by regex:') { (0...ITERATIONS).each { STRINGS.each { |s| s.split(/\//) } } }
+  x.report('by regex (sl):') { (0...ITERATIONS).each { STRINGS.each { |s| s.split(/[\\\/]/) } } }
 end
 
 
+# ############################## end of file ############################# #
+

data/test/unit/compare/ts_all.rb

@@ -7,16 +7,16 @@ this_dir = File.expand_path(File.dirname(__FILE__))
 # all tc_*rb in current directory
 Dir[File.join(this_dir, 'tc_*rb')].each do |file|
 
-	$stderr.puts "requiring file '#{file}'" if $DEBUG
+  $stderr.puts "requiring file '#{file}'" if $DEBUG
 
-	require file
+  require file
 end
 
 # all ts_*rb in immediate sub-directories
 Dir[File.join(this_dir, '*', 'ts_*rb')].each do |file|
 
-	$stderr.puts "requiring file '#{file}'" if $DEBUG
+  $stderr.puts "requiring file '#{file}'" if $DEBUG
 
-	require file
+  require file
 end
 

data/test/unit/equate/ts_all.rb

@@ -7,16 +7,16 @@ this_dir = File.expand_path(File.dirname(__FILE__))
 # all tc_*rb in current directory
 Dir[File.join(this_dir, 'tc_*rb')].each do |file|
 
-	$stderr.puts "requiring file '#{file}'" if $DEBUG
+  $stderr.puts "requiring file '#{file}'" if $DEBUG
 
-	require file
+  require file
 end
 
 # all ts_*rb in immediate sub-directories
 Dir[File.join(this_dir, '*', 'ts_*rb')].each do |file|
 
-	$stderr.puts "requiring file '#{file}'" if $DEBUG
+  $stderr.puts "requiring file '#{file}'" if $DEBUG
 
-	require file
+  require file
 end
 

data/test/unit/equate/unix/ts_all.rb

@@ -7,16 +7,16 @@ this_dir = File.expand_path(File.dirname(__FILE__))
 # all tc_*rb in current directory
 Dir[File.join(this_dir, 'tc_*rb')].each do |file|
 
-	$stderr.puts "requiring file '#{file}'" if $DEBUG
+  $stderr.puts "requiring file '#{file}'" if $DEBUG
 
-	require file
+  require file
 end
 
 # all ts_*rb in immediate sub-directories
 Dir[File.join(this_dir, '*', 'ts_*rb')].each do |file|
 
-	$stderr.puts "requiring file '#{file}'" if $DEBUG
+  $stderr.puts "requiring file '#{file}'" if $DEBUG
 
-	require file
+  require file
 end
 

data/test/unit/equate/windows/ts_all.rb

@@ -7,16 +7,16 @@ this_dir = File.expand_path(File.dirname(__FILE__))
 # all tc_*rb in current directory
 Dir[File.join(this_dir, 'tc_*rb')].each do |file|
 
-	$stderr.puts "requiring file '#{file}'" if $DEBUG
+  $stderr.puts "requiring file '#{file}'" if $DEBUG
 
-	require file
+  require file
 end
 
 # all ts_*rb in immediate sub-directories
 Dir[File.join(this_dir, '*', 'ts_*rb')].each do |file|
 
-	$stderr.puts "requiring file '#{file}'" if $DEBUG
+  $stderr.puts "requiring file '#{file}'" if $DEBUG
 
-	require file
+  require file
 end
 

data/test/unit/exceptions/tc_libpath_base_exception.rb

@@ -9,19 +9,21 @@ require 'xqsr3/extensions/test/unit'
 
 class Test_LibPathBaseException < Test::Unit::TestCase
 
-	include ::LibPath::Exceptions
+  include ::LibPath::Exceptions
 
-	def test_exception_exists_and_is_a_class
+  def test_exception_exists_and_is_a_class
 
-		assert defined?(LibPathBaseException)
+    assert defined?(LibPathBaseException)
 
-		assert LibPathBaseException.is_a?(::Class)
-	end
+    assert LibPathBaseException.is_a?(::Class)
+  end
 
-	def test_cannot_be_initialised
+  def test_cannot_be_initialised
 
-		assert_raise_with_message(::NoMethodError, /private.*method.*new.*LibPathBaseException/) { LibPathBaseException.new(nil) }
-	end
+    assert_raise_with_message(::NoMethodError, /private.*method.*new.*LibPathBaseException/) { LibPathBaseException.new(nil) }
+  end
 end
 
 
+# ############################## end of file ############################# #
+

data/test/unit/exceptions/tc_malformed_name_exception.rb

@@ -8,24 +8,26 @@ require 'test/unit'
 
 class Test_MalformedNameException < Test::Unit::TestCase
 
-	include ::LibPath::Exceptions
+  include ::LibPath::Exceptions
 
-	def test_class_exists
+  def test_class_exists
 
-		assert defined?(MalformedNameException)
+    assert defined?(MalformedNameException)
 
-		assert MalformedNameException.is_a?(::Class)
-	end
+    assert MalformedNameException.is_a?(::Class)
+  end
 
-	def test_can_be_initialised
+  def test_can_be_initialised
 
-		mnx	=	MalformedNameException.new("abc\0def")
+    mnx = MalformedNameException.new("abc\0def")
 
-		assert_not_nil mnx
-		assert_not_nil mnx.name
-		assert_match /abc.*def/, mnx.name
-		assert_match /malformed name 'abc.*def'/, mnx.message
-	end
+    assert_not_nil mnx
+    assert_not_nil mnx.name
+    assert_match /abc.*def/, mnx.name
+    assert_match /malformed name 'abc.*def'/, mnx.message
+  end
 end
 
 
+# ############################## end of file ############################# #
+