pantheios-ruby 0.22.0.2 → 0.22.3

data/lib/pantheios/services/common/console.rb

@@ -1,3 +1,4 @@
+# frozen_string_literal: true
 
 module Pantheios
 module Services
@@ -5,85 +6,85 @@ module Common
 
 module Console
 
-	module Internal_
+  module Internal_
 
-		STDERR_ISATTY_		=	$stderr.isatty
-		OS_IS_UNIX_			=	%w{
+    STDERR_ISATTY_    =  $stderr.isatty
+    OS_IS_UNIX_      =  %w{
 
-			darwin
-			freebsd
-			linux
-			mingw32
-			solaris
-			sunos
-		}.any? { |os| RUBY_PLATFORM =~ /#{os.downcase}/ }
-		SHOULD_COLOURIZE_	=	STDERR_ISATTY_ && OS_IS_UNIX_
+      darwin
+      freebsd
+      linux
+      mingw32
+      solaris
+      sunos
+    }.any? { |os| RUBY_PLATFORM =~ /#{os.downcase}/ }
+    SHOULD_COLOURIZE_  =  STDERR_ISATTY_ && OS_IS_UNIX_
 
-		module ColourInitialiser
+    module ColourInitialiser
 
-			def self.extended other
+      def self.extended other
 
-				other::COLOURS.each do |name, value|
+        other::COLOURS.each do |name, value|
 
-					other.const_set(name.to_s.upcase, value)
+          other.const_set(name.to_s.upcase, value)
 
-					if SHOULD_COLOURIZE_
+          if SHOULD_COLOURIZE_
 
-						other.define_singleton_method(name) { |s| "\x1B[#{value}m#{s}\x1B[0m" }
-					else
+            other.define_singleton_method(name) { |s| "\x1B[#{value}m#{s}\x1B[0m" }
+          else
 
-						other.define_singleton_method(name) { |s| s }
-					end
-				end
-			end
-		end # module ColourInitialiser
-	end # module Internal_
+            other.define_singleton_method(name) { |s| s }
+          end
+        end
+      end
+    end # module ColourInitialiser
+  end # module Internal_
 
-	module AnsiEscapeSequences
+  module AnsiEscapeSequences
 
-		module Foreground
+    module Foreground
 
-			COLOURS	=	{
+      COLOURS  =  {
 
-				blinking: 5,
-				bold: 1,
-				default: 39,
+        blinking: 5,
+        bold: 1,
+        default: 39,
 
-				black: 30,
-				red: 31,
-				green: 32,
-				yellow: 33,
-				blue: 34,
-				magenta: 35,
-				cyan: 36,
-				light_grey: 37,
+        black: 30,
+        red: 31,
+        green: 32,
+        yellow: 33,
+        blue: 34,
+        magenta: 35,
+        cyan: 36,
+        light_grey: 37,
 
-				dark_grey: 90,
-				bright_red: 91,
-				bright_green: 92,
-				bright_yellow: 93,
-				bright_blue: 94,
-				bright_magenta: 95,
-				bright_cyan: 96,
-				white: 97,
-			}
+        dark_grey: 90,
+        bright_red: 91,
+        bright_green: 92,
+        bright_yellow: 93,
+        bright_blue: 94,
+        bright_magenta: 95,
+        bright_cyan: 96,
+        white: 97,
+      }
 
-			extend Internal_::ColourInitialiser
-		end # module Foreground
+      extend Internal_::ColourInitialiser
+    end # module Foreground
 
-		module Background
+    module Background
 
-			COLOURS = Hash[Foreground::COLOURS.reject { |k, v| [ :blinking, :bold, :default ].include? k }.map { |k, v| [ k, 10 + v ] }]
+      COLOURS = Hash[Foreground::COLOURS.reject { |k, v| [ :blinking, :bold, :default ].include? k }.map { |k, v| [ k, 10 + v ] }]
 
-			extend Internal_::ColourInitialiser
-		end # module Background
+      extend Internal_::ColourInitialiser
+    end # module Background
 
-		module Special
+    module Special
 
-			# TODO
+      # TODO
 
-		end # module Special
-	end # end AnsiEscapeSequences
+    end # module Special
+  end # end AnsiEscapeSequences
 
 end # module Console
 end # module Common

data/lib/pantheios/services/multiplexing_log_service.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/services/multiplexing_log_service.rb
 #
@@ -6,14 +6,14 @@
 #               ::Pantheios::Services::MultiplexingLogService class
 #
 # Created:      14th June 2015
-# Updated:      4th June 2020
+# Updated:      28th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #
-# Copyright (c) 2019-2020, Matthew Wilson and Synesis Information Systems
-# Copyright (c) 2015-2018, Matthew Wilson and Synesis Software
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2015-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without
@@ -60,214 +60,215 @@ module Services
 # +log(severity : Object, t : Time, prefix : String|Array, msg : String)+
 class MultiplexingLogService
 
-	# @!visibility private
-	module MultiplexingLogService_Internals_ # :nodoc: all
+  # @!visibility private
+  module MultiplexingLogService_Internals_ # :nodoc: all
 
-		class ServiceManagementInfo
+    class ServiceManagementInfo
 
-			def initialize svc
+      def initialize svc
 
-				@service	=	svc
-			end
+        @service  =  svc
+      end
 
-			attr_reader	:service
-		end
-	end
+      attr_reader  :service
+    end
+  end
 
-	# Initializes the instance with an array of log services, according to
-	# the given options
-	#
-	# ===Signature
-	#
-	# * *Parameters:*
-	#   - +services+:: [ ::Array ] An array of instances that observe the
-	#     Log Service protocol
-	#   - +options+:: [ ::Hash] options
-	#
-	# * *Options:*
-	#   - +:level_cache_mode+:: [ ::Symbol ] Specifies the mode of severity
-	#     level caching, and must be one of the following values:
-	#     * +:none+:: no severity level caching is performed. This is the
-	#       default because it is completely thread-safe, but it is the
-	#       slowest mode, and users are advised to specify another mode
-	#       suitable to their use
-	#     * +:thread_fixed+:: remembers the response of each multiplexed log
-	#       service to each severity level on a thread-specific basis
-	#     * +:process_fixed+:: remembers the response of each multiplexed
-	#       log service to each severity level and then remembers that for
-	#       the duration of the lifetime of the instance
-	#   - +:unsync_process_lcm+:: [ boolean ] If truey, causes
-	#     +:process_fixed+ +:level_cache_mode+ to NOT be synchronised; the
-	#     default is for it to be synchronised using an internal +Mutex+
-	#     instance
-	def initialize services, **options
+  # Initializes the instance with an array of log services, according to
+  # the given options
+  #
+  # ===Signature
+  #
+  # * *Parameters:*
+  #   - +services+:: [ ::Array ] An array of instances that observe the
+  #     Log Service protocol
+  #   - +options+:: [ ::Hash] options
+  #
+  # * *Options:*
+  #   - +:level_cache_mode+:: [ ::Symbol ] Specifies the mode of severity
+  #     level caching, and must be one of the following values:
+  #     * +:none+:: no severity level caching is performed. This is the
+  #       default because it is completely thread-safe, but it is the
+  #       slowest mode, and users are advised to specify another mode
+  #       suitable to their use
+  #     * +:thread_fixed+:: remembers the response of each multiplexed log
+  #       service to each severity level on a thread-specific basis
+  #     * +:process_fixed+:: remembers the response of each multiplexed
+  #       log service to each severity level and then remembers that for
+  #       the duration of the lifetime of the instance
+  #   - +:unsync_process_lcm+:: [ boolean ] If truey, causes
+  #     +:process_fixed+ +:level_cache_mode+ to NOT be synchronised; the
+  #     default is for it to be synchronised using an internal +Mutex+
+  #     instance
+  def initialize services, **options
 
-		@tss_sym	=	self.to_s.to_sym
-		@services	=	services.map { |svc| MultiplexingLogService_Internals_::ServiceManagementInfo.new svc }
-		@options	=	options.dup
-		@mode		=	options[:level_cache_mode]
-		@unsync_pf	=	options[:unsync_process_lcm]
+    @tss_sym  =  self.to_s.to_sym
+    @services  =  services.map { |svc| MultiplexingLogService_Internals_::ServiceManagementInfo.new svc }
+    @options  =  options.dup
+    @mode    =  options[:level_cache_mode]
+    @unsync_pf  =  options[:unsync_process_lcm]
 
-		@process_m	=	{}
-		@mx			=	Mutex.new unless @unsync_pf
-	end
+    @process_m  =  {}
+    @requires_prefix  =  nil
+    @mx      =  Mutex.new unless @unsync_pf
+  end
 
-	private
+  private
 
-	# { svc => { sev => flag } }
-	def get_tss_svc_sev_map_
+  # { svc => { sev => flag } }
+  def get_tss_svc_sev_map_
 
-		sym	=	@tss_sym
-		tc	=	Thread.current
-		m	=	tc.thread_variable_get sym
+    sym  =  @tss_sym
+    tc  =  Thread.current
+    m  =  tc.thread_variable_get sym
 
-		unless m
+    unless m
 
-			tc.thread_variable_set sym, (m = {})
-		end
+      tc.thread_variable_set sym, (m = {})
+    end
 
-		m
-	end
+    m
+  end
 
-	def svc_sev_logged_tf_ m, svc, severity
+  def svc_sev_logged_tf_ m, svc, severity
 
-		m[svc.object_id]	||=	{}
+    m[svc.object_id]  ||=  {}
 
-		unless m[svc.object_id].has_key? severity
+    unless m[svc.object_id].has_key? severity
 
-			r = svc.severity_logged? severity
+      r = svc.severity_logged? severity
 
-			m[svc.object_id][severity] = r
-		else
+      m[svc.object_id][severity] = r
+    else
 
-			r = m[svc.object_id][severity]
-		end
+      r = m[svc.object_id][severity]
+    end
 
-		r
-	end
+    r
+  end
 
-	def svc_sev_logged_pf_ m, svc, severity
+  def svc_sev_logged_pf_ m, svc, severity
 
-		m[svc.object_id]	||=	{}
+    m[svc.object_id]  ||=  {}
 
-		unless m[svc.object_id].has_key? severity
+    unless m[svc.object_id].has_key? severity
 
-			r = svc.severity_logged? severity
+      r = svc.severity_logged? severity
 
-			m[svc.object_id][severity] = r
-		else
+      m[svc.object_id][severity] = r
+    else
 
-			r = m[svc.object_id][severity]
-		end
+      r = m[svc.object_id][severity]
+    end
 
-		r
-	end
+    r
+  end
 
-	def sev_logged_pf_ m, severity
+  def sev_logged_pf_ m, severity
 
-		@services.any? { |smi| svc_sev_logged_pf_ m, smi.service, severity }
-	end
-	public
+    @services.any? { |smi| svc_sev_logged_pf_ m, smi.service, severity }
+  end
+  public
 
-	# Indicates whether any of the services require a prefix and, if so,
-	# what it may require
-	#
-	# === Return
-	# (+false+, +true+, +:parts+) An indicator what the most needy of the
-	# multiplexed services requires
-	def requires_prefix?
+  # Indicates whether any of the services require a prefix and, if so,
+  # what it may require
+  #
+  # === Return
+  # (+false+, +true+, +:parts+) An indicator what the most needy of the
+  # multiplexed services requires
+  def requires_prefix?
 
-		return @requires_prefix unless @requires_prefix.nil?
+    return @requires_prefix unless @requires_prefix.nil?
 
-		requires_prefix = false
+    requires_prefix = false
 
-		@services.each do |svc|
+    @services.each do |svc|
 
-			if svc.respond_to? :requires_prefix?
+      if svc.respond_to? :requires_prefix?
 
-				case rp = svc.requires_prefix?
-				when nil, false
+        case rp = svc.requires_prefix?
+        when nil, false
 
-					;
-				when true
+          ;
+        when true
 
-					requires_prefix ||= true
-				when :parts
+          requires_prefix ||= true
+        when :parts
 
-					requires_prefix = rp
-					break
-				else
+          requires_prefix = rp
+          break
+        else
 
-					warn "unrecognised return from requires_prefix? for service #{svc}: #{rp} (#{rp.class})"
-				end
-			end
-		end
+          warn "unrecognised return from requires_prefix? for service #{svc}: #{rp} (#{rp.class})"
+        end
+      end
+    end
 
-		@requires_prefix = requires_prefix
-	end
+    @requires_prefix = requires_prefix
+  end
 
-	# Indicates whether the given severity is to be logged by any of the
-	# multiplexed log services
-	def severity_logged? severity
+  # Indicates whether the given severity is to be logged by any of the
+  # multiplexed log services
+  def severity_logged? severity
 
-		case @mode
-		when :process_fixed
+    case @mode
+    when :process_fixed
 
-			if @unsync_pf
+      if @unsync_pf
 
-				sev_logged_pf_ @process_m, severity
-			else
+        sev_logged_pf_ @process_m, severity
+      else
 
-				@mx.synchronize { sev_logged_pf_ @process_m, severity }
-			end
-		when :thread_fixed
+        @mx.synchronize { sev_logged_pf_ @process_m, severity }
+      end
+    when :thread_fixed
 
-			m	=	get_tss_svc_sev_map_
+      m  =  get_tss_svc_sev_map_
 
-			@services.any? do |smi|
+      @services.any? do |smi|
 
-				svc	=	smi.service
+        svc  =  smi.service
 
-				svc_sev_logged_tf_ m, svc, severity
-			end
-		else # :none
+        svc_sev_logged_tf_ m, svc, severity
+      end
+    else # :none
 
-			@services.any? { |smi| smi.service.severity_logged? severity }
-		end
-	end
+      @services.any? { |smi| smi.service.severity_logged? severity }
+    end
+  end
 
-	def log sev, t, pref, msg
+  def log sev, t, pref, msg
 
-		tss_m	=	:thread_fixed == @mode ? get_tss_svc_sev_map_ : nil
+    tss_m  =  :thread_fixed == @mode ? get_tss_svc_sev_map_ : nil
 
-		@services.each do |smi|
+    @services.each do |smi|
 
-			svc	=	smi.service
+      svc  =  smi.service
 
-			case @mode
-			when :process_fixed
+      case @mode
+      when :process_fixed
 
-				if @unsync_pf
+        if @unsync_pf
 
-					isl	=	svc_sev_logged_pf_ @process_m, svc, sev
-				else
+          isl  =  svc_sev_logged_pf_ @process_m, svc, sev
+        else
 
-					isl	=	@mx.synchronize { svc_sev_logged_pf_ @process_m, svc, sev }
-				end
-			when :thread_fixed
+          isl  =  @mx.synchronize { svc_sev_logged_pf_ @process_m, svc, sev }
+        end
+      when :thread_fixed
 
-				m	=	tss_m
+        m  =  tss_m
 
-				isl	=	svc_sev_logged_tf_ m, svc, sev
-			else # :none
+        isl  =  svc_sev_logged_tf_ m, svc, sev
+      else # :none
 
-				isl	=	svc.severity_logged? sev
-			end
+        isl  =  svc.severity_logged? sev
+      end
 
 
-			svc.log sev, t, pref, msg if isl
-		end
-	end
+      svc.log sev, t, pref, msg if isl
+    end
+  end
 end
 
 end # module Services

data/lib/pantheios/services/null_log_service.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/services/null_log_service.rb
 #
@@ -6,14 +6,14 @@
 #               class
 #
 # Created:      14th June 2015
-# Updated:      4th June 2020
+# Updated:      28th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #
-# Copyright (c) 2019-2020, Matthew Wilson and Synesis Information Systems
-# Copyright (c) 2015-2018, Matthew Wilson and Synesis Software
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2015-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without
@@ -60,15 +60,15 @@ module Services
 # +log(severity : Object, t : Time, prefix : String|Array, msg : String)+
 class NullLogService
 
-	def severity_logged? severity
+  def severity_logged? severity
 
-		false
-	end
+    false
+  end
 
-	def log sev, t, pref, msg
+  def log sev, t, pref, msg
 
-		;
-	end
+    ;
+  end
 end
 
 end # module Services

data/lib/pantheios/services/simple_console_log_service.rb

@@ -1,4 +1,4 @@
-
+# frozen_string_literal: true
 # ######################################################################## #
 # File:         lib/pantheios/services/simple_console_log_service.rb
 #
@@ -6,14 +6,14 @@
 #               ::Pantheios::Services::SimpleConsoleLogService class
 #
 # Created:      14th June 2015
-# Updated:      4th June 2020
+# Updated:      28th August 2026
 #
-# Home:         http://github.com/synesissoftware/Pantheios-Ruby
+# Home:         https://github.com/synesissoftware/Pantheios.Ruby
 #
 # Author:       Matthew Wilson
 #
-# Copyright (c) 2019-2020, Matthew Wilson and Synesis Information Systems
-# Copyright (c) 2015-2018, Matthew Wilson and Synesis Software
+# Copyright (c) 2019-2026, Matthew Wilson and Synesis Information Systems
+# Copyright (c) 2015-2019, Matthew Wilson and Synesis Software
 # All rights reserved.
 #
 # Redistribution and use in source and binary forms, with or without
@@ -60,27 +60,27 @@ module Services
 # +log(severity : Object, t : Time, prefix : String|Array, msg : String)+
 class SimpleConsoleLogService
 
-	def severity_logged? severity
+  def severity_logged? severity
 
-		true
-	end
+    true
+  end
 
-	def log sev, t, pref, msg
+  def log sev, t, pref, msg
 
-		stm = infer_stream sev
+    stm = infer_stream sev
 
-		stm.puts "#{pref}#{msg}"
-	end
+    stm.puts "#{pref}#{msg}"
+  end
 
-	# Overrideable method that determines which stream to write, based on a
-	# severity. This implementation always returns +$stderr+
-	#
-	# Overrides must return an object that supports the +puts(String)+
-	# method
-	def infer_stream sev
+  # Overrideable method that determines which stream to write, based on a
+  # severity. This implementation always returns +$stderr+
+  #
+  # Overrides must return an object that supports the +puts(String)+
+  # method
+  def infer_stream sev
 
-		$stderr
-	end
+    $stderr
+  end
 end # class SimpleConsoleLogService
 
 end # module Services