makit 0.0.112 → 0.0.128

data/lib/makit/logging/format_registry.rb

@@ -1,84 +1,84 @@
-# frozen_string_literal: true
-
-module Makit
-  module Logging
-    # Registry for managing available log formatters
-    #
-    # Provides a centralized way to register, retrieve, and manage formatters
-    # by name. This allows for easy extension and configuration of formatters.
-    #
-    # @example Registering a custom formatter
-    #   FormatRegistry.register(:audit, AuditFormatter)
-    #   formatter = FormatRegistry.get(:audit).new
-    #
-    # @example Using built-in formatters
-    #   formatter = FormatRegistry.get(:json).new
-    #   formatter = FormatRegistry.get(:text).new(timestamp_format: "%H:%M:%S")
-    class FormatRegistry
-      @formatters = {}
-
-      class << self
-        # @return [Hash] registered formatters
-        attr_reader :formatters
-
-        # Register a formatter class with a name
-        #
-        # @param name [Symbol, String] the name to register the formatter under
-        # @param formatter_class [Class] the formatter class to register
-        # @return [void]
-        def register(name, formatter_class)
-          @formatters[name.to_sym] = formatter_class
-        end
-
-        # Get a formatter class by name
-        #
-        # @param name [Symbol, String] the name of the formatter
-        # @return [Class] the formatter class
-        # @raise [ArgumentError] if formatter is not found
-        def get(name)
-          @formatters[name.to_sym] || raise(ArgumentError, "Unknown formatter: #{name}")
-        end
-
-        # Get all available formatter names
-        #
-        # @return [Array<Symbol>] list of registered formatter names
-        def available_formats
-          @formatters.keys
-        end
-
-        # Check if a formatter is registered
-        #
-        # @param name [Symbol, String] the name to check
-        # @return [Boolean] true if formatter is registered
-        def registered?(name)
-          @formatters.key?(name.to_sym)
-        end
-
-        # Clear all registered formatters
-        #
-        # @return [void]
-        def clear
-          @formatters.clear
-        end
-
-        # Register built-in formatters
-        #
-        # @return [void]
-        def register_built_ins
-          require_relative "formatters/json_formatter"
-          require_relative "formatters/text_formatter"
-          require_relative "formatters/plain_text_formatter"
-          require_relative "formatters/console_formatter"
-
-          register(:json, Formatters::JsonFormatter)
-          register(:text, Formatters::TextFormatter)
-          register(:plain, Formatters::PlainTextFormatter)
-          register(:console, Formatters::ConsoleFormatter)
-        end
-      end
-
-      # Initialize registry with built-in formatters
-      register_built_ins
-    end
-  end
-end
+# frozen_string_literal: true
+
+module Makit
+  module Logging
+    # Registry for managing available log formatters
+    #
+    # Provides a centralized way to register, retrieve, and manage formatters
+    # by name. This allows for easy extension and configuration of formatters.
+    #
+    # @example Registering a custom formatter
+    #   FormatRegistry.register(:audit, AuditFormatter)
+    #   formatter = FormatRegistry.get(:audit).new
+    #
+    # @example Using built-in formatters
+    #   formatter = FormatRegistry.get(:json).new
+    #   formatter = FormatRegistry.get(:text).new(timestamp_format: "%H:%M:%S")
+    class FormatRegistry
+      @formatters = {}
+
+      class << self
+        # @return [Hash] registered formatters
+        attr_reader :formatters
+
+        # Register a formatter class with a name
+        #
+        # @param name [Symbol, String] the name to register the formatter under
+        # @param formatter_class [Class] the formatter class to register
+        # @return [void]
+        def register(name, formatter_class)
+          @formatters[name.to_sym] = formatter_class
+        end
+
+        # Get a formatter class by name
+        #
+        # @param name [Symbol, String] the name of the formatter
+        # @return [Class] the formatter class
+        # @raise [ArgumentError] if formatter is not found
+        def get(name)
+          @formatters[name.to_sym] || raise(ArgumentError, "Unknown formatter: #{name}")
+        end
+
+        # Get all available formatter names
+        #
+        # @return [Array<Symbol>] list of registered formatter names
+        def available_formats
+          @formatters.keys
+        end
+
+        # Check if a formatter is registered
+        #
+        # @param name [Symbol, String] the name to check
+        # @return [Boolean] true if formatter is registered
+        def registered?(name)
+          @formatters.key?(name.to_sym)
+        end
+
+        # Clear all registered formatters
+        #
+        # @return [void]
+        def clear
+          @formatters.clear
+        end
+
+        # Register built-in formatters
+        #
+        # @return [void]
+        def register_built_ins
+          require_relative "formatters/json_formatter"
+          require_relative "formatters/text_formatter"
+          require_relative "formatters/plain_text_formatter"
+          require_relative "formatters/console_formatter"
+
+          register(:json, Formatters::JsonFormatter)
+          register(:text, Formatters::TextFormatter)
+          register(:plain, Formatters::PlainTextFormatter)
+          register(:console, Formatters::ConsoleFormatter)
+        end
+      end
+
+      # Initialize registry with built-in formatters
+      register_built_ins
+    end
+  end
+end

