log_shout 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cc4cc267c8eeb16ef1f1615f57a50189549a896c2d583eb74ab0540857812146
-  data.tar.gz: 487bb3371dbf862cb701e1e5278959d722765f424c3f70832cffdef30eb577dc
+  metadata.gz: 1ea94d24d14b119d2a45952bd943d3c4fc0f19bbe3297c3f77041e9e2ad95805
+  data.tar.gz: 39f4263faad4e590ac3ff444e2edf2a61d7ca55aeb2e6460b123758249ccbc5c
 SHA512:
-  metadata.gz: e85575c4a8cb47cabd352d1104326f07fb3c15f7ec486ae64de5b61cb75182235a3889a671b598a510aa5ed9f4c7a44df5cd062a743e86c0b5cefdbc46b71ae8
-  data.tar.gz: b45d29c88b91d0bacae4f55ce5864dd630847a544e680b6319bbf6b37c4a5c71c06a3ab412f3c4baefe61cf80c4e60486baad3455fd72319769158accb64abca
+  metadata.gz: aa7024d62547b37076b0f38eb355631fbcfc7c74d9e201b4392944dc7947277df192634f94c8d56938a129b9b68cd3116ce3fd3d3a33c9fc8990b5450c49130d
+  data.tar.gz: 0fcd3d043f3f33d978a9bf7cf9746a65a087954c4598f0341e6a4f464fdb6bdb211611e0342cb2eed78b156f4b64faceabf8277a550e8a089de4993a94836ac7

data/CHANGELOG.md

@@ -1,8 +1,19 @@
 # Changelog
 
-## 0.1.0 (unreleased)
+## 0.1.1 (2026-10-24)
 
-Initial release candidate:
+- Continue delivering messages to healthy destinations when another destination fails.
+- Attempt every destination during flush and shutdown; report multiple failures through
+  `LogShout::HandlerErrors#errors`, preserving the original exception for a single failure.
+- Recover from failed workers when installing a replacement configuration, reporting
+  every old worker failure to stderr.
+- Initialize configuration when starting a logging job after `reset!`.
+- Accept symbol names when starting logging Ractors.
+- Report invalid configuration handler and logger names as `LogShoutError`.
+
+## 0.1.0 (2026-10-24)
+
+Initial release:
 
 - Fan out Ruby Logger messages to stdout, stderr, files, and memory through Ractors.
 - Configure named loggers and shared destinations with YAML.

data/README.md

@@ -151,6 +151,12 @@ currently no backpressure, rotation, retry, or delivery guarantee after failure.
 Destinations are opened during configuration. If opening or writing fails,
 `Ractor::RemoteError` is raised by initialization or the next synchronous
 `flush`, `read`, or `close`; its `cause` contains the underlying IO exception.
+When several destinations fail during a write, flush, or shutdown,
+`LogShout::HandlerErrors` contains every original exception in its `errors`
+array. Its message includes every failure and its underlying cause. A single
+failure still raises the original exception directly. Ruby Logger may catch
+write exceptions and print their messages; call `LogShout.flush` explicitly
+to handle worker failures in application code.
 A failed worker wakes waiting callers. A live worker blocked in operating-system
 IO can still block a flush or shutdown; no IO timeout is imposed. Ruby Logger
 may report immediate write errors to stderr instead of propagating them, so use
@@ -165,9 +171,13 @@ application exception. For reliable delivery, explicitly stop producers and call
 `LogShout.configure(path: ...)` validates and opens the replacement destinations,
 drains and closes the previous handlers, and clears the logger cache. Invalid
 configuration or an opening failure preserves the current configuration.
+If an old worker has failed, reconfiguration reports its error to stderr and
+installs the healthy replacement configuration. Writes and flushes attempt every
+destination before reporting all failures, so a failed destination does
+not prevent delivery to the remaining destinations.
 `LogShout.reset!` closes handlers and clears configuration; the next `get_logger`
-loads configuration again. Stop and join background jobs before reconfiguring,
-resetting, or closing. Discard old logger references and fetch fresh ones after
+or `LoggingRactor.start` loads configuration again. Stop and join background jobs
+before reconfiguring, resetting, or closing. Discard old logger references and fetch fresh ones after
 reconfiguration. Configuration changes are intended for the main Ractor while
 producers are stopped; concurrent reconfiguration is unsupported.
 

data/lib/log_shout/logging_ractor.rb

@@ -8,7 +8,7 @@ module LogShout
       handlers = LogShout.get_handlers_for(name).freeze
       level = ::Logger.const_get(LogShout.get_level_for_name(name).upcase)
       logdev = LogShout::MultiIO.new(handlers)
