console 1.29.3 → 1.30.0

data/readme.md

@@ -24,6 +24,8 @@ Please see the [project documentation](https://socketry.github.io/console/) for
 
   - [Command Line](https://socketry.github.io/console/guides/command-line/index) - This guide explains how the `console` gem can be controlled using environment variables.
 
+  - [Configuration](https://socketry.github.io/console/guides/configuration/index) - This guide explains how to implement per-project configuration for the `console` gem.
+
   - [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.
@@ -32,6 +34,10 @@ 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.30.0
+
+  - [Introduce `Console::Config` for fine grained configuration.](https://socketry.github.io/console/releases/index#introduce-console::config-for-fine-grained-configuration.)
+
 ### v1.29.3
 
   - Serialized output now uses `IO#write` with a single string to reduce the chance of interleaved output.
@@ -48,7 +54,7 @@ Please see the [project releases](https://socketry.github.io/console/releases/in
 
   - Don't make `Kernel#warn` redirection to `Console.warn` the default behavior, you must `require 'console/warn'` to enable it.
   - Remove deprecated `Console::Logger#failure`.
-  - [Consistent Handling of Exceptions](https://socketry.github.io/console/releases/index#consistent-handling-of-exceptions)
+  - [Consistent handling of exceptions.](https://socketry.github.io/console/releases/index#consistent-handling-of-exceptions.)
 
 ### v1.28.0
 

data/releases.md

@@ -1,5 +1,28 @@
 # Releases
 
+## v1.30.0
+
+### Introduce `Console::Config` for fine grained configuration.
+
+Introduced a new explicit configuration interface via config/console.rb to enhance logging setup in complex applications. This update gives the application code an opportunity to load files if required and control aspects such as log level, output, and more. Users can override default behaviors (e.g., make\_output, make\_logger, and log\_level) for improved customization.
+
+``` ruby
+# config/console.rb
+def log_level(env = ENV)
+	# Set a custom log level, e.g., force debug mode:
+	:debug
+end
+
+def make_logger(output = $stderr, env = ENV, **options)
+	# Custom logger configuration with verbose output:
+	options[:verbose] = true
+	
+	 Logger.new(output, **options)
+end
+```
+
+This approach provides a standard way to hook into the log setup process, allowing tailored adjustments for reliable and customizable logging behavior.
+
 ## v1.29.3
 
   - Serialized output now uses `IO#write` with a single string to reduce the chance of interleaved output.
@@ -17,7 +40,7 @@
   - Don't make `Kernel#warn` redirection to `Console.warn` the default behavior, you must `require 'console/warn'` to enable it.
   - Remove deprecated `Console::Logger#failure`.
 
-### Consistent Handling of Exceptions
+### Consistent handling of exceptions.
 
 `Console.call` and all wrapper methods will now consistently handle exceptions that are the last positional argument or keyword argument. This means that the following code will work as expected:
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: console
 version: !ruby/object:Gem::Version
-  version: 1.29.3
+  version: 1.30.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -46,7 +46,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2025-02-19 00:00:00.000000000 Z
+date: 2025-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fiber-annotation
@@ -100,6 +100,7 @@ files:
 - lib/console/capture.rb
 - lib/console/clock.rb
 - lib/console/compatible/logger.rb
+- lib/console/config.rb
 - lib/console/event.rb
 - lib/console/event/failure.rb
 - lib/console/event/generic.rb
@@ -121,6 +122,7 @@ files:
 - lib/console/progress.rb
 - lib/console/resolver.rb
 - lib/console/terminal.rb
+- lib/console/terminal/formatter.rb
 - lib/console/terminal/formatter/failure.rb
 - lib/console/terminal/formatter/progress.rb
 - lib/console/terminal/formatter/spawn.rb