makit 0.0.139 → 0.0.140

data/lib/makit/logging/sinks/console.rb

@@ -1,72 +1,72 @@
-# frozen_string_literal: true
-
-require_relative "unified_file_sink"
-
-module Makit
-  module Logging
-    module Sinks
-      # Console sink for clean, colored log output
-      #
-      # This is a thin wrapper around UnifiedFileSink that provides a simple
-      # API for console output. It maintains backward compatibility while
-      # leveraging the unified logging architecture.
-      #
-      # @example Basic usage
-      #   console = Console.new
-      #   logger = Logger.new(sinks: [console])
-      #   logger.info("Processing started")
-      #   # Shows: → Processing started
-      #
-      # @example With custom formatter options
-      #   console = Console.new(show_timestamp: true, show_level: true)
-      #
-      # @example With custom formatter
-      #   console = Console.new(formatter: :text)
-      class Console < UnifiedFileSink
-        # @return [Symbol] the format being used
-        attr_reader :format
-
-        # Initialize console sink
-        #
-        # @param formatter [Symbol, String] formatter name (default: :console)
-        # @param show_timestamp [Boolean] whether to show timestamps (default: false)
-        # @param show_level [Boolean] whether to show log levels (default: false)
-        # @param formatter_options [Hash] additional formatter options
-        def initialize(formatter: :console, show_timestamp: false, show_level: false, **formatter_options)
-          @format = formatter.to_sym
-
-          # Build configuration for UnifiedFileSink
-          configuration = {
-            file: $stdout,
-            format: @format,
-            formatter_options: {
-              show_timestamp: show_timestamp,
-              show_level: show_level,
-            }.merge(formatter_options),
-          }
-
-          super(configurations: [configuration])
-        end
-
-        # Get sink configuration
-        #
-        # @return [Hash] sink configuration
-        def config
-          {
-            name: self.class.name.split("::").last,
-            format: @format,
-            colors_enabled: true,
-            unified_sink: true,
-          }
-        end
-
-        # Check if this is a console sink (for compatibility)
-        #
-        # @return [Boolean] always true for Console sink
-        def console?
-          true
-        end
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+require_relative "unified_file_sink"
+
+module Makit
+  module Logging
+    module Sinks
+      # Console sink for clean, colored log output
+      #
+      # This is a thin wrapper around UnifiedFileSink that provides a simple
+      # API for console output. It maintains backward compatibility while
+      # leveraging the unified logging architecture.
+      #
+      # @example Basic usage
+      #   console = Console.new
+      #   logger = Logger.new(sinks: [console])
+      #   logger.info("Processing started")
+      #   # Shows: → Processing started
+      #
+      # @example With custom formatter options
+      #   console = Console.new(show_timestamp: true, show_level: true)
+      #
+      # @example With custom formatter
+      #   console = Console.new(formatter: :text)
+      class Console < UnifiedFileSink
+        # @return [Symbol] the format being used
+        attr_reader :format
+
+        # Initialize console sink
+        #
+        # @param formatter [Symbol, String] formatter name (default: :console)
+        # @param show_timestamp [Boolean] whether to show timestamps (default: false)
+        # @param show_level [Boolean] whether to show log levels (default: false)
+        # @param formatter_options [Hash] additional formatter options
+        def initialize(formatter: :console, show_timestamp: false, show_level: false, **formatter_options)
+          @format = formatter.to_sym
+
+          # Build configuration for UnifiedFileSink
+          configuration = {
+            file: $stdout,
+            format: @format,
+            formatter_options: {
+              show_timestamp: show_timestamp,
+              show_level: show_level,
+            }.merge(formatter_options),
+          }
+
+          super(configurations: [configuration])
+        end
+
+        # Get sink configuration
+        #
+        # @return [Hash] sink configuration
+        def config
+          {
+            name: self.class.name.split("::").last,
+            format: @format,
+            colors_enabled: true,
+            unified_sink: true,
+          }
+        end
+
+        # Check if this is a console sink (for compatibility)
+        #
+        # @return [Boolean] always true for Console sink
+        def console?
+          true
+        end
+      end
+    end
+  end
+end

data/lib/makit/logging/sinks/file_sink.rb

