console 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fbf1eadc0f7feb035420f924a20586af9519aa49df5aedb11a4dbdd6fb74f6c4
-  data.tar.gz: 7d6d9d50f41664e74a0eb7ea7b1b176c7715915bf60e936d62ab5786855dd4c9
+  metadata.gz: 7e6e1262499d10a334cb59ca261e8999ba79d951ac1e7cfba12bccd7f89e6984
+  data.tar.gz: 640cd8f249f96f87384cd787f9949c1756bc0138e1f1da4eca5a27d5c4c4a846
 SHA512:
-  metadata.gz: f971cf07e39afd931aa72e72045bb0ac53fe6d301ce86af896947f295f3f27c8d815c124c433d1688d25f46e7f48ca004fd16d80e3abb4e79daf451292e56d2a
-  data.tar.gz: fabc30bc37fb1ea3d4ce2c54f2ca9aea101faf1484c037fea9b837ea0d7543bf9be5a56678ce3df293fa7d177747ed4caa429d968f2206d542376168b1b455d3
+  metadata.gz: 140efdbe4232fbe7ff475716b97059d119ee3a692b3e72ed5c1c3790f403e5fe2074f6265aa766d860fe329786c414cf54350083af64b42cb798fe9b534670d8
+  data.tar.gz: 517647d3daa6af74fae8f23b1738c6de23c36765e8997130a89b7e29b636e9cf33910529b08dc67d41a5462d0506ff4b9f7b78619c464efea8b41b8a83a022d1

data/README.md

@@ -31,6 +31,16 @@ Capturing structured information allows it to be used in different ways. These e
 
 Generally speaking, use `Console.logger` which is suitable for logging to the user's terminal.
 
+### Environment Variables
+
+#### `CONSOLE_LEVEL=debug`
+
+Control the default logger level. You can set it to any of the supported log levels: `debug`, `info`, `warn`, `error`, `fatal`.
+
+#### `CONSOLE_DEBUG=MyClass,MyModule::MyClass`
+
+Enable debug logging for the specified class names. You can specify one or more class names which will be resolved at runtime.
+
 ### Module Integration
 
 ```ruby
@@ -128,8 +138,8 @@ require 'console'
 
 MyLogger = Console::Filter[noise: 0, stuff: 1, broken: 2]
 
-logger = MyLogger.new(Console.logger, name: "Java")
-logger.verbose! # log severity/name/pid etc.
+# verbose: true - log severity/name/pid etc.
+logger = MyLogger.new(Console.logger, name: "Java", verbose: true)
 
 logger.broken("It's so janky.")
 ```

data/lib/console.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+#
 # Copyright, 2019, by Samuel G. D. Williams. <http://www.codeotaku.com>
 # 
 # Permission is hereby granted, free of charge, to any person obtaining a copy
@@ -26,17 +28,12 @@ module Console
 	class << self
 		attr_accessor :logger
 		
-		LEVELS = {
-			'debug' => Logger::DEBUG,
-			'info' => Logger::INFO,
-		}
-		
 		# Set the default log level based on `$DEBUG` and `$VERBOSE`.
-		# You can also specify CONSOLE_LOG_LEVEL=debug or CONSOLE_LOG_LEVEL=info in environment.
+		# You can also specify CONSOLE_LEVEL=debug or CONSOLE_LEVEL=info in environment.
 		# https://mislav.net/2011/06/ruby-verbose-mode/ has more details about how it all fits together.
 		def default_log_level(env = ENV)
-			if level = env['CONSOLE_LOG_LEVEL']
-				LEVELS[level] || Logger.warn
+			if level = (env['CONSOLE_LEVEL'] || env['CONSOLE_LOG_LEVEL'])
+				Logger::LEVELS[level.to_sym] || Logger.warn
 			elsif $DEBUG
 				Logger::DEBUG
 			elsif $VERBOSE.nil?
@@ -45,23 +42,37 @@ module Console
 				Logger::INFO
 			end
 		end
-	end
-	
-	# Create the logger instance:
-	@logger = Logger.new(
-		Terminal::Logger.new($stderr),
-		level: self.default_log_level,
-		verbose: !$VERBOSE.nil?,
-	)
-	
-	if names = ENV['CONSOLE_DEBUG']&.split(',')
-		@resolver ||= Resolver.new
 		
-		@resolver.bind(names) do |klass|
-			@logger.enable(klass, Logger::DEBUG)
+		def default_resolver(logger, env = ENV)
+			if names = env['CONSOLE_DEBUG']&.split(',')
+				resolver = Resolver.new
+				
+				resolver.bind(names) do |klass|
+					logger.enable(klass, Logger::DEBUG)
+				end
+				
+				return resolver
+			end
+		end
+		
+		# Controls verbose output using `$VERBOSE`.
+		def verbose?
+			!$VERBOSE.nil?
+		end
+		
+		def build(output, verbose: self.verbose?, level: self.default_log_level)
+			terminal = Terminal::Logger.new(output, verbose: verbose)
+			
+			logger = Logger.new(terminal, verbose: verbose, level: level)
+			
+			return logger
 		end
 	end
 	
+	# Create the logger instance:
+	@logger = self.build($stderr)
+	@resolver = self.default_resolver(@logger)
+	
 	def logger= logger
 		@logger = logger
 	end

data/lib/console/filter.rb

@@ -66,8 +66,6 @@ module Console
 			if enabled
 				enabled.each{|name| enable(name)}
 			end
-			
-			verbose!(verbose)
 		end
 		
 		def with(level: @level, verbose: @verbose, **options)

data/lib/console/version.rb

@@ -19,5 +19,5 @@
 # THE SOFTWARE.
 
 module Console
-	VERSION = "1.5.0"
+	VERSION = "1.6.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: console
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Samuel Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-10-15 00:00:00.000000000 Z
+date: 2019-11-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: covered
@@ -117,7 +117,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.4
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: Beautiful logging for Ruby.