pantheios-ruby 0.22.0.2 → 0.22.3

data/lib/pantheios/util/process_util.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module Util
@@ -5,41 +6,41 @@ module Util
 # process utilities
 module ProcessUtil
 
-	#
-	# * *Options:*
-	#   - +:style+:: (:script, :script_basename, :script_dirname, :script_realpath, :script_stem) directs
-	#   the inference of the process name. If none specified, :script_stem is assumed
-	def self.derive_process_name dollar0 = nil, **options
+  #
+  # * *Options:*
+  #   - +:style+:: (:script, :script_basename, :script_dirname, :script_realpath, :script_stem) directs
+  #   the inference of the process name. If none specified, :script_stem is assumed
+  def self.derive_process_name dollar0 = nil, **options
 
-		dollar0	||=	$0
+    dollar0  ||=  $0
 
-		style	=	options[:style] || :script_stem
+    style  =  options[:style] || :script_stem
 
-		case style
-		when :script
+    case style
+    when :script
 
-			dollar0
-		when :script_basename
+      dollar0
+    when :script_basename
 
-			File.basename(dollar0)
-		when :script_dirname
+      File.basename(dollar0)
+    when :script_dirname
 
-			File.basename(File.realpath(File.dirname(dollar0)))
-		when :script_realpath
+      File.basename(File.realpath(File.dirname(dollar0)))
+    when :script_realpath
 
-			File.realpath(File.dirname(dollar0))
-		when :script_stem
+      File.realpath(File.dirname(dollar0))
+    when :script_stem
 
-			bn = File.basename(dollar0)
+      bn = File.basename(dollar0)
 
-			bn =~ /\.rb$/ ? $` : bn
-		else
+      bn =~ /\.rb$/ ? $` : bn
+    else
 
-			warn "#{self.class}##{__method__}: ignoring unrecognised type/value for ':style': '#{style}' (#{style.class})"
+      warn "#{self.class}##{__method__}: ignoring unrecognised type/value for ':style': '#{style}' (#{style.class})"
 
-			dollar0
-		end
-	end
+      dollar0
+    end
+  end
 
 end # module ProcessUtil
 

data/lib/pantheios/util/reflection_util.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module Util
@@ -5,27 +6,27 @@ module Util
 # reflection utilities
 module ReflectionUtil
 
-	module ReflectionUtil_Constants
+  module ReflectionUtil_Constants
 
-		ROOT_CLASSES = [ ::Object, ::BasicObject ]
-	end
+    ROOT_CLASSES = [ ::Object, ::BasicObject ]
+  end
 
-	# Obtains a list of all classes pertaining to +o+, excepting root
-	# objects (+::Object+ and +::BaseObject+).
-	def self.non_root_classes o
+  # Obtains a list of all classes pertaining to +o+, excepting root
+  # objects (+::Object+ and +::BaseObject+).
+  def self.non_root_classes o
 
-		return [] if o.nil?
+    return [] if o.nil?
 
-		return self.non_root_classes o.class unless ::Class === o
+    return self.non_root_classes o.class unless ::Class === o
 
-		return [] if ReflectionUtil_Constants::ROOT_CLASSES.any? { |c| c == o }
+    return [] if ReflectionUtil_Constants::ROOT_CLASSES.any? { |c| c == o }
 
-		s = o.superclass
+    s = o.superclass
 
-		return [ o ] if ::Object == s
+    return [ o ] if ::Object == s
 
-		[ o ] + self.non_root_classes(s)
-	end
+    [ o ] + self.non_root_classes(s)
+  end
 
 end # module ProcessUtil
 

data/lib/pantheios/util/thread_util.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module Util
@@ -5,77 +6,77 @@ module Util
 # threading utilities
 module ThreadUtil
 
-	# Creates (if necessary) and sets the given thread's +thread_name+
-	# attribute to the given name
-	#
-	# === Signature
-	#
-	# * *Parameters:*
-	#  - +t+ [Thread, nil] The thread to be named, or +nil+ if it should
-	#    operate on the current (invoking) thread
-	#  - +name+ [String] The thread's name
-	def self.set_thread_name t, name
+  # Creates (if necessary) and sets the given thread's +thread_name+
+  # attribute to the given name
+  #
+  # === Signature
+  #
+  # * *Parameters:*
+  #  - +t+ [Thread, nil] The thread to be named, or +nil+ if it should
+  #    operate on the current (invoking) thread
+  #  - +name+ [String] The thread's name
+  def self.set_thread_name t, name
 