@@ -1,92 +1,92 @@
-# frozen_string_literal: true
-
-require_relative "unified_file_sink"
-
-module Makit
-  module Logging
-    module Sinks
-      # File sink for writing log entries to files
-      #
-      # This sink is a thin wrapper around UnifiedFileSink that provides
-      # a simpler API for single-file logging. It maintains backward compatibility
-      # with the original FileSink interface while leveraging the more robust
-      # UnifiedFileSink implementation.
-      #
-      # @example Basic usage with default JSON formatter
-      #   file_sink = FileSink.new(log_file: "makit.log")
-      #   logger = Logger.new(sinks: [file_sink])
-      #   logger.info("Processing started")
-      #
-      # @example Using built-in formatters
-      #   file_sink = FileSink.new(
-      #     log_file: "makit.log",
-      #     formatter: :text
-      #   )
-      #
-      # @example Using custom formatter options
-      #   file_sink = FileSink.new(
-      #     log_file: "makit.log",
-      #     formatter: :json,
-      #     include_context: true,
-      #     include_metadata: true
-      #   )
-      class FileSink < Base
-        # @return [String] path to the log file
-        attr_reader :log_file
-        # @return [Symbol] the formatter format name
-        attr_reader :formatter
-        # @return [Boolean] whether to append to existing file (true) or overwrite (false)
-        attr_reader :append
-        # @return [UnifiedFileSink] the underlying unified sink
-        attr_reader :unified_sink
-
-        # Initialize file sink
-        #
-        # @param log_file [String] path to the log file
-        # @param formatter [Symbol, String] formatter format name
-        # @param append [Boolean] whether to append to existing file (true) or overwrite (false)
-        # @param include_context [Boolean] whether to include context in formatted output
-        # @param include_metadata [Boolean] whether to include metadata in formatted output
-        # @param show_timestamp [Boolean] whether to show timestamp in formatted output
-        # @param show_level [Boolean] whether to show log level in formatted output
-        def initialize(log_file: "makit.log", formatter: :json, append: true, **formatter_options)
-          @log_file = log_file
-          @formatter = formatter.to_sym
-          @append = append
-
-          # Create unified sink configuration
-          config = {
-            file: @log_file,
-            format: @formatter,
-            append: @append,
-          }.merge(formatter_options)
-
-          @unified_sink = UnifiedFileSink.new(configurations: [config])
-        end
-
-        # Execute sink logic to write log entry to file
-        #
-        # @param log_request [LogRequest] the log request to process
-        # @yield [LogRequest] yields the processed log request to the next sink
-        # @yieldreturn [LogRequest] the processed log request
-        # @return [LogRequest] the final processed log request
-        def call(log_request, &block)
-          @unified_sink.call(log_request, &block)
-        end
-
-        # Get sink configuration
-        #
-        # @return [Hash] sink configuration
-        def config
-          {
-            name: self.class.name.split("::").last,
-            log_file: @log_file,
-            formatter: @formatter,
-            append: @append,
-            unified_config: @unified_sink.config,
-          }
-        end
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+require_relative "unified_file_sink"
+
+module Makit
+  module Logging
+    module Sinks
+      # File sink for writing log entries to files
+      #
+      # This sink is a thin wrapper around UnifiedFileSink that provides
+      # a simpler API for single-file logging. It maintains backward compatibility
+      # with the original FileSink interface while leveraging the more robust
+      # UnifiedFileSink implementation.
+      #
+      # @example Basic usage with default JSON formatter
+      #   file_sink = FileSink.new(log_file: "makit.log")
+      #   logger = Logger.new(sinks: [file_sink])
+      #   logger.info("Processing started")
+      #
+      # @example Using built-in formatters
+      #   file_sink = FileSink.new(
+      #     log_file: "makit.log",
+      #     formatter: :text
+      #   )
+      #
+      # @example Using custom formatter options
+      #   file_sink = FileSink.new(
+      #     log_file: "makit.log",
+      #     formatter: :json,
+      #     include_context: true,
+      #     include_metadata: true
+      #   )
+      class FileSink < Base
+        # @return [String] path to the log file
+        attr_reader :log_file
+        # @return [Symbol] the formatter format name
+        attr_reader :formatter
+        # @return [Boolean] whether to append to existing file (true) or overwrite (false)
+        attr_reader :append
+        # @return [UnifiedFileSink] the underlying unified sink
+        attr_reader :unified_sink
+
+        # Initialize file sink
+        #
+        # @param log_file [String] path to the log file
+        # @param formatter [Symbol, String] formatter format name
+        # @param append [Boolean] whether to append to existing file (true) or overwrite (false)
+        # @param include_context [Boolean] whether to include context in formatted output
+        # @param include_metadata [Boolean] whether to include metadata in formatted output
+        # @param show_timestamp [Boolean] whether to show timestamp in formatted output
+        # @param show_level [Boolean] whether to show log level in formatted output
+        def initialize(log_file: "makit.log", formatter: :json, append: true, **formatter_options)
+          @log_file = log_file
+          @formatter = formatter.to_sym
+          @append = append
+
+          # Create unified sink configuration
+          config = {
+            file: @log_file,
+            format: @formatter,
+            append: @append,
+          }.merge(formatter_options)
+
+          @unified_sink = UnifiedFileSink.new(configurations: [config])
+        end
+
+        # Execute sink logic to write log entry to file
+        #
+        # @param log_request [LogRequest] the log request to process
+        # @yield [LogRequest] yields the processed log request to the next sink
+        # @yieldreturn [LogRequest] the processed log request
+        # @return [LogRequest] the final processed log request
+        def call(log_request, &block)
+          @unified_sink.call(log_request, &block)
+        end
+
+        # Get sink configuration
+        #
+        # @return [Hash] sink configuration
+        def config
+          {
+            name: self.class.name.split("::").last,
+            log_file: @log_file,
+            formatter: @formatter,
+            append: @append,
+            unified_config: @unified_sink.config,
+          }
+        end
+      end
+    end
+  end
+end

