pantheios-ruby 0.22.2 → 0.22.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7a43cf69af6fd33a71ff2dea48bdfee1bb24f92983677044247e934bb90e4d58
-  data.tar.gz: a8c48c5c8f60f3d796f37f3835af865e98ac0501c869cf71b6fdbb353c8a7ef7
+  metadata.gz: 4f62d11f02c39c77ce9378fae3b113e7df74da2a52c6e553af21f815a863bd3e
+  data.tar.gz: e11f1eb6fbf8f8744bb1009fc01afffb69d62398e6a0fee0b3e72e6a701af506
 SHA512:
-  metadata.gz: d4b94023494b6c744a5f66d302f1600984124b246e09d1243b1ed6d65329641659e354934439e1f81534f276bba15253a96b4332d2e736100c7e3bafe97ed89b
-  data.tar.gz: 50efc569d726263b419439dcfdc83f9a64903c56e57786a1b5205880d257ee6cfa4cb79aed1523465999a2348e394fe00e52041db7fb054943f76e35a2f504f1
+  metadata.gz: a8239a901cef7fe82e5f9ed464bd05bf39e03281e22213ea1a120446742071b23c7925ae0dd0ce574397d551692bf366d23589fddbef8fd3421f2f48071cad1d
+  data.tar.gz: 94656ef30b7dadcec2d02119cf44383935baf7875d5b0a43fa9ef14e923f7e2a2ebaf743d641f012399ed78a6395f9047f3521f29e1d6c1285e81c12e84f8392

data/CHANGES.md

@@ -1,6 +1,32 @@
 # Pantheios.Ruby - Changes <!-- omit in toc -->
 
 
+## 0.22.3 - 30th August 2026
+
+* updated `Updated:` metadata and copyright year ranges in all touched files
+  carrying those header fields;
+* preserved the 2019 transfer of copyright from **Synesis Software** to
+  **Synesis Information Systems**, adding missing current-owner lines where
+  required;
+* converted all **Ruby** source, example, and test files from tabs to
+  two-space indentation;
+* added the `warnings` branch to the **Ruby** workflow trigger;
+* updated **pantheios-ruby.gemspec** to centralise the project URL for
+  homepage and metadata URIs, and raised the **xqsr3** development dependency
+  floor;
+* updated **lib/pantheios/version.rb** for release 0.22.3;
+* removed unused local-variable assignments from **simple_file_log_service.rb** and
+  **standard_log_service_adapter.rb**;
+* corrected ambiguous regular-expression syntax in **tc_simple_file_log_service.rb**
+  and **tc_standard_log_service_adapter.rb**;
+* removed an unused process-ID assignment from **tc_standard_log_service_adapter.rb**;
+* removed unused loop and instance assignments from example and performance
+  programs;
+* warning-mode unit tests now complete without warnings;
+* guarded and initialised lazily accessed instance variables to eliminate
+  Ruby 2.7 warnings;
+
+
 ## 0.22.2 - 27th August 2026
 
 * renamed **Pantheios.Ruby.gemspec** to **pantheios-ruby.gemspec** so the filename stem matches `spec.name`;

data/NEWS.md

@@ -2,6 +2,7 @@
 
 | Date               | News Item                                                                                       |
 | ------------------ | ----------------------------------------------------------------------------------------------- |