-		t ||= Thread.current
+    t ||= Thread.current
 
-		class << t; attr_accessor :thread_name; end unless t.respond_to? :thread_name
+    class << t; attr_accessor :thread_name; end unless t.respond_to? :thread_name
 
-		t.thread_name = name
-	end
+    t.thread_name = name
+  end
 
-	# Obtains the name of the calling thread
-	def self.get_thread_name t
+  # Obtains the name of the calling thread
+  def self.get_thread_name t
 
-		t ||= Thread.current
+    t ||= Thread.current
 
-		return t.thread_name if t.respond_to? :thread_name
+    return t.thread_name if t.respond_to? :thread_name
 
-		t.to_s
-	end
+    t.to_s
+  end
 
-	# Inclusion module for giving the included type the +thread_name+
-	# attribute
-	#
-	# If included into a thread type, or a thread instance, then
-	module ThreadName
+  # Inclusion module for giving the included type the +thread_name+
+  # attribute
+  #
+  # If included into a thread type, or a thread instance, then
+  module ThreadName
 
-		def self.included receiver
+    def self.included receiver
 
-			if receiver < ::Thread
+      if receiver < ::Thread
 
-				receiver.instance_eval do
+        receiver.instance_eval do
 
-					define_method(:thread_name) { @thread_name || self.to_s }
-					define_method(:thread_name=) { |name| @thread_name = name }
-				end
-			else
+          define_method(:thread_name) { defined?(@thread_name) && @thread_name || self.to_s }
+          define_method(:thread_name=) { |name| @thread_name = name }
+        end
+      else
 
-				receiver.instance_eval do
+        receiver.instance_eval do
 
-					define_method :thread_name do |name = (name_not_given_ = true)|
+          define_method :thread_name do |name = (name_not_given_ = true)|
 
-						t = Thread.current
+            t = Thread.current
 
-						has_tn = t.respond_to? :thread_name
+            has_tn = t.respond_to? :thread_name
 
-						if name_not_given_
+            if name_not_given_
 
-							return t.thread_name if has_tn
+              return t.thread_name if has_tn
 
-							t.to_s
-						else
+              t.to_s
+            else
 
-							class << t; attr_accessor :thread_name; end unless has_tn
+              class << t; attr_accessor :thread_name; end unless has_tn
 
-							t.thread_name = name
-						end
-					end
+              t.thread_name = name
+            end
+          end
 
-					define_method(:thread_name=) { |name| thread_name name }
-				end
-			end
-		end
-	end
+          define_method(:thread_name=) { |name| thread_name name }
+        end
+      end
+    end
+  end
 
 end # module ThreadUtil
 

data/lib/pantheios/util/version_util.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module Util
@@ -5,39 +6,39 @@ module Util
 # version utilities
 module VersionUtil
 
-	# Compares two version designators and returns a spaceship comparison
-	# result
-	#
-	# === Signature
-	#
-	# * *Parameters:*
-	#  - +lhs+ [String, Array[Integer|String]] The left-hand comparand
-	#  - +rhs+ [String, Array[Integer|String]] The right-hand comparand
-	#
-	# * *Returns:*
-	#  - 0 if the two version designators represent exactly the same version
-	#  - <0 if the +lhs+ version designator represents an earlier version
-	#    than the +rhs+ version designator
-	#  - >0 if the +lhs+ version designator represents a later version
-	#    than the +rhs+ version designator
-	def self.version_compare lhs, rhs
-
-		lhs	=	lhs.split('.') if String === lhs
-		rhs	=	rhs.split('.') if String === rhs
-
-		lhs	=	lhs.map { |n| n.to_i }
-		rhs	=	rhs.map { |n| n.to_i }
-
-		if lhs.size < rhs.size
-
-			lhs += [ 0 ] * (rhs.size - lhs.size)
-		else
-
-			rhs += [ 0 ] * (lhs.size - rhs.size)
-		end
-
-		lhs <=> rhs
-	end
+  # Compares two version designators and returns a spaceship comparison
+  # result
+  #
+  # === Signature
+  #
+  # * *Parameters:*
+  #  - +lhs+ [String, Array[Integer|String]] The left-hand comparand
+  #  - +rhs+ [String, Array[Integer|String]] The right-hand comparand
+  #
+  # * *Returns:*
+  #  - 0 if the two version designators represent exactly the same version
+  #  - <0 if the +lhs+ version designator represents an earlier version
+  #    than the +rhs+ version designator
+  #  - >0 if the +lhs+ version designator represents a later version
+  #    than the +rhs+ version designator
+  def self.version_compare lhs, rhs
+
+    lhs  =  lhs.split('.') if String === lhs
+    rhs  =  rhs.split('.') if String === rhs
+
+    lhs  =  lhs.map { |n| n.to_i }
+    rhs  =  rhs.map { |n| n.to_i }
+
+    if lhs.size < rhs.size
+
+      lhs += [ 0 ] * (rhs.size - lhs.size)
+    else
+
+      rhs += [ 0 ] * (lhs.size - rhs.size)
+    end
+
+    lhs <=> rhs
+  end
 end # module VersionUtil
 
 end # module Util

