kreuzberg 4.0.0.pre.rc.13 → 4.0.0.pre.rc.15

data/lib/kreuzberg/error_context.rb

@@ -1,80 +1,80 @@
-# frozen_string_literal: true
-
-require 'json'
-
-module Kreuzberg
-  # ErrorContext module provides access to FFI error introspection functions.
-  #
-  # This module retrieves detailed error and panic context information from the native
-  # Rust core. It allows inspection of the last error that occurred during extraction,
-  # including panic information with file, line, function, and timestamp details.
-  module ErrorContext
-    class << self
-      # Get the error code of the last operation.
-      #
-      # Returns the error code from the last FFI call. Returns 0 (SUCCESS) if no error
-      # occurred or if introspection fails.
-      #
-      # @return [Integer] Error code constant (ERROR_CODE_* values), or 0 on success
-      #
-      # @example Check last error
-      #   code = Kreuzberg::ErrorContext.last_error_code
-      #   case code
-      #   when Kreuzberg::ERROR_CODE_IO
-      #     puts "I/O error occurred"
-      #   when Kreuzberg::ERROR_CODE_PARSING
-      #     puts "Parsing error occurred"
-      #   else
-      #     puts "Success or unknown error"
-      #   end
-      def last_error_code
-        Kreuzberg._last_error_code_native
-      rescue StandardError
-        0
-      end
-
-      # Get panic context information from the last error.
-      #
-      # Returns a {Errors::PanicContext} object containing detailed information about
-      # the last panic that occurred in the Rust core. Includes file path, line number,
-      # function name, error message, and timestamp.
-      #
-      # @return [Errors::PanicContext, nil] Panic context if a panic occurred, nil otherwise
-      #
-      # @example Get panic details
-      #   panic = Kreuzberg::ErrorContext.last_panic_context
-      #   if panic
-      #     puts "Panic at #{panic.file}:#{panic.line} in #{panic.function}"
-      #     puts "Message: #{panic.message}"
-      #     puts "Time: #{panic.timestamp_secs}"
-      #   end
-      def last_panic_context
-        json_str = Kreuzberg._last_panic_context_json_native
-        return nil unless json_str
-
-        Errors::PanicContext.from_json(json_str)
-      rescue StandardError
-        nil
-      end
-
-      # Get panic context as raw JSON string.
-      #
-      # Returns the panic context information as a JSON string for raw access or
-      # custom parsing. Returns nil if no panic has occurred.
-      #
-      # @return [String, nil] JSON-serialized panic context, or nil if no panic
-      #
-      # @example Get raw JSON panic context
-      #   json = Kreuzberg::ErrorContext.last_panic_context_json
-      #   if json
-      #     panic_data = JSON.parse(json)
-      #     puts panic_data
-      #   end
-      def last_panic_context_json
-        Kreuzberg._last_panic_context_json_native
-      rescue StandardError
-        nil
-      end
-    end
-  end
-end
+# frozen_string_literal: true
+
+require 'json'
+
+module Kreuzberg
+  # ErrorContext module provides access to FFI error introspection functions.
+  #
+  # This module retrieves detailed error and panic context information from the native
+  # Rust core. It allows inspection of the last error that occurred during extraction,
+  # including panic information with file, line, function, and timestamp details.
+  module ErrorContext
+    class << self
+      # Get the error code of the last operation.
+      #
+      # Returns the error code from the last FFI call. Returns 0 (SUCCESS) if no error
+      # occurred or if introspection fails.
+      #
+      # @return [Integer] Error code constant (ERROR_CODE_* values), or 0 on success
+      #
+      # @example Check last error
+      #   code = Kreuzberg::ErrorContext.last_error_code
+      #   case code
+      #   when Kreuzberg::ERROR_CODE_IO
+      #     puts "I/O error occurred"
+      #   when Kreuzberg::ERROR_CODE_PARSING
+      #     puts "Parsing error occurred"
+      #   else
+      #     puts "Success or unknown error"
+      #   end
+      def last_error_code
+        Kreuzberg._last_error_code_native
+      rescue StandardError
+        0
+      end
+
+      # Get panic context information from the last error.
+      #
+      # Returns a {Errors::PanicContext} object containing detailed information about
+      # the last panic that occurred in the Rust core. Includes file path, line number,
+      # function name, error message, and timestamp.
+      #
+      # @return [Errors::PanicContext, nil] Panic context if a panic occurred, nil otherwise
+      #
+      # @example Get panic details
+      #   panic = Kreuzberg::ErrorContext.last_panic_context
+      #   if panic
+      #     puts "Panic at #{panic.file}:#{panic.line} in #{panic.function}"
+      #     puts "Message: #{panic.message}"
+      #     puts "Time: #{panic.timestamp_secs}"
+      #   end
+      def last_panic_context
+        json_str = Kreuzberg._last_panic_context_json_native
+        return nil unless json_str
+
+        Errors::PanicContext.from_json(json_str)
+      rescue StandardError
+        nil
+      end
+
+      # Get panic context as raw JSON string.
+      #
+      # Returns the panic context information as a JSON string for raw access or
+      # custom parsing. Returns nil if no panic has occurred.
+      #
+      # @return [String, nil] JSON-serialized panic context, or nil if no panic
+      #
+      # @example Get raw JSON panic context
+      #   json = Kreuzberg::ErrorContext.last_panic_context_json
+      #   if json
+      #     panic_data = JSON.parse(json)
+      #     puts panic_data
+      #   end
+      def last_panic_context_json
+        Kreuzberg._last_panic_context_json_native
+      rescue StandardError
+        nil
+      end
+    end
+  end
+end