-      r = Ractor.new(level, logdev, args, name: name) do |level, logdev, a|
+      r = Ractor.new(level, logdev, args, name: name.to_s) do |level, logdev, a|
         logger = ::Logger.new(logdev,
           level: level,
           progname: Ractor.current.name,

data/lib/log_shout/multi_io.rb

@@ -7,7 +7,7 @@ module LogShout
     end
 
     def write(message)
-      @targets.each { |t| t.write(message) }
+      each_target { |target| target.write(message) }
       nil
     end
 
@@ -18,8 +18,8 @@ module LogShout
     end
 
     def flush(wait_for_flush = true)
-      @targets.each do |t|
-        t.flush(wait_for_flush)
+      each_target do |target|
+        target.flush(wait_for_flush)
       end
       nil
     end
@@ -32,5 +32,18 @@ module LogShout
       end
       nil
     end
+
+    private
+
+    # Report failures after giving every destination a chance to process the call.
+    def each_target
+      errors = []
+      @targets.each do |target|
+        yield target
+      rescue => e
+        errors << e
+      end
+      HandlerErrors.raise_if_any(errors)
+    end
   end
 end

data/lib/log_shout/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LogShout
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/log_shout.rb

@@ -15,6 +15,25 @@ require "log_shout/formatters/default"
 module LogShout
   class LogShoutError < StandardError; end
 
+  class HandlerErrors < LogShoutError
+    attr_reader :errors
+
+    def initialize(errors)
+      @errors = errors.flat_map { |error| error.is_a?(HandlerErrors) ? error.errors : [error] }.freeze
+      details = @errors.map do |error|
+        detail = "#{error.class}: #{error.message}"
+        detail += " (#{error.cause.class}: #{error.cause.message})" if error.cause
+        detail
+      end
+      super("#{@errors.length} handler failures: #{details.join("; ")}")
+    end
+
+    def self.raise_if_any(errors)
+      raise errors.first if errors.length == 1
+      raise new(errors) unless errors.empty?
+    end
+  end
+
   # Replace the Sorbet enum with a plain Ruby value-object enum
   class LogDestination
     attr_reader :name
@@ -144,9 +163,17 @@ module LogShout
     handlers = build_handlers(validated_config)
     begin
       close_handlers
-    rescue
-      handlers.each_value(&:close)
-      raise
+    rescue => e
+      errors = e.is_a?(HandlerErrors) ? e.errors : [e]
+      if errors.all? { |error| error.is_a?(Ractor::RemoteError) }
+        # Every old destination has been closed; report each failed worker.
+        errors.each do |error|
+          warn "LogShout replaced failed handlers: #{error.cause.class}: #{error.cause.message}"
+        end
+      else
+        handlers.each_value(&:close)
+        raise
+      end
     end
     @config_file_path = config_file_path
     @validated_config = validated_config
@@ -183,6 +210,7 @@ module LogShout
     default_handler_names = config.fetch(:defaultHandlers, ["stdout"])
     raise LogShoutError, "defaultHandlers must be an array" unless default_handler_names.is_a?(Array)
     extra_handlers = config.fetch(:extraHandlers, {}).each_with_object({}) do |(name, config), obj|
+      name = configuration_name(name, "handler")
       if name === :stdout || name === :stderr
         raise LogShoutError, "Cannot override built-in handler: #{name}"
       end
@@ -205,17 +233,20 @@ module LogShout
       obj[name.to_sym] = handler
     end
     default_handlers = default_handler_names.map do |name|
-      BUILTIN_HANDLERS[name.to_sym] || extra_handlers[name.to_sym] || (raise LogShoutError, "Unknown handler: #{name}")
+      name = configuration_name(name, "handler")
+      BUILTIN_HANDLERS[name] || extra_handlers[name] || (raise LogShoutError, "Unknown handler: #{name}")
     end
 
     loggers = config.fetch(:loggers, {}).each_with_object({}) do |(name, config), obj|
+      name = configuration_name(name, "logger")
       raise LogShoutError, "Logger #{name} must be a mapping" unless config.is_a?(Hash)
       level = config.fetch(:level, default_level)
       validate_level(level)
       handler_names = config.fetch(:handlers, default_handler_names)
       raise LogShoutError, "Logger #{name} handlers must be an array" unless handler_names.is_a?(Array)
       handlers = handler_names.map do |name|
-        BUILTIN_HANDLERS[name.to_sym] || extra_handlers[name.to_sym] || (raise LogShoutError, "Unknown handler: #{name}")
+        name = configuration_name(name, "handler")
+        BUILTIN_HANDLERS[name] || extra_handlers[name] || (raise LogShoutError, "Unknown handler: #{name}")
       end
       obj[name.to_sym] = LogConfig.new(level: level, handlers: handlers)
     end
@@ -235,11 +266,20 @@ module LogShout
   end
   private_class_method :validate_level
 
+  def self.configuration_name(name, kind)
+    unless name.is_a?(String) || name.is_a?(Symbol)
+      raise LogShoutError, "Invalid #{kind} name: #{name.inspect}; expected a string or symbol"
+    end
+    name.to_sym
+  end
+  private_class_method :configuration_name
+
   def self.get_handler(name)
     @handlers[name]
   end
 
   def self.get_handlers_for(logger_name)
+    configure unless @handlers
     config = configuration[:loggers].fetch(
       logger_name.to_sym,
       {
@@ -254,19 +294,17 @@ module LogShout
 
   def self.flush
     return unless @handlers
-    @handlers.each_value do |handler|
-      handler.flush
-    end
+    MultiIO.new(@handlers.values).flush
   end
 
   def self.close_handlers
-    error = nil
+    errors = []
     (@handlers || {}).each_value do |handler|
       handler.close
     rescue => e
-      error ||= e
+      errors << e
     end
-    raise error if error
+    HandlerErrors.raise_if_any(errors)
     nil
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: log_shout
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Matt Christen