rails_semantic_logger 4.20.0 → 5.0.0

data/lib/rails_semantic_logger.rb

@@ -27,18 +27,93 @@ module RailsSemanticLogger
     autoload :Logger, "rails_semantic_logger/rack/logger"
   end
 
-  module DelayedJob
-    autoload :Plugin, "rails_semantic_logger/delayed_job/plugin"
-  end
-
   module Sidekiq
     autoload :Defaults, "rails_semantic_logger/sidekiq/defaults"
     autoload :JobLogger, "rails_semantic_logger/sidekiq/job_logger"
     autoload :Loggable, "rails_semantic_logger/sidekiq/loggable"
   end
 
+  module SolidQueue
+    autoload :LogSubscriber, "rails_semantic_logger/solid_queue/log_subscriber"
+  end
+
+  autoload :Appenders, "rails_semantic_logger/appenders"
   autoload :Options, "rails_semantic_logger/options"
 
+  # Deprecator used for options that are being phased out in favor of declaring
+  # appenders directly (see RailsSemanticLogger::Appenders).
+  def self.deprecator
+    @deprecator ||= ActiveSupport::Deprecation.new("6.0", "rails_semantic_logger")
+  end
+
+  # Warn that a setting was changed too late to take effect, so the change has no
+  # effect. When `config_initializers_too_late` is true (the default), the setting
+  # is consumed while the logger is built, *before* `config/initializers/*` is
+  # loaded, so that location is called out as too late. When false, the setting is
+  # consumed at the end of initialization (`config/initializers/*` still works) and
+  # only a change after the application has booted is too late.
+  def self.warn_initialized_too_late(setting, config_initializers_too_late: true)
+    env       = defined?(Rails) && Rails.respond_to?(:env) ? Rails.env : "<env>"
+    locations = "`config/application.rb` or `config/environments/#{env}.rb`"
+    locations += " (or a `config/initializers/*` file)" unless config_initializers_too_late
+    suffix    = config_initializers_too_late ? "; `config/initializers/*` is loaded too late." : "."
+    warn(
+      "[rails_semantic_logger] `config.rails_semantic_logger.#{setting}` was set too late to take " \
+      "effect, so it has no effect. Set it in #{locations}#{suffix}"
+    )
+  end
+
+  # Create the appenders declared via `config.rails_semantic_logger.appenders` with
+  # `add_server` (or the default console appender when the application declared no
+  # appenders of its own).
+  #
+  # Called automatically for the server contexts that have a first-party hook
+  # (`rails server`, Sidekiq in server mode). App servers without such a hook (bare
+  # puma, rackup, Passenger, Unicorn) cannot be detected reliably, so call this from
+  # the server's own definitive boot hook instead of relying on a guess. Example,
+  # in `config/puma.rb`:
+  #
+  #   on_booted { RailsSemanticLogger.add_server_appenders }
+  def self.add_server_appenders
+    options = Rails.application.config.rails_semantic_logger
+    # Backward compatibility
+    if !options.appenders? && options.console_logger && !SemanticLogger.appenders.console_output?
+      SemanticLogger.add_appender(io: $stdout, formatter: :color)
+    end
+
+    options.appenders.server.each do |args, block|
+      SemanticLogger.add_appender(**args, &block)
+    end
+  end
+
+  # Console (REPL) counterpart of .add_server_appenders, used by the `rails console`
+  # hook. When the application declared its own appenders, its `add_console`
+  # declarations apply; otherwise the deprecated `console_logger` toggle decides
+  # whether the default stderr console appender is added.
+  def self.add_console_appenders
+    options = Rails.application.config.rails_semantic_logger
+    # Backward compatibility: honor the deprecated console_logger toggle.
+    if !options.appenders? && options.console_logger && !SemanticLogger.appenders.console_output?
+      SemanticLogger.add_appender(io: $stderr, formatter: :color)
+    end
+
+    options.appenders.console.each do |args, block|
+      SemanticLogger.add_appender(**args, &block)
+    end
+  end
+
+  # Create each appender declared via `config.rails_semantic_logger.appenders`.
+  # The first file appender (if any) becomes the internal logger, so that any
+  # failures writing to other appenders are still recorded somewhere durable.
+  def self.add_appenders(appenders)
+    internal_logger = nil
+    appenders.each do |args, block|
+      appender = SemanticLogger.add_appender(**args, &block)
+      internal_logger ||= appender if appender.is_a?(SemanticLogger::Appender::File)
+    end
+    SemanticLogger::Processor.logger = internal_logger if internal_logger
+  end
+
   # Swap an existing subscriber with a new one
   def self.swap_subscriber(old_class, new_class, notifier)
     subscribers = ActiveSupport::LogSubscriber.subscribers.select { |s| s.is_a?(old_class) }
@@ -60,19 +135,11 @@ module RailsSemanticLogger
   end
 
   def self.subscriber_patterns(subscriber)
-    if subscriber.patterns.respond_to?(:keys)
-      subscriber.patterns.keys
-    else
-      subscriber.patterns
-    end
+    subscriber.patterns.keys
   end
 
   def self.listeners_for(notifier, pattern)
-    if notifier.respond_to?(:all_listeners_for) # Rails >= 7.1
-      notifier.all_listeners_for(pattern)
-    else
-      notifier.listeners_for(pattern)
-    end
+    notifier.all_listeners_for(pattern)
   end
 
   private_class_method :listeners_for, :subscriber_patterns, :unattach
