console 1.10.0 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 640269ce4b1afa8413ce60f657ab3c3ed01a036a32e554c8643aa599a0052422
-  data.tar.gz: b5fa60cc24de752c16af2160856fe0cfe3c038f24a409e9d3069d701afbfcb9b
+  metadata.gz: '019b21198110cd3da94ef40ce3d666ea19be493e1ef2fa85e818bdd03d67e864'
+  data.tar.gz: 33994cbf5c6349aed18c79f3b20527785de1dd1c2307c49b864382750c2d807d
 SHA512:
-  metadata.gz: 78b6e1c53280b26a315a422a418f36d228a583f095b41a406a33c67808ac2c299ab33399641880d5d3b7753d0ad88262fc536deac6ddd1ef6c8edf970b7d591e
-  data.tar.gz: d24238b81168471f70c4404badf944b24f01a92101b841513cb0ced7c6998b4a63efabb88bad49c042e72c174b1c56f2cd51cf385f7814d41d709cde040e1ab3
+  metadata.gz: dc7b76666ff0f3dda0cfaf3d966f8cd00bae86d0930f34452e6dcd20dc42fac72d2ba9a7533f6dc9bf7790cdb4e1c98c97830434bc36a463ae156104c6caa657
+  data.tar.gz: 9bc0323787283b1fd20357914b1ff12eb1cd19bc20f68c7132bacf7533817829f514d5b408b5421366bf07a38265417ad3b3d93cc1984844affe5d91b0f0889c

data/lib/console.rb

@@ -20,6 +20,7 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
+require_relative 'console/version'
 require_relative 'console/logger'
 
 module Console

data/lib/console/capture.rb

@@ -33,6 +33,10 @@ module Console
 			@buffer.last
 		end
 		
+		def include?(pattern)
+			JSON.dump(@buffer).include?(pattern)
+		end
+		
 		def clear
 			@buffer.clear
 		end

data/lib/console/clock.rb

@@ -0,0 +1,50 @@
+# Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+module Console
+	module Clock
+		def self.formatted_duration(duration)
+			if duration < 60.0
+				return "#{duration.round(2)}s"
+			end
+			
+			duration /= 60.0
+			
+			if duration < 60.0
+				return "#{duration.round}m"
+			end
+			
+			duration /= 60.0
+			
+			if duration < 60.0
+				return "#{duration.round(1)}h"
+			end
+			
+			duration /= 24.0
+			
+			return "#{duration.round(1)}d"
+		end
+		
+		# Get the current elapsed monotonic time.
+		def self.now
+			::Process.clock_gettime(::Process::CLOCK_MONOTONIC)
+		end
+	end
+end

data/lib/console/event/failure.rb

@@ -47,6 +47,8 @@ module Console
 				terminal[:exception_title] ||= terminal.style(:red, nil, :bold)
 				terminal[:exception_detail] ||= terminal.style(:yellow)
 				terminal[:exception_backtrace] ||= terminal.style(:red)
+				terminal[:exception_backtrace_other] ||= terminal.style(:red, nil, :faint)
+				terminal[:exception_message] ||= terminal.style(:default)
 			end
 			
 			def to_h
@@ -66,13 +68,18 @@ module Console
 					output.puts "  #{terminal[:exception_detail]}#{line}#{terminal.reset}"
 				end
 				
+				root_pattern = /^#{@root}\// if @root
+				
 				exception.backtrace&.each_with_index do |line, index|
 					path, offset, message = line.split(":")
+					style = :exception_backtrace
 					
 					# Make the path a bit more readable
