console 1.17.4 → 1.18.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 279d68c968f13422584c4b2101ce400373798479884450f4bd6db20783d115e3
-  data.tar.gz: 4a8df91d11deba88a6fc18f1dd2c09c16676cf32ef045c22aa1e25a942a4ba51
+  metadata.gz: b5e54a0a87d6c2ad440476163691fcc67016d8cdabd95f218f0e55db0a311ffd
+  data.tar.gz: a1cc36ed4d66731525458abebac6ba9081e68c17524bc32a0125291684b8107b
 SHA512:
-  metadata.gz: b118601c16e8a70d0e654aca81d67f0130113a38c926fc931c2d9904b68946e02dfc76af1a7f7804954391ce0600f46ec6897c5416c3a22cdd1a64a2e5d6a798
-  data.tar.gz: b32ed9872c022cda4d7cfe2d1e754a8015021c7765cca971052b814cc4f50fd5a069c6fc7f50eda680e6576625f95c91c265f52aab8fc6a78c3e1813bc7391f0
+  metadata.gz: 864fb845fbdb448f16a7c6b43d024ab5581ad42eb3187efcba046f9feff43f59bdb0164e5fb94fac34bd1387d26742d32395827d9e5d30a158ea8dbc8cd47391
+  data.tar.gz: 6af247ea1c0c9df853dfae8de8c651ed487e4ae010d46975586e23a6fc1925cd7a20d27545495cba3e14ea0e8246fc87f88c51acbd226cd10d7ce092338c0efe

data/lib/console/filter.rb

@@ -14,12 +14,12 @@ module Console
 	class Filter
 		def self.[] **levels
 			klass = Class.new(self)
-			min_level, max_level = levels.values.minmax
+			minimum_level, maximum_level = levels.values.minmax
 			
 			klass.instance_exec do
 				const_set(:LEVELS, levels.freeze)
-				const_set(:MINIMUM_LEVEL, min_level)
-				const_set(:MAXIMUM_LEVEL, max_level)
+				const_set(:MINIMUM_LEVEL, minimum_level)
+				const_set(:MAXIMUM_LEVEL, maximum_level)
 				
 				levels.each do |name, level|
 					const_set(name.to_s.upcase, level)
@@ -43,7 +43,7 @@ module Console
 			return klass
 		end
 		
-		def initialize(output, verbose: true, level: self.class::DEFAULT_LEVEL, enabled: nil, **options)
+		def initialize(output, verbose: true, level: self.class::DEFAULT_LEVEL, **options)
 			@output = output
 			@verbose = verbose
 			@level = level
@@ -51,10 +51,6 @@ module Console
 			@subjects = {}
 			
 			@options = options
-			
-			if enabled
-				enabled.each{|name| enable(name)}
-			end
 		end
 		
 		def with(level: @level, verbose: @verbose, **options)
@@ -94,10 +90,20 @@ module Console
 			@level = self.class::MINIMUM_LEVEL - 1
 		end
 		
+		def filter(subject, level)
+			unless subject.is_a?(Module)
+				raise ArgumentError, "Expected a class, got #{subject.inspect}"
+			end
+			
+			@subjects[subject] = level
+		end
+		
 		# You can enable and disable logging for classes. This function checks if logging for a given subject is enabled.
 		# @param subject [Object] the subject to check.
 		def enabled?(subject, level = self.class::MINIMUM_LEVEL)
-			if specific_level = @subjects[subject.class]
+			subject = subject.class unless subject.is_a?(Module)
+			
+			if specific_level = @subjects[subject]
 				return level >= specific_level
 			end
 			
@@ -107,19 +113,21 @@ module Console
 		end
 		
 		# Enable specific log level for the given class.
-		# @parameter name [Class] The class to enable.
+		# @parameter name [Module] The class to enable.
 		def enable(subject, level = self.class::MINIMUM_LEVEL)
-			unless subject.is_a?(Class)
-				raise ArgumentError, "Expected a class, got #{subject.inspect}"
-			end
-			
-			@subjects[subject] = level
+			# Set the filter level of logging for a given subject which passes all log messages:
+			filter(subject, level)
 		end
 		
-		# Disable specific logging for the specific class.
-		# @parameter name [Class] The class to disable.
 		def disable(subject)
-			unless subject.is_a?(Class)
+			# Set the filter level of the logging for a given subject which filters all log messages:
+			filter(subject, self.class::MAXIMUM_LEVEL + 1)
+		end
+		
+		# Clear any specific filters for the given class.
+		# @parameter name [Module] The class to disable.
+		def clear(subject)
+			unless subject.is_a?(Module)
 				raise ArgumentError, "Expected a class, got #{subject.inspect}"
 			end
 			

data/lib/console/output/null.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2023, by Samuel Williams.
+
+module Console
+	module Output
+		class Null
+			def initialize(...)
+			end
+			
+			def call(...)
+				# Do nothing.
+			end
+		end
+	end
+end

data/lib/console/output.rb

@@ -7,6 +7,7 @@ require_relative 'output/default'
 require_relative 'output/json'
 require_relative 'output/text'
 require_relative 'output/xterm'
+require_relative 'output/null'
 
 module Console
 	module Output

data/lib/console/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2019-2022, by Samuel Williams.
 
 module Console
-	VERSION = "1.17.4"
+	VERSION = "1.18.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: console
 version: !ruby/object:Gem::Version
-  version: 1.17.4
+  version: 1.18.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -43,7 +43,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2023-07-19 00:00:00.000000000 Z
+date: 2023-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiber-local
@@ -179,6 +179,7 @@ files:
 - lib/console/output.rb
 - lib/console/output/default.rb
 - lib/console/output/json.rb
+- lib/console/output/null.rb
 - lib/console/output/sensitive.rb
 - lib/console/output/split.rb
 - lib/console/output/text.rb