data/lib/makit/logging/formatters/base.rb

@@ -1,39 +1,39 @@
-# frozen_string_literal: true
-
-module Makit
-  module Logging
-    module Formatters
-      # Base class for all logging formatters
-      #
-      # Formatters handle the conversion of log requests into formatted strings
-      # that can be written to various outputs (console, files, etc.).
-      # This separates formatting concerns from output routing concerns.
-      #
-      # @example Creating a custom formatter
-      #   class CustomFormatter < Base
-      #     def format(log_request)
-      #       "#{log_request.level.upcase}: #{log_request.message}"
-      #     end
-      #   end
-      class Base
-        # Format a log request into a string
-        #
-        # @param log_request [LogRequest] the log request to format
-        # @return [String] the formatted log entry
-        def format(log_request)
-          raise NotImplementedError, "Subclasses must implement #format"
-        end
-
-        # Get formatter configuration
-        #
-        # @return [Hash] formatter configuration
-        def config
-          {
-            name: self.class.name.split("::").last,
-            type: self.class.name,
-          }
-        end
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+module Makit
+  module Logging
+    module Formatters
+      # Base class for all logging formatters
+      #
+      # Formatters handle the conversion of log requests into formatted strings
+      # that can be written to various outputs (console, files, etc.).
+      # This separates formatting concerns from output routing concerns.
+      #
+      # @example Creating a custom formatter
+      #   class CustomFormatter < Base
+      #     def format(log_request)
+      #       "#{log_request.level.upcase}: #{log_request.message}"
+      #     end
+      #   end
+      class Base
+        # Format a log request into a string
+        #
+        # @param log_request [LogRequest] the log request to format
+        # @return [String] the formatted log entry
+        def format(log_request)
+          raise NotImplementedError, "Subclasses must implement #format"
+        end
+
+        # Get formatter configuration
+        #
+        # @return [Hash] formatter configuration
+        def config
+          {
+            name: self.class.name.split("::").last,
+            type: self.class.name,
+          }
+        end
+      end
+    end
+  end
+end

data/lib/makit/logging/formatters/console_formatter.rb

