console 1.27.0 → 1.28.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93187d6e4774eecaad627306d33a5f38bad4e123e029587d7f142a1265de6ec6
-  data.tar.gz: 9a5015df0b90995173414eecd2b5b6bff60fe07129db4089cad9c86bdbf1e84f
+  metadata.gz: 8c1e55ddfff39c11445d128d77669db8d27047b5bb52451c0dcd41986b9efe99
+  data.tar.gz: 314cd06dc220bc184899c393d68ef8e0387e92bbeb39522b2ec9ab11b408cb01
 SHA512:
-  metadata.gz: d1bc5192624a8c15f464ceac4c5b7f6b3d4340df8a75aff4f5e20b6b42d340872135538b5abb4dd8a2e34f57048536898dee9e07a2c1a0e2e819a1c34b259cc5
-  data.tar.gz: d61a670deecf0418cd09ed9f1a4d800d2dd5d7b41bd02b3ce2aaa410b27178e62bb7071106a4d7ae89c57fcc4aeadd9ce478a37a1a7859bd20ac00c76c7e1c43
+  metadata.gz: e2b5c3d3d01818a45f7680e07417c5c6bb805caa81c5a598d7a4c83fa77363cdbf241eb5f00327ff835c130ebe53994f34c923c50304c972d01b714fba638263
+  data.tar.gz: 6cc85f8a898133e9af736f89b0d12cda37fdc46f2467131e89b6784842a8cdff9757f0981cf18c7ae0cbf1b21d005aaf4f7b9f647c891ec96b790833446c4fcd

data/bake/console.rb

@@ -1,18 +1,18 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2020-2022, by Samuel Williams.
+# Copyright, 2020-2024, by Samuel Williams.
 
 # Increase the verbosity of the logger to info.
 def info
-	require_relative '../lib/console'
+	require_relative "../lib/console"
 	
 	Console.logger.info!
 end
 
 # Increase the verbosity of the logger to debug.
 def debug
-	require_relative '../lib/console'
+	require_relative "../lib/console"
 	
 	Console.logger.debug!
 end

data/lib/console/capture.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'filter'
+require_relative "filter"
 
 module Console
 	# A general sink which captures all events into a buffer.

data/lib/console/compatible/logger.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2022-2024, by Samuel Williams.
 
-require 'logger'
+require "logger"
 
 module Console
 	module Compatible

data/lib/console/event/failure.rb

@@ -5,7 +5,7 @@
 # Copyright, 2021, by Robert Schulze.
 # Copyright, 2024, by Patrik Wenger.
 
-require_relative 'generic'
+require_relative "generic"
 
 module Console
 	module Event
@@ -59,7 +59,7 @@ module Console
 					message = exception.detailed_message
 					
 					# We want to remove the trailling exception class as we format it differently:
-					message.sub!(/\s*\(.*?\)$/, '')
+					message.sub!(/\s*\(.*?\)$/, "")
 					
 					hash[:message] = message
 				else

data/lib/console/event/spawn.rb

@@ -3,8 +3,8 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'generic'
-require_relative '../clock'
+require_relative "generic"
+require_relative "../clock"
 
 module Console
 	module Event

data/lib/console/event.rb

@@ -3,5 +3,5 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'event/spawn'
-require_relative 'event/failure'
+require_relative "event/spawn"
+require_relative "event/failure"

data/lib/console/filter.rb

@@ -10,7 +10,7 @@ module Console
 	UNKNOWN = :unknown
 	
 	class Filter
-		if Object.const_defined?(:Ractor) and RUBY_VERSION >= '3.1'
+		if Object.const_defined?(:Ractor) and RUBY_VERSION >= "3.1"
 			def self.define_immutable_method(name, &block)
 				block = Ractor.make_shareable(block)
 				self.define_method(name, &block)

data/lib/console/format/safe.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023, by Samuel Williams.
+# Copyright, 2023-2024, by Samuel Williams.
 
-require 'json'
+require "json"
 
 module Console
 	module Format

data/lib/console/format.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2023-2024, by Samuel Williams.
 
-require_relative 'format/safe'
+require_relative "format/safe"
 
 module Console
 	module Format

data/lib/console/logger.rb

@@ -5,13 +5,13 @@
 # Copyright, 2021, by Bryan Powell.
 # Copyright, 2021, by Robert Schulze.
 
-require_relative 'output'
-require_relative 'filter'
-require_relative 'event'
-require_relative 'resolver'
-require_relative 'progress'
+require_relative "output"
+require_relative "filter"
+require_relative "event"
+require_relative "resolver"
+require_relative "progress"
 
-require 'fiber/local'
+require "fiber/local"
 
 module Console
 	class Logger < Filter[debug: 0, info: 1, warn: 2, error: 3, fatal: 4]
