semantic_logger 4.5.0 → 4.12.0

data/lib/semantic_logger/subscriber.rb

@@ -5,7 +5,7 @@ module SemanticLogger
   class Subscriber < SemanticLogger::Base
     # Every appender has its own formatter
     attr_reader :formatter
-    attr_writer :application, :host, :logger, :metrics
+    attr_writer :application, :environment, :host, :logger, :metrics
 
     # Returns the current log level if set, otherwise it logs everything it receives.
     def level
@@ -22,6 +22,11 @@ module SemanticLogger
       # NOOP
     end
 
+    # Method called to log an event
+    def log(log)
+      raise NotImplementedError
+    end
+
     # Returns [SemanticLogger::Formatters::Default] default formatter for this subscriber.
     def default_formatter
       SemanticLogger::Formatters::Default.new
@@ -32,6 +37,11 @@ module SemanticLogger
       @application || SemanticLogger.application
     end
 
+    # Allow environment name to be set globally or on a per subscriber basis.
+    def environment
+      @environment || SemanticLogger.environment
+    end
+
     # Allow host name to be set globally or on a per subscriber basis.
     def host
       @host || SemanticLogger.host
@@ -40,11 +50,12 @@ module SemanticLogger
     # Give each appender its own logger for logging.
     # For example trace messages sent to services or errors when something fails.
     def logger
-      @logger ||= begin
-        logger      = SemanticLogger::Processor.logger.clone
-        logger.name = self.class.name
-        logger
-      end
+      @logger ||=
+        begin
+          logger      = SemanticLogger::Processor.logger.clone
+          logger.name = self.class.name
+          logger
+        end
     end
 
     # Set the formatter from Symbol|Hash|Block
@@ -62,6 +73,11 @@ module SemanticLogger
       super(log) && (log.metric_only? ? metrics? : true)
     end
 
+    # Whether this appender is logging to stdout or stderror
+    def console_output?
+      false
+    end
+
     private
 
     # Initializer for Abstract Class SemanticLogger::Subscriber
@@ -92,9 +108,10 @@ module SemanticLogger
     #   metrics: [Boolean]
     #     Whether to log metric only entries with this subscriber.
     #     Default: false
-    def initialize(level: nil, formatter: nil, filter: nil, application: nil, host: nil, metrics: false, &block)
+    def initialize(level: nil, formatter: nil, filter: nil, application: nil, environment: nil, host: nil, metrics: false, &block)
       self.formatter = block || formatter
       @application   = application
+      @environment   = environment
       @host          = host
       @metrics       = metrics
 

data/lib/semantic_logger/sync.rb

@@ -0,0 +1,12 @@
+# Run Semantic Logger in Synchronous mode.
+#
+# I.e. Instead of logging messages in a separate thread for better performance,
+# log them using the current thread.
+#
+# Usage:
+#   require "semantic_logger/sync"
+#
+# Or, when using a Gemfile:
+#   gem "semantic_logger", require: "semantic_logger/sync"
+require "semantic_logger"
+SemanticLogger.sync!

data/lib/semantic_logger/sync_processor.rb

@@ -0,0 +1,58 @@
+module SemanticLogger
+  # The SyncProcessor performs logging in the current thread.
+  #
+  # Appenders are designed to only be used by one thread at a time, so all calls
+  # are mutex protected in case SyncProcessor is being used in a multi-threaded environment.
+  class SyncProcessor
+    def add(*args, &block)
+      @mutex.synchronize { @appenders.add(*args, &block) }
+    end
+
+    def log(*args, &block)
+      @mutex.synchronize { @appenders.log(*args, &block) }
+    end
+
+    def flush
+      @mutex.synchronize { @appenders.flush }
+    end
+
+    def close
+      @mutex.synchronize { @appenders.close }
+    end
+
+    def reopen(*args)
+      @mutex.synchronize { @appenders.reopen(*args) }
+    end
+
+    # Allow the internal logger to be overridden from its default of $stderr
+    #   Can be replaced with another Ruby logger or Rails logger, but never to
+    #   SemanticLogger::Logger itself since it is for reporting problems
+    #   while trying to log to the various appenders
+    class << self
+      attr_writer :logger
+    end
+
+    # Internal logger for SemanticLogger
+    #   For example when an appender is not working etc..
+    #   By default logs to $stderr
+    def self.logger
+      @logger ||=
+        begin
+          l      = SemanticLogger::Appender::IO.new($stderr, level: :warn)
+          l.name = name
+          l
+        end
+    end
+
+    attr_reader :appenders
+
+    def initialize(appenders = nil)
+      @mutex     = Mutex.new
+      @appenders = appenders || Appenders.new(self.class.logger.dup)
+    end
+
+    def start
+      # NOP
+    end
+  end
+end

data/lib/semantic_logger/test/capture_log_events.rb