@@ -80,15 +147,3 @@ end
 
 require("rails_semantic_logger/extensions/mongoid/config") if defined?(Mongoid)
 require("rails_semantic_logger/extensions/active_support/logger") if defined?(ActiveSupport::Logger)
-require("rails_semantic_logger/extensions/active_support/log_subscriber") if defined?(ActiveSupport::LogSubscriber)
-
-begin
-  require "rackup"
-rescue LoadError
-  # No need to do anything, will fall back to Rack
-end
-if defined?(Rackup::Server)
-  require("rails_semantic_logger/extensions/rackup/server")
-elsif defined?(Rack::Server)
-  require("rails_semantic_logger/extensions/rack/server")
-end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: rails_semantic_logger
 version: !ruby/object:Gem::Version
-  version: 4.20.0
+  version: 5.0.0
 platform: ruby
 authors:
 - Reid Morrison
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-10 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -30,30 +29,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.1'
+        version: '7.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '5.1'
+        version: '7.2'
 - !ruby/object:Gem::Dependency
   name: semantic_logger
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '4.16'
+        version: '5.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '4.16'
-description:
-email:
+        version: '5.0'
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -67,7 +64,7 @@ files:
 - lib/rails_semantic_logger/action_view/log_subscriber.rb
 - lib/rails_semantic_logger/active_job/log_subscriber.rb
 - lib/rails_semantic_logger/active_record/log_subscriber.rb
-- lib/rails_semantic_logger/delayed_job/plugin.rb
+- lib/rails_semantic_logger/appenders.rb
 - lib/rails_semantic_logger/engine.rb
 - lib/rails_semantic_logger/extensions/action_cable/tagged_logger_proxy.rb
 - lib/rails_semantic_logger/extensions/action_controller/live.rb
@@ -75,12 +72,9 @@ files:
 - lib/rails_semantic_logger/extensions/action_view/streaming_template_renderer.rb
 - lib/rails_semantic_logger/extensions/active_job/logging.rb
 - lib/rails_semantic_logger/extensions/active_model_serializers/logging.rb
-- lib/rails_semantic_logger/extensions/active_support/log_subscriber.rb
 - lib/rails_semantic_logger/extensions/active_support/logger.rb
 - lib/rails_semantic_logger/extensions/active_support/tagged_logging.rb
 - lib/rails_semantic_logger/extensions/mongoid/config.rb
-- lib/rails_semantic_logger/extensions/rack/server.rb
-- lib/rails_semantic_logger/extensions/rackup/server.rb
 - lib/rails_semantic_logger/extensions/rails/server.rb
 - lib/rails_semantic_logger/extensions/sidekiq/sidekiq.rb
 - lib/rails_semantic_logger/options.rb
@@ -88,6 +82,7 @@ files:
 - lib/rails_semantic_logger/sidekiq/defaults.rb
 - lib/rails_semantic_logger/sidekiq/job_logger.rb
 - lib/rails_semantic_logger/sidekiq/loggable.rb
+- lib/rails_semantic_logger/solid_queue/log_subscriber.rb
 - lib/rails_semantic_logger/version.rb
 homepage: https://logger.rocketjob.io
 licenses:
@@ -95,9 +90,8 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/reidmorrison/rails_semantic_logger/issues
   documentation_uri: https://logger.rocketjob.io
-  source_code_uri: https://github.com/reidmorrison/rails_semantic_logger/tree/v4.20.0
+  source_code_uri: https://github.com/reidmorrison/rails_semantic_logger/tree/v5.0.0
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -105,15 +99,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.19
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
-summary: Feature rich logging framework that replaces the Rails logger.
+summary: High-performance, asynchronous structured logging that replaces the Rails
+  logger.
 test_files: []

data/lib/rails_semantic_logger/delayed_job/plugin.rb

@@ -1,11 +0,0 @@
-module RailsSemanticLogger
-  module DelayedJob
-    class Plugin < Delayed::Plugin
-      callbacks do |lifecycle|
-        lifecycle.before(:execute) do |_job|
-          ::SemanticLogger.reopen
-        end
-      end
-    end
-  end
-end

data/lib/rails_semantic_logger/extensions/active_support/log_subscriber.rb

@@ -1,13 +0,0 @@
-if ActiveSupport::VERSION::STRING == "7.1.1"
-  require "active_support/log_subscriber"
-
-  module ActiveSupport
-    class LogSubscriber
-      # @override Rails 7.1
-      def silenced?(event)
-        native_log_level = @event_levels.fetch(event, ::Logger::Severity::FATAL)
-        logger.nil? || SemanticLogger::Levels.index(logger.level) > SemanticLogger::Levels.index(native_log_level)
-      end
-    end
-  end
-end

data/lib/rails_semantic_logger/extensions/rack/server.rb

@@ -1,12 +0,0 @@
-module RailsSemanticLogger
-  module Rack
-    module Server
-      def daemonize_app
-        super
-        SemanticLogger.reopen
-      end
-    end
-  end
-end
-
-Rack::Server.prepend(RailsSemanticLogger::Rack::Server)

data/lib/rails_semantic_logger/extensions/rackup/server.rb

@@ -1,12 +0,0 @@
-module RailsSemanticLogger
-  module Rackup
-    module Server
-      def daemonize_app
-        super
-        SemanticLogger.reopen
-      end
-    end
-  end
-end
-
-Rackup::Server.prepend(RailsSemanticLogger::Rackup::Server)