data/lib/makit/logging/sinks/structured.rb

@@ -1,123 +1,123 @@
-# frozen_string_literal: true
-
-require_relative "base"
-
-module Makit
-  module Logging
-    module Sinks
-      # Structured sink for adding metadata to log requests
-      #
-      # This sink enriches log requests with structured metadata like
-      # process information, thread details, and other contextual data that
-      # can be useful for debugging and monitoring. It follows the same
-      # pattern as other sinks but focuses on data enrichment rather than output.
-      #
-      # @example Basic usage
-      #   structured_sink = Structured.new
-      #   logger = Logger.new(sinks: [structured_sink])
-      #   logger.info("Processing started")
-      #   # Adds metadata like process_id, thread_id, etc.
-      #
-      # @example With custom metadata
-      #   structured_sink = Structured.new(
-      #     custom_metadata: { environment: "production" }
-      #   )
-      class Structured < Base
-        # Initialize structured sink
-        #
-        # @param include_process_info [Boolean] whether to include process information
-        # @param include_thread_info [Boolean] whether to include thread information
-        # @param include_timing [Boolean] whether to include timing information
-        # @param custom_metadata [Hash] custom metadata to add to all log requests
-        def initialize(include_process_info: true, include_thread_info: true, include_timing: true, custom_metadata: {})
-          @include_process_info = include_process_info
-          @include_thread_info = include_thread_info
-          @include_timing = include_timing
-          @custom_metadata = custom_metadata.dup
-        end
-
-        # Execute sink logic to add structured metadata
-        #
-        # @param log_request [LogRequest] the log request to process
-        # @yield [LogRequest] yields the processed log request to the next sink
-        # @yieldreturn [LogRequest] the processed log request
-        # @return [LogRequest] the final processed log request
-        def call(log_request, &block)
-          add_structured_metadata(log_request)
-          block&.call(log_request) if block_given?
-          log_request
-        end
-
-        # Get sink configuration
-        #
-        # @return [Hash] sink configuration
-        def config
-          {
-            name: self.class.name.split("::").last,
-            include_process_info: @include_process_info,
-            include_thread_info: @include_thread_info,
-            include_timing: @include_timing,
-            custom_metadata: @custom_metadata,
-          }
-        end
-
-        private
-
-        # Add structured metadata to the log request
-        #
-        # @param log_request [LogRequest] the log request to enrich
-        def add_structured_metadata(log_request)
-          metadata = {}
-
-          # Add process information
-          metadata.merge!(get_process_metadata) if @include_process_info
-
-          # Add thread information
-          metadata.merge!(get_thread_metadata) if @include_thread_info
-
-          # Add timing information
-          metadata.merge!(get_timing_metadata) if @include_timing
-
-          # Add custom metadata
-          metadata.merge!(@custom_metadata)
-
-          # Add to log request
-          log_request.add_metadata(metadata)
-        end
-
-        # Get process-related metadata
-        #
-        # @return [Hash] process metadata
-        def get_process_metadata
-          {
-            process_id: ::Process.pid,
-            process_title: $PROGRAM_NAME,
-            ruby_version: RUBY_VERSION,
-            ruby_platform: RUBY_PLATFORM,
-          }
-        end
-
-        # Get thread-related metadata
-        #
-        # @return [Hash] thread metadata
-        def get_thread_metadata
-          {
-            thread_id: Thread.current.object_id,
-            thread_name: Thread.current.name || "main",
-          }
-        end
-
-        # Get timing-related metadata
-        #
-        # @return [Hash] timing metadata
-        def get_timing_metadata
-          {
-            timestamp: Time.now.iso8601,
-            unix_timestamp: Time.now.to_i,
-            timezone: Time.now.zone,
-          }
-        end
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+require_relative "base"
+
+module Makit
+  module Logging
+    module Sinks
+      # Structured sink for adding metadata to log requests
+      #
+      # This sink enriches log requests with structured metadata like
+      # process information, thread details, and other contextual data that
+      # can be useful for debugging and monitoring. It follows the same
+      # pattern as other sinks but focuses on data enrichment rather than output.
+      #
+      # @example Basic usage
+      #   structured_sink = Structured.new
+      #   logger = Logger.new(sinks: [structured_sink])
+      #   logger.info("Processing started")
+      #   # Adds metadata like process_id, thread_id, etc.
+      #
+      # @example With custom metadata
+      #   structured_sink = Structured.new(
+      #     custom_metadata: { environment: "production" }
+      #   )
+      class Structured < Base
+        # Initialize structured sink
+        #
+        # @param include_process_info [Boolean] whether to include process information
+        # @param include_thread_info [Boolean] whether to include thread information
+        # @param include_timing [Boolean] whether to include timing information
+        # @param custom_metadata [Hash] custom metadata to add to all log requests
+        def initialize(include_process_info: true, include_thread_info: true, include_timing: true, custom_metadata: {})
+          @include_process_info = include_process_info
+          @include_thread_info = include_thread_info
+          @include_timing = include_timing
+          @custom_metadata = custom_metadata.dup
+        end
+
+        # Execute sink logic to add structured metadata
+        #
+        # @param log_request [LogRequest] the log request to process
+        # @yield [LogRequest] yields the processed log request to the next sink
+        # @yieldreturn [LogRequest] the processed log request
+        # @return [LogRequest] the final processed log request
+        def call(log_request, &block)
+          add_structured_metadata(log_request)
+          block&.call(log_request) if block_given?
+          log_request
+        end
+
+        # Get sink configuration
+        #
+        # @return [Hash] sink configuration
+        def config
+          {
+            name: self.class.name.split("::").last,
+            include_process_info: @include_process_info,
+            include_thread_info: @include_thread_info,
+            include_timing: @include_timing,
+            custom_metadata: @custom_metadata,
+          }
+        end
+
+        private
+
+        # Add structured metadata to the log request
+        #
+        # @param log_request [LogRequest] the log request to enrich
+        def add_structured_metadata(log_request)
+          metadata = {}
+
+          # Add process information
+          metadata.merge!(get_process_metadata) if @include_process_info
+
+          # Add thread information
+          metadata.merge!(get_thread_metadata) if @include_thread_info
+
+          # Add timing information
+          metadata.merge!(get_timing_metadata) if @include_timing
+
+          # Add custom metadata
+          metadata.merge!(@custom_metadata)
+
+          # Add to log request
+          log_request.add_metadata(metadata)
+        end
+
+        # Get process-related metadata
+        #
+        # @return [Hash] process metadata
+        def get_process_metadata
+          {
+            process_id: ::Process.pid,
+            process_title: $PROGRAM_NAME,
+            ruby_version: RUBY_VERSION,
+            ruby_platform: RUBY_PLATFORM,
+          }
+        end
+
+        # Get thread-related metadata
+        #
+        # @return [Hash] thread metadata
+        def get_thread_metadata
+          {
+            thread_id: Thread.current.object_id,
+            thread_name: Thread.current.name || "main",
+          }
+        end
+
+        # Get timing-related metadata
+        #
+        # @return [Hash] timing metadata
+        def get_timing_metadata
+          {
+            timestamp: Time.now.iso8601,
+            unix_timestamp: Time.now.to_i,
+            timezone: Time.now.zone,
+          }
+        end
+      end
+    end
+  end
+end