data/lib/pantheios/util.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 require 'pantheios/util/process_util'
 require 'pantheios/util/thread_util'

data/lib/pantheios/version.rb

@@ -1,17 +1,17 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
-# File:         lib/pantheios/version.rb
+# File:     lib/pantheios/version.rb
 #
-# Purpose:      Version for Pantheios.Ruby library
+# Purpose:  Version for Pantheios.Ruby library
 #
-# Created:      2nd April 2011
-# Updated:      5th June 2020
+# Created:  2nd April 2011
+# Updated:  30th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:     https://github.com/synesissoftware/Pantheios.Ruby
 #
-# Author:       Matthew Wilson
+# Author:   Matthew Wilson
 #
-# Copyright (c) 2019-2020, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2011-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -50,18 +50,18 @@
 
 module Pantheios
 
-	# Current version of the Pantheios.Ruby library
-	VERSION				=	'0.22.0.2'
+  # Current version of the Pantheios.Ruby library
+  VERSION           = '0.22.3'
 
-	private
-	VERSION_PARTS_		=	VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:
-	public
-	# Major version of the Pantheios.Ruby library
-	VERSION_MAJOR		=	VERSION_PARTS_[0] # :nodoc:
-	# Minor version of the Pantheios.Ruby library
-	VERSION_MINOR		=	VERSION_PARTS_[1] # :nodoc:
-	# Revision version of the Pantheios.Ruby library
-	VERSION_REVISION	=	VERSION_PARTS_[2] # :nodoc:
+  private
+  VERSION_PARTS_    = VERSION.split(/[.]/).collect { |n| n.to_i } # :nodoc:
+  public
+  # Major version of the Pantheios.Ruby library
+  VERSION_MAJOR     = VERSION_PARTS_[0] # :nodoc:
+  # Minor version of the Pantheios.Ruby library
+  VERSION_MINOR     = VERSION_PARTS_[1] # :nodoc:
+  # Revision version of the Pantheios.Ruby library
+  VERSION_REVISION  = VERSION_PARTS_[2] # :nodoc:
 
 end # module Pantheios
 

data/lib/pantheios.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # The main module for Pantheios
 #
 # Pantheios is both a namespace module and an inclusion module. When
@@ -19,21 +19,21 @@ require 'pantheios/version'
 
 module Pantheios
 
-	# @!visibility private
-	def self.included receiver # :nodoc:
+  # @!visibility private
+  def self.included receiver # :nodoc:
 
-		if ::Pantheios::Globals.HAS_CASCADED_INCLUDES
+    if ::Pantheios::Globals.HAS_CASCADED_INCLUDES
 
-			receiver.class_eval do
+      receiver.class_eval do
 
-				include ::Pantheios::API
-				include ::Pantheios::ApplicationLayer
-				include ::Pantheios::Util
-			end
-		end
+        include ::Pantheios::API
+        include ::Pantheios::ApplicationLayer
+        include ::Pantheios::Util
+      end
+    end
 
-		::Pantheios::Core.register_include self, receiver
-	end
+    ::Pantheios::Core.register_include self, receiver
+  end
 
 end # module Pantheios
 

data/test/performance/test_perf_simple_statements.rb

@@ -6,7 +6,7 @@
 # Purpose:      COMPLETE_ME
 #
 # Created:      22nd January 2018
-# Updated:      22nd January 2018
+# Updated:      28th August 2026
 #
 # Author:       Matthew Wilson
 #