-					path.gsub!(/^#{@root}\//, "./") if @root
+					if root_pattern and path.sub!(root_pattern, "").nil?
+						style = :exception_backtrace_other
+					end
 					
-					output.puts "  #{index == 0 ? "→" : " "} #{terminal[:exception_backtrace]}#{path}:#{offset}#{terminal.reset} #{message}"
+					output.puts "  #{index == 0 ? "→" : " "} #{terminal[style]}#{path}:#{offset}#{terminal[:exception_message]} #{message}#{terminal.reset}"
 				end
 				
 				if exception.cause

data/lib/console/event/measure.rb

@@ -0,0 +1,42 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'metric'
+require_relative '../clock'
+
+module Console
+	module Event
+		class Enter < Generic
+			def initialize(name)
+				@name = name
+			end
+			
+			def format(output, terminal, verbose)
+				output.puts "→ #{@name}"
+			end
+		end
+		
+		class Exit < Metric
+			def value_string
+				"← #{@name} took #{Clock.formatted_duration(@value)}"
+			end
+		end
+	end
+end

data/lib/console/event/metric.rb

@@ -19,6 +19,7 @@
 # THE SOFTWARE.
 
 require_relative 'generic'
+require_relative '../clock'
 
 module Console
 	module Event
@@ -41,8 +42,16 @@ module Console
 				{name: @name, value: @value, tags: @tags}
 			end
 			
+			def value_string
+				"#{@name}: #{@value}"
+			end
+			
 			def format(output, terminal, verbose)
-				output.puts "#{@name}=#{@value} #{@tags.inspect}"
+				if @tags&.any?
+					output.puts "#{value_string} #{@tags.inspect}"
+				else
+					output.puts value_string
+				end
 			end
 		end
 	end

data/lib/console/filter.rb

@@ -26,11 +26,12 @@ module Console
 	class Filter
 		def self.[] **levels
 			klass = Class.new(self)
+			min_level, max_level = levels.values.minmax
 			
 			klass.instance_exec do
 				const_set(:LEVELS, levels)
-				const_set(:MINIMUM_LEVEL, levels.values.min)
-				const_set(:MAXIMUM_LEVEL, levels.values.max)
+				const_set(:MINIMUM_LEVEL, min_level)
+				const_set(:MAXIMUM_LEVEL, max_level)
 				
 				levels.each do |name, level|
 					const_set(name.to_s.upcase, level)
@@ -102,7 +103,7 @@ module Console
 		end
 		
 		def all!
-			@level = -1
+			@level = self.class::MINIMUM_LEVEL - 1
 		end
 		
 		# You can enable and disable logging for classes. This function checks if logging for a given subject is enabled.

data/lib/console/logger.rb

@@ -18,11 +18,14 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 # THE SOFTWARE.
 
+require_relative 'output'
 require_relative 'filter'
+require_relative 'measure'
 require_relative 'progress'
 
 require_relative 'resolver'
 require_relative 'terminal/logger'
+require_relative 'serialized/logger'
 
 require 'fiber/local'
 
@@ -34,7 +37,7 @@ module Console
 		# 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 self.default_log_level(env = ENV)
-			if level = (env['CONSOLE_LEVEL'] || env['CONSOLE_LOG_LEVEL'])
+			if level = env['CONSOLE_LEVEL']
 				LEVELS[level.to_sym] || level.to_i
 			elsif $DEBUG
 				DEBUG
@@ -50,17 +53,25 @@ module Console
 			!$VERBOSE.nil? || env['CONSOLE_VERBOSE']
 		end
 		
-		def self.default_logger(output, verbose: self.verbose?, level: self.default_log_level)
-			terminal = Terminal::Logger.new(output, verbose: verbose)
+		def self.default_logger(output = $stderr, env = ENV, **options)
+			if options[:verbose].nil?
+				options[:verbose] = self.verbose?(env)
+			end
+			
+			if options[:level].nil?
+				options[:level] = self.default_log_level(env)
+			end
+			
+			output = Output.new(output, env, **options)
+			logger = self.new(output, **options)
 			
-			logger = self.new(terminal, verbose: verbose, level: level)
-			resolver = Resolver.default_resolver(logger)
+			Resolver.default_resolver(logger)
 			
 			return logger
 		end
 		
 		def self.local
-			self.default_logger($stderr)
+			self.default_logger
 		end
 		
 		DEFAULT_LEVEL = 1
@@ -73,8 +84,15 @@ module Console
 			Progress.new(self, subject, total, **options)
 		end
 		
-		# @deprecated Please use {progress}.
-		alias measure progress
+		def measure(subject, name = "block", **tags, &block)
+			measure = Measure.new(self, subject, **tags)
+			
+			if block_given?
+				return measure.duration(name, &block)
+			else
+				return measure
+			end
+		end
 		
 		def failure(subject, exception, *arguments, &block)
 			fatal(subject, *arguments, Event::Failure.new(exception), &block)

data/lib/console/measure.rb

@@ -0,0 +1,49 @@
+# Copyright, 2017, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'event/measure'
+require_relative 'clock'
+
+module Console
+	class Measure
+		def initialize(output, subject, **tags)
+			@output = output
+			@subject = subject
+			@tags = tags
+		end
+		
+		attr :tags
+		
+		# Measure the execution of a block of code.
+		def duration(name, &block)
+			@output.info(@subject) {Event::Enter.new(name)}
+			
+			start_time = Clock.now
+			
+			result = yield(self)
+			
+			duration = Clock.now - start_time
+			
+			@output.info(@subject) {Event::Exit.new(name, duration, **@tags)}
+			
+			return result
+		end
+	end
+end

data/lib/console/output.rb

@@ -0,0 +1,40 @@
+# Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'output/default'
+require_relative 'output/json'
+require_relative 'output/text'
+require_relative 'output/xterm'
+
+module Console
+	module Output
+		def self.new(output = nil, env = ENV, **options)
+			if names = env['CONSOLE_OUTPUT']
+				names = names.split(',').map(&:to_sym).reverse
+				
+				names.inject(output) do |output, name|
+					Output.const_get(name).new(output, **options)
+				end
+			else
+				return Output::Default.new(output, **options)
+			end
+		end
+	end
+end

data/lib/console/output/default.rb

@@ -0,0 +1,38 @@
+# Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative 'xterm'
+require_relative 'json'
+
+module Console
+	module Output
+		module Default
+			def self.new(output, **options)
+				output ||= $stderr
+				
+				if output.tty?
+					XTerm.new(output, **options)
+				else
+					JSON.new(output, **options)
+				end
+			end
+		end
+	end
+end

data/lib/console/output/json.rb

@@ -0,0 +1,31 @@
+# Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative '../serialized/logger'
+
+module Console
+	module Output
+		module JSON
+			def self.new(output, **options)
+				Serialized::Logger.new(output, format: ::JSON, **options)
+			end
+		end
+	end
+end

data/lib/console/output/sensitive.rb

@@ -0,0 +1,118 @@
+# Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative '../serialized/logger'
+
+module Console
+	module Output
+		class Sensitive
+			def initialize(output, **options)
+				@output = output
+			end
+			
+			REDACT = /
+				  phone
+				| email
+				| full_?name
+				| first_?name
+				| last_?name
+				
+				| device_name
+				| user_agent
+				
+				| zip
+				| address
+				| location
+				| latitude
+				| longitude
+				
+				| ip
+				| gps
+				
+				| sex
+				| gender
+				
+				| token
+				| password
+			/xi
+			
+			def redact?(text)
+				text.match?(REDACT)
+			end
+			
+			def redact_hash(arguments, filter)
+				arguments.transform_values do |value|
+					redact(value, filter)
+				end
+			end
+			
+			def redact_array(array, filter)
+				array.map do |value|
+					redact(value, filter)
+				end
+			end
+			
+			def redact(argument, filter)
+				case argument
+				when String
+					if filter
+						filter.call(argument)
+					elsif redact?(argument)
+						"[REDACTED]"
+					else
+						argument
+					end
+				when Array
+					redact_array(argument, filter)
+				when Hash
+					redact_hash(argument, filter)
+				else
+					redact(argument.to_s, filter)
+				end
+			end
+			
+			class Filter
+				def initialize(substitutions)
+					@substitutions = substitutions
+					@pattern = Regexp.union(substitutions.keys)
+				end
+				
+				def call(text)
+					text.gsub(@pattern, @substitutions)
+				end
+			end
+			
+			def call(subject = nil, *arguments, sensitive: true, **options, &block)
+				if sensitive
+					if sensitive.respond_to?(:call)
+						filter = sensitive
+					elsif sensitive.is_a?(Hash)
+						filter = Filter.new(sensitive)
+					end
+					
+					subject = redact(subject, filter)
+					arguments = redact_array(arguments, filter)
+				end
+				
+				@output.call(subject, *arguments, **options)
+			end
+		end
+	end
+end

data/lib/console/output/text.rb

@@ -0,0 +1,31 @@
+# Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative '../terminal/logger'
+
+module Console
+	module Output
+		module Text
+			def self.new(output, **options)
+				Terminal::Logger.new(output, format: Terminal::Text, **options)
+			end
+		end
+	end
+end

data/lib/console/output/xterm.rb

@@ -0,0 +1,31 @@
+# Copyright, 2021, by Samuel G. D. Williams. <http://www.codeotaku.com>
+# 
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+# 
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+# 
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+
+require_relative '../terminal/logger'
+
+module Console
+	module Output
+		module XTerm
+			def self.new(output, **options)
+				Terminal::Logger.new(output, format: Terminal::XTerm, **options)
+			end
+		end
+	end
+end

data/lib/console/progress.rb

@@ -19,6 +19,7 @@
 # THE SOFTWARE.
 
 require_relative 'event/progress'
+require_relative 'clock'
 
 module Console
 	class Progress
@@ -93,7 +94,7 @@ module Console
 		
 		def to_s
 			if estimated_remaining_time = self.estimated_remaining_time
-				"#{@current}/#{@total} completed in #{self.formatted_duration self.duration}, #{self.formatted_duration estimated_remaining_time} remaining."
+				"#{@current}/#{@total} completed in #{Clock.formatted_duration(self.duration)}, #{Clock.formatted_duration(estimated_remaining_time)} remaining."
 			else
 				"#{@current}/#{@total} completed, waiting for estimate..."
 			end
@@ -108,33 +109,13 @@ module Console
 		end
 		
 		def output?
-			if duration = duration_since_last_output
+			if remaining.zero?
+				return true
+			elsif duration = duration_since_last_output
 				return duration > @minimum_output_duration
 			else
 				return true
 			end
 		end
-		
-		def formatted_duration(duration)
-			if duration < 60.0
-				return "#{duration.round(2)}s"
-			end
-			
-			duration /= 60.0
-			
-			if duration < 60.0
-				return "#{duration.round}m"
-			end
-			
-			duration /= 60.0
-			
-			if duration < 60.0
-				return "#{duration.round(1)}h"
-			end
-			
-			duration /= 24.0
-			
-			return "#{duration.round(1)}d"
-		end
 	end
 end

data/lib/console/resolver.rb

@@ -26,6 +26,8 @@ module Console
 		#
 		# e.g. `CONSOLE_WARN=Acorn,Banana CONSOLE_DEBUG=Cat` will set the log level for the classes Acorn and Banana to `warn` and Cat to `debug`. This overrides the default log level.
 		#
+		# You can enable all log levels for a given class by using `CONSOLE_ON=MyClass`. Similarly you can disable all logging using `CONSOLE_OFF=MyClass`.
+		#
 		# @parameter logger [Logger] A logger instance to set the logging levels on.
 		# @parameter env [Hash] The environment to read levels from.
 		#
@@ -33,23 +35,42 @@ module Console
 		# @returns [Resolver] If there were custom logging levels, then the created resolver is returned.
 		def self.default_resolver(logger, env = ENV)
 			# Find all CONSOLE_<LEVEL> variables from environment:
-			levels = Logger::LEVELS
+			levels = logger.class::LEVELS
 				.map{|label, level| [level, env["CONSOLE_#{label.upcase}"]&.split(',')]}
 				.to_h
 				.compact
 			
+			off_klasses = env['CONSOLE_OFF']&.split(',')
+			on_klasses = env['CONSOLE_ON']&.split(',')
+			
+			resolver = nil
+			
 			# If we have any levels, then create a class resolver, and each time a class is resolved, set the log level for that class to the specified level:
-			if levels.any?
-				resolver = Resolver.new
+			if on_klasses&.any?
+				resolver ||= Resolver.new
 				
-				levels.each do |level, names|
-					resolver.bind(names) do |klass|
-						logger.enable(klass, level)
-					end
+				resolver.bind(on_klasses) do |klass|
+					logger.enable(klass, logger.class::MINIMUM_LEVEL - 1)
 				end
+			end
+			
+			if off_klasses&.any?
+				resolver ||= Resolver.new
 				
-				return resolver
+				resolver.bind(off_klasses) do |klass|
+					logger.disable(klass)
+				end
 			end
+			
+			levels.each do |level, names|
+				resolver ||= Resolver.new
+				
+				resolver.bind(names) do |klass|
+					logger.enable(klass, level)
+				end
+			end
+			
+			return resolver
 		end
 		
 		def initialize

data/lib/console/serialized/logger.rb

@@ -27,7 +27,7 @@ require 'json'
 module Console
 	module Serialized
 		class Logger
-			def initialize(io = $stderr, format: JSON)
+			def initialize(io = $stderr, format: JSON, **options)
 				@io = io
 				@start = Time.now
 				@format = format

data/lib/console/terminal/logger.rb

@@ -25,6 +25,7 @@ require_relative 'text'
 require_relative 'xterm'
 
 require 'json'
+require 'fiber'
 
 module Console
 	module Terminal
@@ -54,11 +55,11 @@ module Console
 		end
 		
 		class Logger
-			def initialize(io = $stderr, verbose: nil, start_at: Terminal.start_at!, **options)
+			def initialize(io = $stderr, verbose: nil, start_at: Terminal.start_at!, format: nil, **options)
 				@io = io
 				@start_at = start_at
 				
-				@terminal = Terminal.for(io)
+				@terminal = format.nil? ? Terminal.for(io) : format.new(io)
 				
 				if verbose.nil?
 					@verbose = !@terminal.colors?
@@ -66,7 +67,6 @@ module Console
 					@verbose = verbose
 				end
 				
-				@terminal[:logger_prefix] ||= @terminal.style(nil, nil, nil)
 				@terminal[:logger_suffix] ||= @terminal.style(:white, nil, :faint)
 				@terminal[:subject] ||= @terminal.style(nil, nil, :bold)
 				@terminal[:debug] = @terminal.style(:cyan)
@@ -136,7 +136,7 @@ module Console
 			def format_argument(argument, output)
 				case argument
 				when Exception
-					Event::Failure.new(argument).format(output, @terminal, @verbose)
+					Event::Failure.for(argument).format(output, @terminal, @verbose)
 				when Event::Generic
 					argument.format(output, @terminal, @verbose)
 				else
@@ -154,11 +154,21 @@ module Console
 				end
 			end
 			
+			def default_suffix(object = nil)
+				buffer = +" #{@terminal[:logger_suffix]}"
+				
+				if object
+					buffer << "[oid=0x#{object.object_id.to_s(16)}] "
+				end
+				
+				buffer << "[ec=0x#{Fiber.current.object_id.to_s(16)}] [pid=#{Process.pid}] [#{::Time.now}]#{@terminal.reset}"
+			end
+			
 			def format_object_subject(severity, prefix, subject, output)
 				prefix_style = @terminal[severity]
 				
 				if @verbose
-					suffix = " #{@terminal[:logger_suffix]}[oid=0x#{subject.object_id.to_s(16)}] [pid=#{Process.pid}] [#{Time.now}]#{@terminal.reset}"
+					suffix = default_suffix(subject)
 				end
 				
 				prefix = "#{prefix_style}#{prefix}:#{@terminal.reset} "
@@ -170,7 +180,7 @@ module Console
 				prefix_style = @terminal[severity]
 				
 				if @verbose
-					suffix = " #{@terminal[:logger_suffix]}[pid=#{Process.pid}] [#{Time.now}]#{@terminal.reset}"
+					suffix = default_suffix
 				end
 				
 				prefix = "#{prefix_style}#{prefix}:#{@terminal.reset} "
@@ -187,15 +197,7 @@ module Console
 			end
 			
 			def time_offset_prefix
-				offset = Time.now - @start_at
-				minutes = (offset/60).floor
-				seconds = (offset - (minutes*60))
-				
-				if minutes > 0
-					"#{minutes}m#{seconds.floor}s"
-				else
-					"#{seconds.round(2)}s"
-				end.rjust(6)
+				Clock.formatted_duration(Time.now - @start_at).rjust(6)
 			end
 			
 			def build_prefix(name)

data/lib/console/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: console
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.12.0
 platform: ruby
 authors:
 - Samuel Williams
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-10-30 00:00:00.000000000 Z
+date: 2021-04-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiber-local
@@ -104,14 +104,23 @@ files:
 - lib/console.rb
 - lib/console/buffer.rb
 - lib/console/capture.rb
+- lib/console/clock.rb
 - lib/console/event.rb
 - lib/console/event/failure.rb
 - lib/console/event/generic.rb
+- lib/console/event/measure.rb
 - lib/console/event/metric.rb
 - lib/console/event/progress.rb
 - lib/console/event/spawn.rb
 - lib/console/filter.rb
 - lib/console/logger.rb
+- lib/console/measure.rb
+- lib/console/output.rb
+- lib/console/output/default.rb
+- lib/console/output/json.rb
+- lib/console/output/sensitive.rb
+- lib/console/output/text.rb
+- lib/console/output/xterm.rb
 - lib/console/progress.rb
 - lib/console/resolver.rb
 - lib/console/serialized/logger.rb
@@ -140,7 +149,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.2
+rubygems_version: 3.2.3
 signing_key:
 specification_version: 4
 summary: Beautiful logging for Ruby.