@@ -21,7 +21,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']
+			if level = env["CONSOLE_LEVEL"]
 				LEVELS[level.to_sym] || level.to_i
 			elsif $DEBUG
 				DEBUG
@@ -34,7 +34,7 @@ module Console
 		
 		# Controls verbose output using `$VERBOSE`.
 		def self.verbose?(env = ENV)
-			!$VERBOSE.nil? || env['CONSOLE_VERBOSE']
+			!$VERBOSE.nil? || env["CONSOLE_VERBOSE"]
 		end
 		
 		def self.default_logger(output = $stderr, env = ENV, **options)

data/lib/console/output/default.rb

@@ -3,8 +3,8 @@
 # Released under the MIT License.
 # Copyright, 2021-2024, by Samuel Williams.
 
-require_relative 'terminal'
-require_relative 'serialized'
+require_relative "terminal"
+require_relative "serialized"
 
 module Console
 	module Output

data/lib/console/output/sensitive.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2021-2024, by Samuel Williams.
 
-require_relative 'wrapper'
+require_relative "wrapper"
 
 module Console
 	module Output

data/lib/console/output/serialized.rb

@@ -3,9 +3,9 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require_relative '../format'
-require 'time'
-require 'fiber/annotation'
+require_relative "../format"
+require "time"
+require "fiber/annotation"
 
 module Console
 	module Output

data/lib/console/output/terminal.rb

@@ -4,13 +4,13 @@
 # Copyright, 2019-2024, by Samuel Williams.
 # Copyright, 2021, by Robert Schulze.
 
-require_relative '../clock'
-require_relative '../terminal'
+require_relative "../clock"
+require_relative "../terminal"
 
-require 'json'
-require 'fiber'
-require 'fiber/annotation'
-require 'stringio'
+require "json"
+require "fiber"
+require "fiber/annotation"
+require "stringio"
 
 module Console
 	module Output
@@ -35,7 +35,7 @@ module Console
 			end
 			
 			# This, and all related methods, is considered private.
-			CONSOLE_START_AT = 'CONSOLE_START_AT'
+			CONSOLE_START_AT = "CONSOLE_START_AT"
 			
 			# Exports CONSOLE_START which can be used to synchronize the start times of all child processes when they log using delta time.
 			def self.start_at!(environment = ENV)

data/lib/console/output.rb

@@ -3,16 +3,16 @@
 # Released under the MIT License.
 # Copyright, 2021-2024, by Samuel Williams.
 
-require_relative 'output/default'
-require_relative 'output/serialized'
-require_relative 'output/terminal'
-require_relative 'output/null'
+require_relative "output/default"
+require_relative "output/serialized"
+require_relative "output/terminal"
+require_relative "output/null"
 
 module Console
 	module Output
 		def self.new(output = nil, env = ENV, **options)
-			if names = env['CONSOLE_OUTPUT']
-				names = names.split(',').reverse
+			if names = env["CONSOLE_OUTPUT"]
+				names = names.split(",").reverse
 				
 				names.inject(output) do |output, name|
 					Output.const_get(name).new(output, **options)

data/lib/console/progress.rb

@@ -4,7 +4,7 @@
 # Copyright, 2020-2024, by Samuel Williams.
 # Copyright, 2022, by Anton Sozontov.
 
-require_relative 'clock'
+require_relative "clock"
 
 module Console
 	class Progress

data/lib/console/resolver.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2022, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 # Copyright, 2021, by Robert Schulze.
 
-require_relative 'filter'
+require_relative "filter"
 
 module Console
 	class Resolver
@@ -22,12 +22,12 @@ module Console
 		def self.default_resolver(logger, env = ENV)
 			# Find all CONSOLE_$LEVEL variables from environment:
 			levels = logger.class::LEVELS
-				.map{|label, level| [level, env["CONSOLE_#{label.upcase}"]&.split(',')]}
+				.map{|label, level| [level, env["CONSOLE_#{label.upcase}"]&.split(",")]}
 				.to_h
 				.compact
 			
-			off_klasses = env['CONSOLE_OFF']&.split(',')
-			on_klasses = env['CONSOLE_ON']&.split(',')
+			off_klasses = env["CONSOLE_OFF"]&.split(",")
+			on_klasses = env["CONSOLE_ON"]&.split(",")
 			
 			resolver = nil
 			

data/lib/console/terminal/text.rb

@@ -3,7 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require 'io/console'
+require "io/console"
 
 module Console
 	# Styled terminal output.

data/lib/console/terminal/xterm.rb

@@ -3,9 +3,9 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require 'io/console'
+require "io/console"
 
-require_relative 'text'
+require_relative "text"
 
 module Console
 	# Styled terminal output.

data/lib/console/terminal.rb

@@ -3,12 +3,12 @@
 # Released under the MIT License.
 # Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'terminal/text'
