console 1.30.2 → 1.31.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4a3a941ea83d20a38ee9478245b0a7c7a0845b7aac0cc64311f081bef9fbc809
-  data.tar.gz: d2619ea91b4599616c5129c1880468e5d28250fc4756445b778a65b114a27b6d
+  metadata.gz: 356c92cbef3eb3269b7dada97f281c832304e0cad9885102e63c7d6725196df2
+  data.tar.gz: 1f957d68282bea484c6abddd507dcb886930c727d148f9dfa4f02f482724c234
 SHA512:
-  metadata.gz: dc3f9bee5ec9205e1a144606188da0629688a53ec59a82d5ed90987f78dffdb833d2ccee63cbf091c8e4c06d3d1ea535b1ebfc6c35314a624d7f01232704fbce
-  data.tar.gz: 0e65d355fceba6fc1ae152d5aa0a71e314fc21c5d558c9e23ee211fd3f62c764b9060d2d7f0b1fc90b3856a41a2f2d211b3531e90aa9e91d49df27cdbdc7ad9c
+  metadata.gz: c7400992949682404ecd931375c098c103105c5d513897c933f56be31ac7b8d96e81ea12eb85ad012b91358ee14309684f3321a7704dd25717f581c04cb51fdc
+  data.tar.gz: 02a3052cb5169303820e55bbe7c13bc6d9564ffd1df810b8a0329814fd2b84a0a1da3b12c008569cb4133cdd2e7e63d08153ec24ee72f786487c049f60432893

data/lib/console/config.rb

@@ -30,12 +30,15 @@ module Console
 		# Load the default configuration.
 		# @returns [Config] The default configuration.
 		def self.default
-			@default ||= self.load(PATH)
+			@default ||= self.load(PATH).freeze
 		end
 		
 		# Set the default log level based on `$DEBUG` and `$VERBOSE`.
 		# 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.
+		#
+		# @parameter env [Hash] The environment to read the log level from.
+		# @returns [Integer | Symbol] The default log level.
 		def log_level(env = ENV)
 			Logger.default_log_level(env)
 		end

data/lib/console/event/generic.rb

@@ -7,6 +7,13 @@ module Console
 	module Event
 		# A generic event which can be used to represent structured data.
 		class Generic
+			# Convert the event to a hash suitable for JSON serialization.
+			#
+			# @returns [Hash] The hash representation of the event.
+			def to_hash
+				{}
+			end
+			
 			# Convert the event to a hash suitable for JSON serialization.
 			#
 			# @returns [Hash] The hash representation of the event.

data/lib/console/filter.rb

@@ -70,10 +70,16 @@ module Console
 		# @parameter verbose [Boolean] Enable verbose output.
 		# @parameter level [Integer] The log level.
 		# @parameter options [Hash] Additional options.
-		def initialize(output, verbose: true, level: self.class::DEFAULT_LEVEL, **options)
+		def initialize(output, verbose: true, level: nil, **options)
 			@output = output
 			@verbose = verbose
-			@level = level
+			
+			# Set the log level using the behaviour implemented in `level=`:
+			if level
+				self.level = level
+			else
+				@level = self.class::DEFAULT_LEVEL
+			end
 			
 			@subjects = {}
 			
@@ -156,7 +162,7 @@ module Console
 		#
 		# You can enable and disable logging for classes. This function checks if logging for a given subject is enabled.
 		#
-		# @parameter subject [Module] The subject to check.
+		# @parameter subject [Module | Object] The subject to check.
 		# @parameter level [Integer] The log level.
 		# @returns [Boolean] Whether logging is enabled.
 		def enabled?(subject, level = self.class::MINIMUM_LEVEL)

data/lib/console/output/default.rb

@@ -14,12 +14,13 @@ module Console
 			# Create a new output format based on the given stream.
 			#
 			# @parameter io [IO] The output stream.
+			# @parameter env [Hash] Environment variables (defaults to ENV for testing).
 			# @parameter options [Hash] Additional options to customize the output.
 			# @returns [Console::Output::Terminal | Console::Output::Serialized] The output instance, depending on whether the `io` is a terminal or not.
-			def self.new(stream, **options)
+			def self.new(stream, env: ENV, **options)
 				stream ||= $stderr
 				
-				if stream.tty?
+				if stream.tty? || mail?(env)
 					output = Terminal.new(stream, **options)
 				else
 					output = Serialized.new(stream, **options)
@@ -27,6 +28,17 @@ module Console
 				
 				return output
 			end