+| 30th August 2026   | [**Pantheios.Ruby** 0.22.3](https://github.com/synesissoftware/Pantheios.Ruby/releases/tag/0.22.3) |
 | 27th August 2026   | [**Pantheios.Ruby** 0.22.2](https://github.com/synesissoftware/Pantheios.Ruby/releases/tag/0.22.2) |
 | 15th August 2026   | [**Pantheios.Ruby** 0.22.1](https://github.com/synesissoftware/Pantheios.Ruby/releases/tag/0.22.1) |
 | 5th June 2020      | [**Pantheios.Ruby** 0.22.0.2](https://github.com/synesissoftware/Pantheios.Ruby/releases/tag/0.22.0.2) |

data/TODO.md

@@ -3,8 +3,11 @@
 
 ## Functional improvements
 
-* [ ] quiet unused-variable warnings in **simple_file_log_service.rb** (`logger_init_options`) and **standard_log_service_adapter.rb** (`sym`);
-* [ ] quiet **Warnings** job noise in tests: unused `pid` in **tc_standard_log_service_adapter.rb**; ambiguous `/` in **tc_simple_file_log_service.rb** and **tc_standard_log_service_adapter.rb**;
+* [x] ~~~quiet unused-variable warnings in **simple_file_log_service.rb**
+  (`logger_init_options`) and **standard_log_service_adapter.rb** (`sym`)~~~;
+* [x] ~~~quiet **Warnings** job noise in tests: unused `pid` in
+  **tc_standard_log_service_adapter.rb**; ambiguous `/` in
+  **tc_simple_file_log_service.rb** and **tc_standard_log_service_adapter.rb**~~~;
 
 
 ## Performance improvements

data/examples/coloured_console_log_service.rb

@@ -29,7 +29,7 @@ LEVELS = %i{ violation alert critical failure warning notice informational debug
 
 LEVELS.each do |level|
 
-	log(level, "logging level #{level}")
+  log(level, "logging level #{level}")
 end
 
 # ############################## end of file ############################# #

data/examples/multiple_modules.rb

@@ -14,46 +14,46 @@ module Organisation
 
 module Helpers
 
-	include ::Pantheios
+  include ::Pantheios
 
-	def with_trace
+  def with_trace
 
-		trace
-	end
+    trace
+  end
 
-	def with_debug0; log(:debug0); end
-	def with_debug1; log(:debug1); end
-	def with_informational; log(:informational); end
-	def with_notice; log(:notice); end
-	def with_warning; log(:warning); end
-	def with_failure; log(:failure); end
-	def with_critical; log(:critical); end
-	def with_alert; log(:alert); end
+  def with_debug0; log(:debug0); end
+  def with_debug1; log(:debug1); end
+  def with_informational; log(:informational); end
+  def with_notice; log(:notice); end
+  def with_warning; log(:warning); end
+  def with_failure; log(:failure); end
+  def with_critical; log(:critical); end
+  def with_alert; log(:alert); end
 
-	def helper1
+  def helper1
 
-		trace
+    trace
 
-		with_debug0
+    with_debug0
 
-		with_notice
-	end
+    with_notice
+  end
 
 end # module Helpers
 
 class OrgClass
 
-	include Helpers
-	include ::Pantheios
+  include Helpers
+  include ::Pantheios
 
-	def initialize()
+  def initialize()
 
-		trace
+    trace
 
-		log(:debug2) { 'initialised instance of OrgClass' }
+    log(:debug2) { 'initialised instance of OrgClass' }
 
-		helper1
-	end
+    helper1
+  end
 
 end # class OrgClas
 
@@ -79,25 +79,25 @@ SUPPRESSED_SEVERITIES = %i{
 
 def detect_suppression argv
 
-	argv.each do |arg|
+  argv.each do |arg|
 
-		SUPPRESSED_SEVERITIES << arg.to_sym
-	end
+    SUPPRESSED_SEVERITIES << arg.to_sym
+  end
 end
 
 class FrontEnd
 
-	def severity_logged? severity
+  def severity_logged? severity
 
-		case severity
-		when ::Symbol
+    case severity
+    when ::Symbol
 
-			!SUPPRESSED_SEVERITIES.include?(severity)
-		else
+      !SUPPRESSED_SEVERITIES.include?(severity)
+    else
 
-			true
-		end
-	end
+      true
+    end
+  end
 end
 
 Pantheios::Core.set_front_end FrontEnd.new
@@ -125,7 +125,7 @@ with_alert
 
 log(:info) { "Creating instance of OrgClass" }
 
-oc = Organisation::OrgClass.new
+Organisation::OrgClass.new
 
 # ############################## end of file ############################# #
 

data/examples/simple_logging.rb

@@ -29,7 +29,7 @@ LEVELS = %i{ violation alert critical failure warning notice informational debug
 
 LEVELS.each do |level|
 
-	log(level, "logging level #{level}")
+  log(level, "logging level #{level}")
 end
 
 # ############################## end of file ############################# #

data/examples/threshold_front_end.rb

@@ -40,7 +40,7 @@ Pantheios::Core.set_front_end Pantheios::FrontEnds::ThresholdFrontEnd.new thresh
 
 LEVELS.each do |level|
 
-	log(level, "logging level #{level}")
+  log(level, "logging level #{level}")
 end
 
 # ############################## end of file ############################# #

data/lib/pantheios/api.rb

@@ -5,12 +5,13 @@
 # Purpose:      The Pantheios.Ruby API (::Pantheios::API)
 #
 # Created:      2nd April 2011
-# Updated:      15th August 2026
+# Updated:      28th August 2026
 #
 # Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
 # Copyright (c) 2011-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
@@ -77,219 +78,219 @@ module Pantheios
 # - prefix
 module API
 
-	# Logs an arbitrary set of parameters at the given severity level
-	def log severity, *args, &block
+  # Logs an arbitrary set of parameters at the given severity level
+  def log severity, *args, &block
 
-		return nil unless severity_logged? severity
+    return nil unless severity_logged? severity
 
-		log_or_trace_with_block_ 1, severity, args, &block
-	end
+    log_or_trace_with_block_ 1, severity, args, &block
+  end
 
-	# Logs an array of parameters at the given severity level
-	def log_v severity, argv, &block
+  # Logs an array of parameters at the given severity level
+  def log_v severity, argv, &block
 
-		return nil unless severity_logged? severity
+    return nil unless severity_logged? severity
 
-		log_or_trace_with_block_ 1, severity, argv, &block
-	end
+    log_or_trace_with_block_ 1, severity, argv, &block
+  end
 
-	# Logs an arbitrary set of parameters at the Trace (:trace) level
-	def trace *args, &block
+  # Logs an arbitrary set of parameters at the Trace (:trace) level
+  def trace *args, &block
 
-		return nil unless tracing?
+    return nil unless tracing?
 
-		trace_with_block_ 1, args, &block
-	end
+    trace_with_block_ 1, args, &block
+  end
 
-	# Logs an array of parameters at the Trace (:trace) level
-	def trace_v argv, &block
+  # Logs an array of parameters at the Trace (:trace) level
+  def trace_v argv, &block
 
-		return nil unless tracing?
+    return nil unless tracing?
 
-		trace_with_block_ 1, argv, &block
-	end
+    trace_with_block_ 1, argv, &block
+  end
 
-	if Util::VersionUtil.version_compare(RUBY_VERSION, [ 2, 1 ]) >= 0
+  if Util::VersionUtil.version_compare(RUBY_VERSION, [ 2, 1 ]) >= 0
 
-	def trace_blv b, lvars, &block
+  def trace_blv b, lvars, &block
 
-		return nil unless tracing?
+    return nil unless tracing?
 
-		::Pantheios::Core.trace_v_impl(self, 1, ApplicationLayer::ParamNameList[*lvars], :trace, lvars.map { |lv| b.local_variable_get(lv) }, &block)
-	end
-	end # RUBY_VERSION
+    ::Pantheios::Core.trace_v_impl(self, 1, ApplicationLayer::ParamNameList[*lvars], :trace, lvars.map { |lv| b.local_variable_get(lv) }, &block)
+  end
+  end # RUBY_VERSION
 
-	if Util::VersionUtil.version_compare(RUBY_VERSION, [ 2, 2 ]) >= 0
+  if Util::VersionUtil.version_compare(RUBY_VERSION, [ 2, 2 ]) >= 0
 
-	def trace_b b, &block
+  def trace_b b, &block
 
-		return nil unless tracing?
+    return nil unless tracing?
 
-		::Pantheios::Core.trace_v_impl(self, 1, ApplicationLayer::ParamNameList[*b.local_variables], :trace, b.local_variables.map { |lv| b.local_variable_get(lv) }, &block)
-	end
-	end # RUBY_VERSION
+    ::Pantheios::Core.trace_v_impl(self, 1, ApplicationLayer::ParamNameList[*b.local_variables], :trace, b.local_variables.map { |lv| b.local_variable_get(lv) }, &block)
+  end
+  end # RUBY_VERSION
 
 
-	# Determines whether a given severity is logged
-	#
-	# === Signature
-	#
-	# * *Parameters:*
-	#   - +severity+:: The severity level, which should be a known log
-	#   severity symbol or an integral equivalent
-	#
-	# * *Returns:*
-	#   a +truey+ value if the severity should be logged; a +falsey+ value
-	#   otherwise
-	def severity_logged? severity
+  # Determines whether a given severity is logged
+  #
+  # === Signature
+  #
+  # * *Parameters:*
+  #   - +severity+:: The severity level, which should be a known log
+  #   severity symbol or an integral equivalent
+  #
+  # * *Returns:*
+  #   a +truey+ value if the severity should be logged; a +falsey+ value
+  #   otherwise
+  def severity_logged? severity
 
-		::Pantheios::Core.severity_logged? severity
-	end
+    ::Pantheios::Core.severity_logged? severity
+  end
 
-	# Determines whether tracing (severity == :trace) is enabled. This is
-	# used in the trace methods (+trace+, +trace_v+, +trace_blv+, +trace_b+)
-	# and therefore it may be overridden independently of +severity_logged?+
-	def tracing?
+  # Determines whether tracing (severity == :trace) is enabled. This is
+  # used in the trace methods (+trace+, +trace_v+, +trace_blv+, +trace_b+)
+  # and therefore it may be overridden independently of +severity_logged?+
+  def tracing?
 
-		severity_logged? :trace
-	end
+    severity_logged? :trace
+  end
 
 
 
-	# Defines the ordered list of log-statement elements
-	#
-	# === Elements
-	#
-	# Elements can be one of:
-	#   - +:process_name+
-	#   - +:process_id+
-	#   - +:severity+
-	#   - +:thread_id+
-	#   - +:timestamp+
-	#
-	# This is called from +prefix+
-	def prefix_elements
+  # Defines the ordered list of log-statement elements
+  #
+  # === Elements
+  #
+  # Elements can be one of:
+  #   - +:process_name+
+  #   - +:process_id+
+  #   - +:severity+
+  #   - +:thread_id+
+  #   - +:timestamp+
+  #
+  # This is called from +prefix+
+  def prefix_elements
 
-		[ :process_name, :thread_id, :timestamp, :severity ]
-	end
+    [ :process_name, :thread_id, :timestamp, :severity ]
+  end
 
-	# Obtains the process id
-	#
-	# Unless overridden, returns the value provided by
-	# +::Pantheios::Core::process_id+
-	def process_id
+  # Obtains the process id
+  #
+  # Unless overridden, returns the value provided by
+  # +::Pantheios::Core::process_id+
+  def process_id
 
-		::Pantheios::Core.process_id
-	end
+    ::Pantheios::Core.process_id
+  end
 
-	# Obtains the program name
-	#
-	# Unless overridden, returns the value provided by
-	# +::Pantheios::Core::process_name+
-	def process_name
+  # Obtains the program name
+  #
+  # Unless overridden, returns the value provided by
+  # +::Pantheios::Core::process_name+
+  def process_name
 
-		::Pantheios::Core.process_name
-	end
+    ::Pantheios::Core.process_name
+  end
 
-	# Obtains the string corresponding to the severity
-	#
-	# Unless overridden, returns the value provided by
-	# +::Pantheios::Core::severity_string+
-	def severity_string severity
+  # Obtains the string corresponding to the severity
+  #
+  # Unless overridden, returns the value provided by
+  # +::Pantheios::Core::severity_string+
+  def severity_string severity
 
-		::Pantheios::Core.severity_string severity
-	end
+    ::Pantheios::Core.severity_string severity
+  end
 
-	# Obtains the thread id
-	#
-	# Unless overridden, returns the value provided by
-	# +::Pantheios::Core::thread_id+
-	def thread_id
+  # Obtains the thread id
+  #
+  # Unless overridden, returns the value provided by
+  # +::Pantheios::Core::thread_id+
+  def thread_id
 
-		::Pantheios::Core.thread_id
-	end
+    ::Pantheios::Core.thread_id
+  end
 
-	# Obtains a string-form of the timestamp
-	#
-	# Unless overridden, returns the value provided by
-	# +::Pantheios::Core::timestamp+
-	def timestamp t
+  # Obtains a string-form of the timestamp
+  #
+  # Unless overridden, returns the value provided by
+  # +::Pantheios::Core::timestamp+
+  def timestamp t
 
-		::Pantheios::Core.timestamp t, nil
-	end
+    ::Pantheios::Core.timestamp t, nil
+  end
 
-	# Assembles the prefix according to +prefix_elements+ into an array of
-	# parts
-	#
-	# * *Parameters:*
-	#   - +t+ [ Date, Time, DateTime ] The timestamp of the log entry
-	#   - +severity+ The severity
-	def prefix_parts t, severity
+  # Assembles the prefix according to +prefix_elements+ into an array of
+  # parts
+  #
+  # * *Parameters:*
+  #   - +t+ [ Date, Time, DateTime ] The timestamp of the log entry
+  #   - +severity+ The severity
+  def prefix_parts t, severity
 
-		prefix_elements.map do |el|
+    prefix_elements.map do |el|
 
-			case el
-			when :program_name, :process_name
+      case el
+      when :program_name, :process_name
 
-				process_name
-			when :process_id
+        process_name
+      when :process_id
 
-				process_id
-			when :severity
+        process_id
+      when :severity
 
-				severity_string severity
-			when :thread_id
+        severity_string severity
+      when :thread_id
 
-				thread_id
-			when :timestamp
+        thread_id
+      when :timestamp
 
-				timestamp t
-			else
+        timestamp t
+      else
 
-				s = ::Symbol === el ? ":#{el}" : el.to_s
+        s = ::Symbol === el ? ":#{el}" : el.to_s
 
-				warn "ignoring unrecognised prefix_element '#{s}'"
+        warn "ignoring unrecognised prefix_element '#{s}'"
 
-				nil
-			end
-		end
-	end
+        nil
+      end
+    end
+  end
 
-	# Assembles the +prefix_parts+ into a string
-	#
-	# * *Parameters:*
-	#   - +t+ [ Date, Time, DateTime ] The timestamp of the log entry
-	#   - +severity+ The severity
-	def prefix t, severity
+  # Assembles the +prefix_parts+ into a string
+  #
+  # * *Parameters:*
+  #   - +t+ [ Date, Time, DateTime ] The timestamp of the log entry
+  #   - +severity+ The severity
+  def prefix t, severity
 
-		prefix_parts(t, severity).join(', ')
-	end
+    prefix_parts(t, severity).join(', ')
+  end
 
-	# @!visibility private
-	def self.included receiver # :nodoc:
+  # @!visibility private
+  def self.included receiver # :nodoc:
 
-		receiver.extend self
+    receiver.extend self
 
-		::Pantheios::Core.register_include self, receiver
-	end
+    ::Pantheios::Core.register_include self, receiver
+  end
 
-	private
+  private
 
-	# Private implementation method that should not need to be overridden
-	def log_or_trace_with_block_ call_depth, severity, argv, &block
+  # Private implementation method that should not need to be overridden
+  def log_or_trace_with_block_ call_depth, severity, argv, &block
 
-		if :trace == severity
+    if :trace == severity
 
-			return ::Pantheios::Core.trace_v_impl self, 1 + call_depth, nil, severity, argv, &block
-		end
+      return ::Pantheios::Core.trace_v_impl self, 1 + call_depth, nil, severity, argv, &block
+    end
 
-		::Pantheios::Core.log_v_impl self, severity, argv, &block
-	end
+    ::Pantheios::Core.log_v_impl self, severity, argv, &block
+  end
 
-	def trace_with_block_ call_depth, argv, &block
+  def trace_with_block_ call_depth, argv, &block
 
-		return ::Pantheios::Core.trace_v_impl self, 1 + call_depth, nil, :trace, argv, &block
-	end
+    return ::Pantheios::Core.trace_v_impl self, 1 + call_depth, nil, :trace, argv, &block
+  end
 
 end # module API
 end # module Pantheios