@@ -1,140 +1,140 @@
-# frozen_string_literal: true
-
-begin
-  require "colorize"
-rescue LoadError
-  # colorize gem not available, define a no-op colorize method
-  class String
-    def colorize(*args)
-      self
-    end
-  end
-end
-require_relative "base"
-
-module Makit
-  module Logging
-    module Formatters
-      # Console formatter for colored log output
-      #
-      # Formats log requests for console display with colors, symbols, and optional
-      # timestamps/levels. This is specifically designed for human-readable console output.
-      #
-      # @example
-      #   formatter = ConsoleFormatter.new
-      #   formatted = formatter.format(log_request)
-      #   # => "→ Processing started" (with appropriate color)
-      class ConsoleFormatter < Base
-        # @return [Boolean] whether to show timestamps
-        attr_reader :show_timestamp
-        # @return [Boolean] whether to show log levels
-        attr_reader :show_level
-
-        # Initialize console formatter
-        #
-        # @param show_timestamp [Boolean] whether to show timestamps (default: false)
-        # @param show_level [Boolean] whether to show log levels (default: false)
-        def initialize(show_timestamp: false, show_level: false)
-          @show_timestamp = show_timestamp
-          @show_level = show_level
-        end
-
-        # Format log request for console display
-        #
-        # @param log_request [LogRequest] the log request to format
-        # @return [String] console formatted log entry with colors
-        def format(log_request)
-          parts = []
-
-          # Add timestamp if enabled
-          if @show_timestamp
-            timestamp = log_request.timestamp.strftime("%H:%M:%S")
-            parts << "[#{timestamp}]".colorize(:light_black)
-          end
-
-          # Add log level if enabled
-          if @show_level
-            level_str = log_request.level.to_s.upcase
-            level_color = get_level_color(log_request.level)
-            parts << level_str.colorize(level_color)
-          end
-
-          # Add symbol and message
-          symbol = get_level_symbol(log_request.level)
-          symbol_color = get_level_color(log_request.level)
-          message = log_request.message
-
-          # Special handling for task messages - no symbol, no context, just the message
-          if log_request.context[:task_message]
-            parts << message
-          else
-            # Add context if present (only for non-task messages)
-            if !log_request.context.empty?
-              context_str = log_request.context.map { |k, v| "#{k}=#{v}" }.join(" ")
-              message += " #{context_str}".colorize(:light_black)
-            end
-            parts << "#{symbol} #{message}".colorize(symbol_color)
-          end
-
-          parts.join(" ")
-        end
-
-        # Get formatter configuration
-        #
-        # @return [Hash] formatter configuration
-        def config
-          super.merge(
-            show_timestamp: @show_timestamp,
-            show_level: @show_level,
-          )
-        end
-
-        private
-
-        # Get the color for a log level
-        #
-        # @param level [Symbol] the log level
-        # @return [Symbol] the color for the level
-        def get_level_color(level)
-          case level
-          when :debug
-            :grey
-          when :info
-            :grey
-          when :warn
-            :light_yellow
-          when :error, :fatal
-            :light_red
-          when :success
-            :green
-          else
-            :white
-          end
-        end
-
-        # Get the symbol for a log level
-        #
-        # @param level [Symbol] the log level
-        # @return [String] the symbol for the level
-        def get_level_symbol(level)
-          case level
-          when :debug
-            "•"
-          when :info
-            " " #"→"
-          when :warn
-            "!" #"⚠"
-          when :error
-            "✗"
-          when :fatal
-            "💀"
-          when :success
-            "✓"
-          else
-            "•"
-          end
-        end
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+begin
+  require "colorize"
+rescue LoadError
+  # colorize gem not available, define a no-op colorize method
+  class String
+    def colorize(*_args)
+      self
+    end
+  end
+end
+require_relative "base"
+
+module Makit
+  module Logging
+    module Formatters
+      # Console formatter for colored log output
+      #
+      # Formats log requests for console display with colors, symbols, and optional
+      # timestamps/levels. This is specifically designed for human-readable console output.
+      #
+      # @example
+      #   formatter = ConsoleFormatter.new
+      #   formatted = formatter.format(log_request)
+      #   # => "→ Processing started" (with appropriate color)
+      class ConsoleFormatter < Base
+        # @return [Boolean] whether to show timestamps
+        attr_reader :show_timestamp
+        # @return [Boolean] whether to show log levels
+        attr_reader :show_level
+
+        # Initialize console formatter
+        #
+        # @param show_timestamp [Boolean] whether to show timestamps (default: false)
+        # @param show_level [Boolean] whether to show log levels (default: false)
+        def initialize(show_timestamp: false, show_level: false)
+          @show_timestamp = show_timestamp
+          @show_level = show_level
+        end
+
+        # Format log request for console display
+        #
+        # @param log_request [LogRequest] the log request to format
+        # @return [String] console formatted log entry with colors
+        def format(log_request)
+          parts = []
+
+          # Add timestamp if enabled
+          if @show_timestamp
+            timestamp = log_request.timestamp.strftime("%H:%M:%S")
+            parts << "[#{timestamp}]".colorize(:light_black)
+          end
+
+          # Add log level if enabled
+          if @show_level
+            level_str = log_request.level.to_s.upcase
+            level_color = get_level_color(log_request.level)
+            parts << level_str.colorize(level_color)
+          end
+
+          # Add symbol and message
+          symbol = get_level_symbol(log_request.level)
+          symbol_color = get_level_color(log_request.level)
+          message = log_request.message
+
+          # Special handling for task messages - no symbol, no context, just the message
+          if log_request.context[:task_message]
+            parts << message
+          else
+            # Add context if present (only for non-task messages)
+            unless log_request.context.empty?
+              context_str = log_request.context.map { |k, v| "#{k}=#{v}" }.join(" ")
+              message += " #{context_str}".colorize(:light_black)
+            end
+            parts << "#{symbol} #{message}".colorize(symbol_color)
+          end
+
+          parts.join(" ")
+        end
+
+        # Get formatter configuration
+        #
+        # @return [Hash] formatter configuration
+        def config
+          super.merge(
+            show_timestamp: @show_timestamp,
+            show_level: @show_level,
+          )
+        end
+
+        private
+
+        # Get the color for a log level
+        #
+        # @param level [Symbol] the log level
+        # @return [Symbol] the color for the level
+        def get_level_color(level)
+          case level
+          when :debug
+            :grey
+          when :info
+            :grey
+          when :warn
+            :light_yellow
+          when :error, :fatal
+            :light_red
+          when :success
+            :green
+          else
+            :white
+          end
+        end
+
+        # Get the symbol for a log level
+        #
+        # @param level [Symbol] the log level
+        # @return [String] the symbol for the level
+        def get_level_symbol(level)
+          case level
+          when :debug
+            "•"
+          when :info
+            " " # "→"
+          when :warn
+            "!" # "⚠"
+          when :error
+            "✗"
+          when :fatal
+            "💀"
+          when :success
+            "✓"
+          else
+            "•"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/makit/logging/formatters/json_formatter.rb