data/lib/kreuzberg/errors.rb

@@ -1,118 +1,118 @@
-# frozen_string_literal: true
-
-require 'json'
-
-module Kreuzberg
-  # Error code constants matching kreuzberg-ffi error codes
-  ERROR_CODE_SUCCESS = 0
-  ERROR_CODE_GENERIC = 1
-  ERROR_CODE_PANIC = 2
-  ERROR_CODE_INVALID_ARGUMENT = 3
-  ERROR_CODE_IO = 4
-  ERROR_CODE_PARSING = 5
-  ERROR_CODE_OCR = 6
-  ERROR_CODE_MISSING_DEPENDENCY = 7
-
-  module Errors
-    # Panic context information from FFI error introspection
-    class PanicContext
-      attr_reader :file, :line, :function, :message, :timestamp_secs
-
-      def initialize(file:, line:, function:, message:, timestamp_secs:)
-        @file = file
-        @line = line
-        @function = function
-        @message = message
-        @timestamp_secs = timestamp_secs
-      end
-
-      def to_s
-        "#{file}:#{line}:#{function}: #{message}"
-      end
-
-      def to_h
-        {
-          file:,
-          line:,
-          function:,
-          message:,
-          timestamp_secs:
-        }
-      end
-
-      def self.from_json(json_string)
-        return nil if json_string.nil? || json_string.empty?
-
-        data = JSON.parse(json_string, symbolize_names: true)
-        sliced = data.slice(:file, :line, :function, :message, :timestamp_secs)
-        new(**with_defaults(sliced))
-      rescue JSON::ParserError
-        nil
-      end
-
-      def self.with_defaults(sliced)
-        {
-          file: sliced[:file] || '',
-          line: sliced[:line] || 0,
-          function: sliced[:function] || '',
-          message: sliced[:message] || '',
-          timestamp_secs: sliced[:timestamp_secs] || 0
-        }
-      end
-      private_class_method :with_defaults
-    end
-
-    # Base error class for all Kreuzberg errors
-    class Error < StandardError
-      attr_reader :panic_context, :error_code
-
-      def initialize(message, panic_context: nil, error_code: nil)
-        super(message)
-        @panic_context = panic_context
-        @error_code = error_code
-      end
-    end
-
-    # Raised when validation fails
-    class ValidationError < Error; end
-
-    # Raised when document parsing fails
-    class ParsingError < Error
-      attr_reader :context
-
-      def initialize(message, context: nil, panic_context: nil, error_code: nil)
-        super(message, panic_context:, error_code:)
-        @context = context
-      end
-    end
-
-    # Raised when OCR processing fails
-    class OCRError < Error
-      attr_reader :context
-
-      def initialize(message, context: nil, panic_context: nil, error_code: nil)
-        super(message, panic_context:, error_code:)
-        @context = context
-      end
-    end
-
-    # Raised when a required dependency is missing
-    class MissingDependencyError < Error
-      attr_reader :dependency
-
-      def initialize(message, dependency: nil, panic_context: nil, error_code: nil)
-        super(message, panic_context:, error_code:)
-        @dependency = dependency
-      end
-    end
-
-    # Raised when an I/O operation fails
-    class IOError < Error; end
-
-    # Raised when plugin operations fail
-    class PluginError < Error; end
-
-    # Raised when an unsupported file format or MIME type is encountered
-    class UnsupportedFormatError < Error; end
-  end
-end
+# frozen_string_literal: true
+
+require 'json'
+
+module Kreuzberg
+  # Error code constants matching kreuzberg-ffi error codes
+  ERROR_CODE_SUCCESS = 0
+  ERROR_CODE_GENERIC = 1
+  ERROR_CODE_PANIC = 2
+  ERROR_CODE_INVALID_ARGUMENT = 3
+  ERROR_CODE_IO = 4
+  ERROR_CODE_PARSING = 5
+  ERROR_CODE_OCR = 6
+  ERROR_CODE_MISSING_DEPENDENCY = 7
+
+  module Errors
+    # Panic context information from FFI error introspection
+    class PanicContext
+      attr_reader :file, :line, :function, :message, :timestamp_secs
+
+      def initialize(file:, line:, function:, message:, timestamp_secs:)
+        @file = file
+        @line = line
+        @function = function
+        @message = message
+        @timestamp_secs = timestamp_secs
+      end
+
+      def to_s
+        "#{file}:#{line}:#{function}: #{message}"
+      end
+
+      def to_h
+        {
+          file:,
+          line:,
+          function:,
+          message:,
+          timestamp_secs:
+        }
+      end
+
+      def self.from_json(json_string)
+        return nil if json_string.nil? || json_string.empty?
+
+        data = JSON.parse(json_string, symbolize_names: true)
+        sliced = data.slice(:file, :line, :function, :message, :timestamp_secs)
+        new(**with_defaults(sliced))
+      rescue JSON::ParserError
+        nil
+      end
+
+      def self.with_defaults(sliced)
+        {
+          file: sliced[:file] || '',
+          line: sliced[:line] || 0,
+          function: sliced[:function] || '',
+          message: sliced[:message] || '',
+          timestamp_secs: sliced[:timestamp_secs] || 0
+        }
+      end
+      private_class_method :with_defaults
+    end
+
+    # Base error class for all Kreuzberg errors
+    class Error < StandardError
+      attr_reader :panic_context, :error_code
+
+      def initialize(message, panic_context: nil, error_code: nil)
+        super(message)
+        @panic_context = panic_context
+        @error_code = error_code
+      end
+    end
+
+    # Raised when validation fails
+    class ValidationError < Error; end
+
+    # Raised when document parsing fails
+    class ParsingError < Error
+      attr_reader :context
+
+      def initialize(message, context: nil, panic_context: nil, error_code: nil)
+        super(message, panic_context:, error_code:)
+        @context = context
+      end
+    end
+
+    # Raised when OCR processing fails
+    class OCRError < Error
+      attr_reader :context
+
+      def initialize(message, context: nil, panic_context: nil, error_code: nil)
+        super(message, panic_context:, error_code:)
+        @context = context
+      end
+    end
+
+    # Raised when a required dependency is missing
+    class MissingDependencyError < Error
+      attr_reader :dependency
+
+      def initialize(message, dependency: nil, panic_context: nil, error_code: nil)
+        super(message, panic_context:, error_code:)
+        @dependency = dependency
+      end
+    end
+
+    # Raised when an I/O operation fails
+    class IOError < Error; end
+
+    # Raised when plugin operations fail
+    class PluginError < Error; end
+
+    # Raised when an unsupported file format or MIME type is encountered
+    class UnsupportedFormatError < Error; end
+  end
+end