-require_relative 'terminal/xterm'
+require_relative "terminal/text"
+require_relative "terminal/xterm"
 
-require_relative 'terminal/formatter/progress'
-require_relative 'terminal/formatter/failure'
-require_relative 'terminal/formatter/spawn'
+require_relative "terminal/formatter/progress"
+require_relative "terminal/formatter/failure"
+require_relative "terminal/formatter/spawn"
 
 module Console
 	module Terminal

data/lib/console/version.rb

@@ -4,5 +4,5 @@
 # Copyright, 2019-2024, by Samuel Williams.
 
 module Console
-	VERSION = "1.27.0"
+	VERSION = "1.28.1"
 end

data/lib/console/warn.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2024, by Samuel Williams.
+
+module Console
+	# Whether the current fiber is emitting a warning.
+	Fiber.attr_accessor :console_warn
+	
+	module Warn
+		def warn(*arguments, uplevel: nil, **options)
+			fiber = Fiber.current
+			
+			# We do this to be extra pendantic about avoiding infinite recursion, i.e. if `Console.warn` some how calls `Kernel.warn` again, it would potentially cause infinite recursion. I'm not sure if this is a problem in practice, but I'd rather not find out the hard way...
+			return super if fiber.console_warn
+			
+			if uplevel
+				options[:backtrace] = caller(uplevel, 1)
+			end
+			
+			if arguments.last.is_a?(Exception)
+				exception = arguments.pop
+				
+				Console::Event::Failure.for(exception).emit(*arguments, severity: :warn)
+			else
+				begin
+					fiber.console_warn = true
+					Console.warn(*arguments, **options)
+				ensure
+					fiber.console_warn = false
+				end
+			end
+		end
+	end
+	
+	::Kernel.prepend(Warn)
+end

data/lib/console.rb

@@ -6,8 +6,9 @@
 # Copyright, 2020, by Michael Adams.
 # Copyright, 2021, by Cédric Boutillier.
 
-require_relative 'console/version'
-require_relative 'console/logger'
+require_relative "console/version"
+require_relative "console/logger"
+require_relative "console/warn"
 
 module Console
 	class << self

data/readme.md

@@ -26,6 +26,16 @@ Please see the [project documentation](https://socketry.github.io/console/) for
 
   - [Integration](https://socketry.github.io/console/guides/integration/index) - This guide explains how to integrate the `console` output into different systems.
 
+  - [Events](https://socketry.github.io/console/guides/events/index) - This guide explains how to log structured events with a well-defined schema.
+
+## Releases
+
+Please see the [project releases](https://socketry.github.io/console/releases/index) for all releases.
+
+### v1.28.0
+
+  - Add support for `Kernel#warn` redirection to `Console.warn`.
+
 ## Contributing
 
 We welcome contributions to this project.

data/releases.md

@@ -0,0 +1,5 @@
+# Releases
+
+## v1.28.0
+
+  - Add support for `Kernel#warn` redirection to `Console.warn`.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: console
 version: !ruby/object:Gem::Version
-  version: 1.27.0
+  version: 1.28.1
 platform: ruby
 authors:
 - Samuel Williams
@@ -47,7 +47,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-07-18 00:00:00.000000000 Z
+date: 2024-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiber-annotation
@@ -128,8 +128,10 @@ files:
 - lib/console/terminal/text.rb
 - lib/console/terminal/xterm.rb
 - lib/console/version.rb
+- lib/console/warn.rb
 - license.md
 - readme.md
+- releases.md
 homepage: https://socketry.github.io/console
 licenses:
 - MIT

metadata.gz.sig

@@ -1,3 +1,5 @@
-3�M�^�"�yIr��Tc�
-Yg��Q\����KZy���NO���D٠�f�V��C�#��`j��+)��8�2<3
-=��P�~�&c��k�ك����r��q@�{ ��-rɶ��${5�{���X�*vA����n[��D���w$栩^�d�����K	��l�Ө��l�i�7�7���F;&s�]�0֭	DXG�c]�D�C��M���=l�،�'$⼣ǁ0w\�]�d���ϛ? ,�E����J�l��:}w�
?	a�����
�Uc�о��5�\��ξ��3y�|�T��k74�Ag�pM�Ʉ[� wG� �8�E8j����i�ꄚs�E��tG�>k���k���1�"Y����
+t�Q�na�f���P�x�y:r,ڪ�i�w�]c,��/Hl�N%��f�8�]܅u��7~(ol�ŚыD�M
+��G\�3��:��à�qoN��@����
+T0�1���G��Y���3����ܸeF	�i�f;����(�EғS�lD�"�{��f��������	.��nz���;
+"�p"�-g�a�_�:)�a�k'8Ճ"C���@L��b�ܑ���{�?�iN�A4m3\�D5�
+�G�H\j=l!��d9�R‘E