@@ -0,0 +1,34 @@
+module SemanticLogger
+  module Test
+    # Logging class to captures all logging events in memory.
+    #
+    # Example:
+    #
+    # class UserTest < ActiveSupport::TestCase
+    #   describe User do
+    #     let(:capture_logger) { SemanticLogger::Test::CaptureLogEvents.new }
+    #     let(:user) { User.new }
+    #
+    #     it "logs message" do
+    #       user.stub(:logger, capture_logger) do
+    #         user.enable!
+    #       end
+    #       assert_equal "Hello World", capture_logger.events.last.message
+    #       assert_equal :info, capture_logger.events.last.level
+    #     end
+    #   end
+    # end
+    class CaptureLogEvents < SemanticLogger::Subscriber
+      attr_accessor :events
+
+      # By default collect all log levels, and collect metric only log events.
+      def initialize(level: :trace, metrics: true)
+        super(level: level, metrics: true)
+      end
+
+      def log(log)
+        (@events ||= []) << log
+      end
+    end
+  end
+end

data/lib/semantic_logger/utils.rb

@@ -2,7 +2,7 @@ module SemanticLogger
   # Internal-use only utility functions for Semantic Logger.
   # Not intended for public use.
   module Utils
-    def self.constantize_symbol(symbol, namespace = 'SemanticLogger::Appender')
+    def self.constantize_symbol(symbol, namespace = "SemanticLogger::Appender")
       klass = "#{namespace}::#{camelize(symbol.to_s)}"
       begin
         Object.const_get(klass)
@@ -15,8 +15,8 @@ module SemanticLogger
     def self.camelize(term)
       string = term.to_s
       string = string.sub(/^[a-z\d]*/, &:capitalize)
-      string.gsub!(/(?:_|(\/))([a-z\d]*)/i) { "#{Regexp.last_match(1)}#{Regexp.last_match(2).capitalize}" }
-      string.gsub!('/'.freeze, '::'.freeze)
+      string.gsub!(%r{(?:_|(/))([a-z\d]*)}i) { "#{Regexp.last_match(1)}#{Regexp.last_match(2).capitalize}" }
+      string.gsub!("/".freeze, "::".freeze)
       string
     end
 
@@ -32,29 +32,48 @@ module SemanticLogger
       end
     end
 
-    SELF_PATTERN = File.join('lib', 'semantic_logger')
-
-    # Extract the backtrace leaving out the last few Semantic Logger lines.
+    # Extract the backtrace stripping off the leading semantic logger entries.
+    # Leaves all other system and gem path entries in place.
     def self.extract_backtrace(stack = caller)
-      while (first = stack.first) && first.include?(SELF_PATTERN)
+      while (first = stack.first) && extract_path?(first)
         stack.shift
       end
       stack
     end
 
-    # Strips off all gems and built-in ruby code paths from the top of the stack until application code is found.
+    def self.extract_paths
+      @extract_paths ||= %w[lib/semantic_logger lib/rails_semantic_logger]
+    end
+
+    # Whether this path should be excluded from any cleansed backtrace
+    def self.extract_path?(path)
+      extract_paths.any? { |exclude| path.include?(exclude) }
+    end
+
+    # Try to strip everything off of the supplied backtrace, until the first application stack entry is at the top.
+    # For example all leading gem paths and built-in ruby code paths are removed from the top.
+    # Once the first application entry is found, the remaining stack is returned.
     def self.strip_backtrace(stack = caller)
-      while (first = stack.first) && system_path?(first)
+      while (first = stack.first) && (strip_path?(first) || extract_path?(first))
         stack.shift
       end
       stack
     end
 
-    GEM_ROOT = File.expand_path('../../..', __dir__) + '/'
+    # Paths to exclude in the stripped backtrace
+    # Includes Gems and built-in Ruby code paths
+    def self.strip_paths
+      @strip_paths ||=
+        begin
+          paths = Gem.path | [Gem.default_dir]
+          paths << RbConfig::CONFIG["rubylibdir"]
+          paths
+        end
+    end
 
-    def self.system_path?(path)
-      path.start_with?(GEM_ROOT) ||
-        path.start_with?(RbConfig::CONFIG['rubylibdir'])
+    # Whether this path should be excluded from any cleansed backtrace
+    def self.strip_path?(path)
+      strip_paths.any? { |exclude| path.start_with?(exclude) }
     end
   end
 end

data/lib/semantic_logger/version.rb

@@ -1,3 +1,3 @@
 module SemanticLogger
-  VERSION = '4.5.0'.freeze
+  VERSION = "4.12.0".freeze
 end

data/lib/semantic_logger.rb

@@ -1,43 +1,48 @@
-require 'semantic_logger/core_ext/thread'
-require 'semantic_logger/version'
+require "semantic_logger/core_ext/thread"
+require "semantic_logger/version"
 
 # @formatter:off
 module SemanticLogger
