loglevel 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1505dc964fe83a014f6d4fe8aacfcbb233719374
-  data.tar.gz: b85714e7f5ed83aa6e1c406e98406bc3e46c7ace
+  metadata.gz: 27d935b0bba808acac6f2dc481350410698cb44d
+  data.tar.gz: 1434b05ae0a081a45df1dfb0b62f7f3d10ce0100
 SHA512:
-  metadata.gz: 71c930051600a6b5a8643a7860921ac2e6b1dbfac260f08b88a9574b7bf31878d28a31b0e2f0bd2f0a4894d36afd475bbf55a27db270c354c74708f3d005d90d
-  data.tar.gz: 7d0b79417fde7f52badc0150a31db0df9c65f5735510743dd8135cab5719bc33ca70461185ae8e1c298bfe3919ad63c4fe3d32ff9147863d1c829ac13458d195
+  metadata.gz: 5000a19490bec0ecad39c9f1b9347b695118db51d077f5961b39a6425cc4da7c3053e9bc441335d446d3b162c9a74bab26b9e0f5a4f045e966167ddb378317db
+  data.tar.gz: 3e84eb62bbfb745a499ccedf45eb5e2bb2e1b76861602f74433de3401b309db4dc76e30061e06da30535d07e8fcc38bcc7a60959cf88ece4de7d135f6ae2727a

data/README.md

@@ -58,9 +58,31 @@ There are specific options to handle Railsy logging scenarios: things like
 controlling ActiveRecord logging. There are also specific options for handling
 the HttpLogger gem.
 
+### Rails initialization
+
+In a Rails context, we want Loglevel to be configured *after* Rails's own logger
+has been initialized but before any other app initialization has taken place.
+This allows us to control the logging of other components' initialization.
+
+The best way I have found of doing this is to create a script in the
+`config/initializers` directory. These initializers are executed in alphabetical
+order so you can control when Loglevel is initialized by carefully naming your
+script.
+
+To initialize Loglevel first, create a script called `01_loglevel.rb` with the
+single line
+
+```
+Loglevel.setup
+```
+
+To understand which other points in the Rails initialization process you can
+choose, see [The Rails Initialization Process](http://guides.rubyonrails.org/initialization.html).
+
 ### Logger
 
-By default Loglevel will instantiate Ruby's default Logger class. If you want to
+By default Loglevel will instantiate Ruby's default Logger class (in a Rails
+context this will be something like ActiveSupport::TaggedLogging). If you want to
 use a different logger then you can use an environment variable to tell Loglevel
 which logger you use:
 

data/lib/loglevel.rb

@@ -1,3 +1,4 @@
+require 'loglevel/exception'
 require 'loglevel/classes'
 require 'loglevel/active_record'
 require 'loglevel/http_logger'
@@ -79,7 +80,17 @@ class Loglevel
   end
 
   def logger_class
-    Object.const_get ENV.fetch(ENV_VAR_LOGGER, 'Logger')
+    Object.const_get logger_class_name
+  rescue NameError => e
+    fail Loglevel::Exception::BadLoggerClass, "Can't find logger class #{logger_class_name} - have you required it?"
+  end
+
+  def logger_class_name
+    @logger_class_name ||= ENV.fetch(ENV_VAR_LOGGER, logger_class_name_default)
+  end
+
+  def logger_class_name_default
+    @logger_class_default ||= defined?(::Rails) && ::Rails.logger ? ::Rails.logger.class.name : 'Logger'
   end
 
   def device

data/lib/loglevel/exception.rb

@@ -0,0 +1,6 @@
+class Loglevel
+  # Local exception classes to make handling exceptions easier
+  class Exception < RuntimeError
+    BadLoggerClass = Class.new(self)
+  end
+end

data/lib/loglevel/help.rb

@@ -29,8 +29,8 @@ class Loglevel
       debug = classes.map do |klass|
         l = klass.logger || Struct.new(:level).new(0)
         d = l.instance_variable_get('@logdev') || Struct.new(:filename, :dev).new
-        f = d.filename || d.dev || 'nil'
-        v = self.class::LOGLEVELS[l.level]
+        f = d.filename || d.dev.inspect || 'nil'
+        v = l.level.is_a?(0.class) ? self.class::LOGLEVELS[l.level] : 'nil'
         "#{klass}: logger=#{l.class}, device=#{f}, level=#{v}"
       end
 

data/lib/loglevel/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 class Loglevel
-  VERSION = '0.3.0'.freeze
+  VERSION = '0.4.0'.freeze
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: loglevel
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Dominic Sayers
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-04-05 00:00:00.000000000 Z
+date: 2017-04-10 00:00:00.000000000 Z
 dependencies: []
 description: A simple gem to control logging at runtime with an environment variable
 email:
@@ -34,6 +34,7 @@ files:
 - lib/loglevel.rb
 - lib/loglevel/active_record.rb
 - lib/loglevel/classes.rb
+- lib/loglevel/exception.rb
 - lib/loglevel/help.rb
 - lib/loglevel/http_logger.rb
 - lib/loglevel/version.rb