semantic_logger 4.6.0.beta1 → 4.7.2

data/lib/semantic_logger/semantic_logger.rb

@@ -1,5 +1,5 @@
-require 'concurrent'
-require 'socket'
+require "concurrent"
+require "socket"
 
 module SemanticLogger
   # Logging levels in order of most detailed to most severe
@@ -52,7 +52,7 @@ module SemanticLogger
   # Returns [String] name of this host for logging purposes
   # Note: Not all appenders use `host`
   def self.host
-    @host ||= Socket.gethostname.force_encoding('UTF-8')
+    @host ||= Socket.gethostname.force_encoding("UTF-8")
   end
 
   # Override the default host name
@@ -82,8 +82,8 @@ module SemanticLogger
     @environment = environment
   end
 
-  @application = ENV['SEMANTIC_LOGGER_APP'] || 'Semantic Logger'
-  @environment = ENV['SEMANTIC_LOGGER_ENV'] || ENV['RAILS_ENV'] || ENV['RACK_ENV']
+  @application = ENV["SEMANTIC_LOGGER_APP"] || "Semantic Logger"
+  @environment = ENV["SEMANTIC_LOGGER_ENV"] || ENV["RAILS_ENV"] || ENV["RACK_ENV"]
 
   # Add a new logging appender as a new destination for all log messages
   # emitted from Semantic Logger
@@ -268,22 +268,23 @@ module SemanticLogger
   # Note:
   #   To only register one of the signal handlers, set the other to nil
   #   Set gc_log_microseconds to nil to not enable JRuby Garbage collections
-  def self.add_signal_handler(log_level_signal = 'USR2', thread_dump_signal = 'TTIN', gc_log_microseconds = 100_000)
+  def self.add_signal_handler(log_level_signal = "USR2", thread_dump_signal = "TTIN", gc_log_microseconds = 100_000)
     if log_level_signal
       Signal.trap(log_level_signal) do
         index     = default_level == :trace ? LEVELS.find_index(:error) : LEVELS.find_index(default_level)
         new_level = LEVELS[index - 1]
-        self['SemanticLogger'].warn "Changed global default log level to #{new_level.inspect}"
+        self["SemanticLogger"].warn "Changed global default log level to #{new_level.inspect}"
         self.default_level = new_level
       end
     end
 
     if thread_dump_signal
       Signal.trap(thread_dump_signal) do
-        logger = SemanticLogger['Thread Dump']
+        logger = SemanticLogger["Thread Dump"]
         Thread.list.each do |thread|
           # MRI re-uses the main thread for signals, JRuby uses `SIGTTIN handler` thread.
           next if defined?(JRuby) && (thread == Thread.current)
+
           logger.backtrace(thread: thread)
         end
       end
@@ -302,7 +303,7 @@ module SemanticLogger
   # If the tag being supplied is definitely a string then this fast
   # tag api can be used for short lived tags
   def self.fast_tag(tag)
-    return yield if tag.nil? || tag == ''
+    return yield if tag.nil? || tag == ""
 
     t = Thread.current[:semantic_logger_tags] ||= []
     begin
@@ -379,7 +380,7 @@ module SemanticLogger
   # :nodoc
   def self.named_tagged(hash)
     return yield if hash.nil? || hash.empty?
-    raise(ArgumentError, '#named_tagged only accepts named parameters (Hash)') unless hash.is_a?(Hash)
+    raise(ArgumentError, "#named_tagged only accepts named parameters (Hash)") unless hash.is_a?(Hash)
 
     begin
       push_named_tags(hash)
@@ -488,11 +489,23 @@ module SemanticLogger
     Thread.current[:semantic_logger_silence] || @default_level_index
   end
 
-  private
+  # 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.
+  def self.sync!
+    @sync = true
+  end
+
+  # Running in synchronous mode?
+  def self.sync?
+    @sync
+  end
 
   # Initial default Level for all new instances of SemanticLogger::Logger
   @default_level         = :info
   @default_level_index   = Levels.index(@default_level)
   @backtrace_level       = :error
   @backtrace_level_index = Levels.index(@backtrace_level)
+  @sync                  = false
 end

data/lib/semantic_logger/subscriber.rb

@@ -45,11 +45,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

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,43 @@
+module SemanticLogger
+  # Thread that submits and processes log requests
+  class SyncProcessor
+    extend Forwardable
+
+    # Forward methods that can be called directly
+    def_delegator :@appenders, :add
+    def_delegator :@appenders, :log
+    def_delegator :@appenders, :flush
+    def_delegator :@appenders, :close
+    def_delegator :@appenders, :reopen
+
+    # 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::File.new(io: STDERR, level: :warn)
+          l.name = name
+          l
+        end
+    end
+
+    attr_reader :appenders
+
+    def initialize
+      @appenders = Appenders.new(self.class.logger.dup)
+    end
+
+    def start
+      # NOP
+    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,7 +32,7 @@ module SemanticLogger
       end
     end
 
-    SELF_PATTERN = File.join('lib', 'semantic_logger')
+    SELF_PATTERN = File.join("lib", "semantic_logger")
 
     # Extract the backtrace leaving out the last few Semantic Logger lines.
     def self.extract_backtrace(stack = caller)
@@ -50,11 +50,11 @@ module SemanticLogger
       stack
     end
 
-    GEM_ROOT = File.expand_path('../../..', __dir__) + '/'
+    GEM_ROOT = File.expand_path("../../..", __dir__) + "/"
 
     def self.system_path?(path)
       path.start_with?(GEM_ROOT) ||
-        path.start_with?(RbConfig::CONFIG['rubylibdir'])
+        path.start_with?(RbConfig::CONFIG["rubylibdir"])
     end
   end
 end

data/lib/semantic_logger/version.rb

@@ -1,3 +1,3 @@
 module SemanticLogger
-  VERSION = '4.6.0.beta1'.freeze
+  VERSION = "4.7.2".freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: semantic_logger
 version: !ruby/object:Gem::Version
-  version: 4.6.0.beta1
+  version: 4.7.2
 platform: ruby
 authors:
 - Reid Morrison
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-05-13 00:00:00.000000000 Z
+date: 2020-08-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -85,6 +85,8 @@ 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/utils.rb
 - lib/semantic_logger/version.rb
 homepage: https://github.com/rocketjob/semantic_logger
@@ -102,11 +104,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '2.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Feature rich logging framework, and replacement for existing Ruby & Rails