@@ -1,65 +1,65 @@
-# frozen_string_literal: true
-
-require "json"
-require_relative "base"
-
-module Makit
-  module Logging
-    module Formatters
-      # JSON formatter for structured logging
-      #
-      # Formats log requests as JSON objects with timestamp, level, message, and context.
-      # This is ideal for log aggregation systems and structured data analysis.
-      #
-      # @example
-      #   formatter = JsonFormatter.new
-      #   formatted = formatter.format(log_request)
-      #   # => '{"timestamp":"2024-01-15T10:30:45Z","level":"INFO","message":"User logged in","context":{"user_id":123}}'
-      class JsonFormatter < Base
-        # @return [Hash] additional options for JSON formatting
-        attr_reader :options
-
-        # Initialize JSON formatter
-        #
-        # @param options [Hash] JSON generation options
-        def initialize(options: {})
-          @options = {
-            indent: nil,
-            space: nil,
-            space_before: nil,
-            object_nl: nil,
-            array_nl: nil,
-            allow_nan: false,
-            max_nesting: 100,
-          }.merge(options)
-        end
-
-        # Format log request as JSON
-        #
-        # @param log_request [LogRequest] the log request to format
-        # @return [String] JSON formatted log entry
-        def format(log_request)
-          log_data = {
-            timestamp: log_request.timestamp.iso8601,
-            level: log_request.level.to_s.upcase,
-            message: log_request.message,
-          }
-
-          # Add context if present
-          log_data[:context] = log_request.context unless log_request.context.empty?
-
-          JSON.generate(log_data, @options)
-        end
-
-        # Get formatter configuration
-        #
-        # @return [Hash] formatter configuration including JSON options
-        def config
-          super.merge(
-            json_options: @options,
-          )
-        end
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+require "json"
+require_relative "base"
+
+module Makit
+  module Logging
+    module Formatters
+      # JSON formatter for structured logging
+      #
+      # Formats log requests as JSON objects with timestamp, level, message, and context.
+      # This is ideal for log aggregation systems and structured data analysis.
+      #
+      # @example
+      #   formatter = JsonFormatter.new
+      #   formatted = formatter.format(log_request)
+      #   # => '{"timestamp":"2024-01-15T10:30:45Z","level":"INFO","message":"User logged in","context":{"user_id":123}}'
+      class JsonFormatter < Base
+        # @return [Hash] additional options for JSON formatting
+        attr_reader :options
+
+        # Initialize JSON formatter
+        #
+        # @param options [Hash] JSON generation options
+        def initialize(options: {})
+          @options = {
+            indent: nil,
+            space: nil,
+            space_before: nil,
+            object_nl: nil,
+            array_nl: nil,
+            allow_nan: false,
+            max_nesting: 100,
+          }.merge(options)
+        end
+
+        # Format log request as JSON
+        #
+        # @param log_request [LogRequest] the log request to format
+        # @return [String] JSON formatted log entry
+        def format(log_request)
+          log_data = {
+            timestamp: log_request.timestamp.iso8601,
+            level: log_request.level.to_s.upcase,
+            message: log_request.message,
+          }
+
+          # Add context if present
+          log_data[:context] = log_request.context unless log_request.context.empty?
+
+          JSON.generate(log_data, @options)
+        end
+
+        # Get formatter configuration
+        #
+        # @return [Hash] formatter configuration including JSON options
+        def config
+          super.merge(
+            json_options: @options,
+          )
+        end
+      end
+    end
+  end
+end