+			
+			private
+			
+			# Detect if we're running in a cron job or mail context where human-readable output is preferred.
+			# Cron jobs often have MAILTO set and lack TERM, or have minimal TERM values.
+			def self.mail?(env = ENV)
+				# Check for common cron environment indicators
+				return true if env.key?("MAILTO") && !env["MAILTO"].empty?
+				
+				false
+			end
 		end
 	end
 end

data/lib/console/terminal/text.rb

@@ -78,15 +78,19 @@ module Console
 				end
 			end
 			
-			# Write the given arguments to the output stream using the given style. The reset sequence is automatically appended.
+			# Write the given arguments to the output stream using the given style. The reset sequence is automatically
+			# appended at the end of each line.
 			#
 			# @parameter arguments [Array] The arguments to write, each on a new line.
 			# @parameter style [Symbol] The style to apply.
 			def puts(*arguments, style: nil)
 				if style and prefix = self[style]
-					@stream.write(prefix)
-					@stream.puts(*arguments)
-					@stream.write(self.reset)
+					arguments.each do |argument|
+						argument.to_s.lines.each do |line|
+							@stream.write(prefix, line.chomp)
+							@stream.puts(self.reset)
+						end
+					end
 				else
 					@stream.puts(*arguments)
 				end

data/lib/console/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2019-2025, by Samuel Williams.
 
 module Console
-	VERSION = "1.30.2"
+	VERSION = "1.31.0"
 end

data/readme.md

@@ -34,6 +34,12 @@ Please see the [project documentation](https://socketry.github.io/console/) for
 
 Please see the [project releases](https://socketry.github.io/console/releases/index) for all releases.
 
+### v1.31.0
+
+  - [Ractor compatibility.](https://socketry.github.io/console/releases/index#ractor-compatibility.)
+  - [Symbol log level compatibility.](https://socketry.github.io/console/releases/index#symbol-log-level-compatibility.)
+  - [Improved output format selection for cron jobs and email contexts.](https://socketry.github.io/console/releases/index#improved-output-format-selection-for-cron-jobs-and-email-contexts.)
+
 ### v1.30.0
 
   - [Introduce `Console::Config` for fine grained configuration.](https://socketry.github.io/console/releases/index#introduce-console::config-for-fine-grained-configuration.)

data/releases.md

@@ -1,5 +1,60 @@
 # Releases
 
+## v1.31.0
+
+### Ractor compatibility.
+
+The console library now works correctly with Ruby's Ractor concurrency model. Previously, attempting to use console logging within Ractors would fail with errors about non-shareable objects. This has been fixed by ensuring the default configuration is properly frozen.
+
+``` ruby
+# This now works without errors:
+ractor = Ractor.new do
+  require 'console'
+  Console.info('Hello from Ractor!')
+  'Ractor completed successfully'
+end
+
+result = ractor.take
+puts result # => 'Ractor completed successfully'
+```
+
+The fix is minimal and maintains full backward compatibility while enabling safe parallel logging across multiple Ractors.
+
+### Symbol log level compatibility.
+
+Previously, returning symbols from custom `log_level` methods in configuration files would cause runtime errors like "comparison of Integer with :debug failed". This has been fixed to properly convert symbols to their corresponding integer values.
+
+``` ruby
+# config/console.rb - This now works correctly:
+def log_level(env = ENV)
+	:debug  # Automatically converted to Console::Logger::LEVELS[:debug]
+end
+```
+
+While this fix maintains backward compatibility, the recommended approach is still to use integer values directly:
+
+``` ruby
+# config/console.rb - Recommended approach:
+def log_level(env = ENV)
+	Console::Logger::LEVELS[:debug]  # Returns 0
+end
+```
+
+### Improved output format selection for cron jobs and email contexts.
+
+When `MAILTO` environment variable is set (typically in cron jobs), the console library now prefers human-readable terminal output instead of JSON serialized output, even when the output stream is not a TTY. This ensures that cron job output sent via email is formatted in a readable way for administrators.
+
+``` ruby
+# Previously in cron jobs (non-TTY), this would output JSON:
+# {"time":"2025-06-07T10:30:00Z","severity":"info","subject":"CronJob","message":["Task completed"]}
+
+# Now with MAILTO set, it outputs human-readable format:
+#   0.1s     info: CronJob
+#                | Task completed
+```
+
+This change is conservative and only affects environments where `MAILTO` is explicitly set, ensuring compatibility with existing deployments.
+
 ## v1.30.0
 
 ### Introduce `Console::Config` for fine grained configuration.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: console
 version: !ruby/object:Gem::Version
-  version: 1.30.2
+  version: 1.31.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -47,7 +47,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2025-03-10 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiber-annotation
@@ -146,14 +146,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: Beautiful logging for Ruby.
 test_files: []