-  autoload :AnsiColors,         'semantic_logger/ansi_colors'
-  autoload :Appender,           'semantic_logger/appender'
-  autoload :Appenders,          'semantic_logger/appenders'
-  autoload :Base,               'semantic_logger/base'
-  autoload :DebugAsTraceLogger, 'semantic_logger/debug_as_trace_logger'
-  autoload :Formatters,         'semantic_logger/formatters'
-  autoload :Levels,             'semantic_logger/levels'
-  autoload :Log,                'semantic_logger/log'
-  autoload :Logger,             'semantic_logger/logger'
-  autoload :Loggable,           'semantic_logger/loggable'
-  autoload :Processor,          'semantic_logger/processor'
-  autoload :Subscriber,         'semantic_logger/subscriber'
-  autoload :Utils,              'semantic_logger/utils'
+  autoload :AnsiColors,         "semantic_logger/ansi_colors"
+  autoload :Appender,           "semantic_logger/appender"
+  autoload :Appenders,          "semantic_logger/appenders"
+  autoload :Base,               "semantic_logger/base"
+  autoload :DebugAsTraceLogger, "semantic_logger/debug_as_trace_logger"
+  autoload :Formatters,         "semantic_logger/formatters"
+  autoload :Levels,             "semantic_logger/levels"
+  autoload :Log,                "semantic_logger/log"
+  autoload :Logger,             "semantic_logger/logger"
+  autoload :Loggable,           "semantic_logger/loggable"
+  autoload :Processor,          "semantic_logger/processor"
+  autoload :Subscriber,         "semantic_logger/subscriber"
+  autoload :SyncProcessor,      "semantic_logger/sync_processor"
+  autoload :Utils,              "semantic_logger/utils"
 
   module Concerns
-    autoload :Compatibility,    'semantic_logger/concerns/compatibility'
+    autoload :Compatibility, "semantic_logger/concerns/compatibility"
   end
 
   module Metric
-    autoload :NewRelic,          'semantic_logger/metric/new_relic'
-    autoload :Signalfx,          'semantic_logger/metric/signalfx'
-    autoload :Statsd,            'semantic_logger/metric/statsd'
+    autoload :NewRelic,          "semantic_logger/metric/new_relic"
+    autoload :Signalfx,          "semantic_logger/metric/signalfx"
+    autoload :Statsd,            "semantic_logger/metric/statsd"
   end
 
   module Reporters
-    autoload :Minitest,          'semantic_logger/reporters/minitest'
+    autoload :Minitest,          "semantic_logger/reporters/minitest"
+  end
+
+  module Test
+    autoload :CaptureLogEvents,  "semantic_logger/test/capture_log_events"
   end
 
   if defined?(JRuby)
     module JRuby
-      autoload :GarbageCollectionLogger, 'semantic_logger/jruby/garbage_collection_logger'
+      autoload :GarbageCollectionLogger, "semantic_logger/jruby/garbage_collection_logger"
     end
   end
 end
-require 'semantic_logger/semantic_logger'
+require "semantic_logger/semantic_logger"
 # @formatter:on
 
 # Flush all appenders at exit, waiting for outstanding messages on the queue

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: semantic_logger
 version: !ruby/object:Gem::Version
-  version: 4.5.0
+  version: 4.12.0
 platform: ruby
 authors:
 - Reid Morrison
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-02-21 00:00:00.000000000 Z
+date: 2022-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -24,9 +24,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
-description: 
+description:
 email:
-- reidmo@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -46,11 +45,13 @@ files:
 - lib/semantic_logger/appender/graylog.rb
 - lib/semantic_logger/appender/honeybadger.rb
 - lib/semantic_logger/appender/http.rb
+- lib/semantic_logger/appender/io.rb
 - lib/semantic_logger/appender/kafka.rb
 - lib/semantic_logger/appender/mongodb.rb
 - lib/semantic_logger/appender/new_relic.rb
 - lib/semantic_logger/appender/rabbitmq.rb
 - lib/semantic_logger/appender/sentry.rb
+- lib/semantic_logger/appender/sentry_ruby.rb
 - lib/semantic_logger/appender/splunk.rb
 - lib/semantic_logger/appender/splunk_http.rb
 - lib/semantic_logger/appender/syslog.rb
@@ -68,6 +69,7 @@ files:
 - lib/semantic_logger/formatters/default.rb
 - lib/semantic_logger/formatters/fluentd.rb
 - lib/semantic_logger/formatters/json.rb
+- lib/semantic_logger/formatters/logfmt.rb
 - lib/semantic_logger/formatters/one_line.rb
 - lib/semantic_logger/formatters/raw.rb
 - lib/semantic_logger/formatters/signalfx.rb
@@ -85,13 +87,16 @@ files:
 - lib/semantic_logger/reporters/minitest.rb
 - lib/semantic_logger/semantic_logger.rb
 - lib/semantic_logger/subscriber.rb
+- lib/semantic_logger/sync.rb
+- lib/semantic_logger/sync_processor.rb
+- lib/semantic_logger/test/capture_log_events.rb
 - lib/semantic_logger/utils.rb
 - lib/semantic_logger/version.rb
-homepage: https://github.com/rocketjob/semantic_logger
+homepage: https://logger.rocketjob.io
 licenses:
 - Apache-2.0
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -99,15 +104,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.3'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.2
-signing_key: 
+rubygems_version: 3.2.33
+signing_key:
 specification_version: 4
 summary: Feature rich logging framework, and replacement for existing Ruby & Rails
   loggers.