@@ -31,102 +31,102 @@ N = 5000000
 
 def severity_logged? severity
 
-	return false
+  return false
 end
 
 
 Benchmark.benchmark(Benchmark::CAPTION, 24, Benchmark::FORMAT, 'total:', 'avg:') do |r|
 
-	totals	=	[]
+  totals  =  []
 
-	totals << r.report("arguments (1-arg)") do
+  totals << r.report("arguments (1-arg)") do
 
-		for i in (0...N) do
+    N.times do
 
-			log :notice, 'the cat in the hat.'
-		end
-	end
+      log :notice, 'the cat in the hat.'
+    end
+  end
 
-	totals << r.report("blocks (1-arg)") do
+  totals << r.report("blocks (1-arg)") do
 
-		for i in (0...N) do
+    N.times do
 
-			log(:notice) { 'the cat in the hat!' }
-		end
-	end
+      log(:notice) { 'the cat in the hat!' }
+    end
+  end
 
-	totals << r.report("args-if (1-arg)") do
+  totals << r.report("args-if (1-arg)") do
 
-		for i in (0...N) do
+    N.times do
 
-			log :notice, 'the cat in the hat.' if severity_logged? :notice
-		end
-	end
+      log :notice, 'the cat in the hat.' if severity_logged? :notice
+    end
+  end
 
 
-	totals << r.report("arguments (simple)") do
+  totals << r.report("arguments (simple)") do
 
-		for i in (0...N) do
+    N.times do
 
-			log :notice, 'the ', 'cat ', 'in ', 'the ', 'hat.'
-		end
-	end
+      log :notice, 'the ', 'cat ', 'in ', 'the ', 'hat.'
+    end
+  end
 
-	totals << r.report("blocks (simple)") do
+  totals << r.report("blocks (simple)") do
 
-		for i in (0...N) do
+    N.times do
 
-			log(:notice) { 'the ' + 'cat ' + 'in ' + 'the ' + 'hat!' }
-		end
-	end
+      log(:notice) { 'the ' + 'cat ' + 'in ' + 'the ' + 'hat!' }
+    end
+  end
 
-	totals << r.report("args-if (simple)") do
+  totals << r.report("args-if (simple)") do
 
-		for i in (0...N) do
+    N.times do
 
-			log :notice, 'the ', 'cat ', 'in ', 'the ', 'hat.' if severity_logged? :notice
-		end
-	end
+      log :notice, 'the ', 'cat ', 'in ', 'the ', 'hat.' if severity_logged? :notice
+    end
+  end
 
 
-	totals << r.report("arguments (complex)") do
+  totals << r.report("arguments (complex)") do
 
-		cat	=	'cat'
-		hat	=	:hat
-		t	=	Time.now
+    cat  =  'cat'
+    hat  =  :hat
+    t  =  Time.now
 
-		for i in (0...N) do
+    N.times do
 
-			log :notice, "the #{cat} in the #{hat} (#{t})"
-		end
-	end
+      log :notice, "the #{cat} in the #{hat} (#{t})"
+    end
+  end
 
-	totals << r.report("blocks (complex)") do
+  totals << r.report("blocks (complex)") do
 
-		cat	=	'cat'
-		hat	=	:hat
-		t	=	Time.now
+    cat  =  'cat'
+    hat  =  :hat
+    t  =  Time.now
 
-		for i in (0...N) do
+    N.times do
 
-			log(:notice) { "the #{cat} in the #{hat} (#{t})" }
-		end
-	end
+      log(:notice) { "the #{cat} in the #{hat} (#{t})" }
+    end
+  end
 
-	totals << r.report("args-if (complex)") do
+  totals << r.report("args-if (complex)") do
 
-		cat	=	'cat'
-		hat	=	:hat
-		t	=	Time.now
+    cat  =  'cat'
+    hat  =  :hat
+    t  =  Time.now
 
-		for i in (0...N) do
+    N.times do
 
-			log :notice, "the #{cat} in the #{hat} (#{t})" if severity_logged? :notice
-		end
-	end
+      log :notice, "the #{cat} in the #{hat} (#{t})" if severity_logged? :notice
+    end
+  end
 
 
-	[ totals.inject(:+), totals.inject(:+) / totals.size ]
+  [ totals.inject(:+), totals.inject(:+) / totals.size ]
 end