kreuzberg 4.6.1-aarch64-linux → 4.6.2-aarch64-linux

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d632985bd042b73c0e51c84e292d9626267f205992bf49c9c62bcef78d9656f
-  data.tar.gz: ded364d7414b8fb4eafbda15af492698338799eb86749f9708f3f595ab7cad6d
+  metadata.gz: 406c791db1a8cb29e3ff2e89a60e0a29ed73c0ff0548338b60c3574bd5944f6f
+  data.tar.gz: 7565bbe0708afceadc13f43b57103a03529992f705caf21f1ddaa00e68ad27d6
 SHA512:
-  metadata.gz: 5714ba27e6e41a99db90b829cd0c02986eab8c522673f62635ec0c5457d3d7367d290ef1146486fcccdda44fdb55751a99b24758454fdd58c90d93b83b77656e
-  data.tar.gz: ff4e355557401115eb34c227ddc4cd573e6b877f830b5b1a13b749508d202cd691866122e2be4132a883e7c80a4e7bae9f388296c79df7890adbd9aabcb822ca
+  metadata.gz: a680fd2406f8dac338a53ab303ef29d117462cbf376d48be4af48846f7d4f82d4e7999e2aeac17a404e5da7feb79f1cccfb8f240153c0c36a4274e16eeb50f6f
+  data.tar.gz: dc1c1dc215020a65560490e159e38d6780b703bae597279cb0e3d2c369afce7a7bee06984972987d1c3a69fe2040da1cb1e2812df5c542590300dfcb09e5e7d7

data/README.md

@@ -22,7 +22,7 @@
     <img src="https://img.shields.io/maven-central/v/dev.kreuzberg/kreuzberg?label=Java&color=007ec6" alt="Java">
   </a>
   <a href="https://github.com/kreuzberg-dev/kreuzberg/releases">
-    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/kreuzberg?label=Go&color=007ec6&filter=v4.6.1" alt="Go">
+    <img src="https://img.shields.io/github/v/tag/kreuzberg-dev/kreuzberg?label=Go&color=007ec6&filter=v4.6.2" alt="Go">
   </a>
   <a href="https://www.nuget.org/packages/Kreuzberg/">
     <img src="https://img.shields.io/nuget/v/Kreuzberg?label=C%23&color=007ec6" alt="C#">

data/lib/kreuzberg/extraction_api.rb

@@ -319,6 +319,43 @@ module Kreuzberg
       results
     end
 
+    # Render a single PDF page as a PNG image.
+    #
+    # @param path [String, Pathname] Path to the PDF file
+    # @param page_index [Integer] Zero-based page index
+    # @param dpi [Integer] Rendering resolution (default 150)
+    # @return [String] PNG-encoded binary string
+    # @raise [Errors::IOError] If the file cannot be read
+    # @raise [Errors::ParsingError] If rendering fails
+    def render_pdf_page(path, page_index, dpi: 150)
+      path_str = path.to_s
+      raise ArgumentError, 'page_index must be non-negative' if page_index.negative?
+      raise Errors::IOError, "File not found: #{path_str}" unless File.exist?(path_str)
+
+      native_render_pdf_page(path_str, page_index, dpi)
+    end
+
+    # Iterate over pages of a PDF lazily, yielding each page as it is rendered.
+    #
+    # Each page is rendered via the native FFI iterator, so only one page is in
+    # memory at a time.
+    #
+    # @param path [String, Pathname] Path to the PDF file
+    # @param dpi [Integer] Rendering resolution (default 150)
+    # @yieldparam page_index [Integer] Zero-based page index
+    # @yieldparam png_bytes [String] PNG-encoded binary string for the page
+    # @return [Enumerator] if no block is given
+    # @raise [Errors::IOError] If the file cannot be read
+    # @raise [Errors::ParsingError] If rendering fails
+    def render_pdf_pages_iter(path, dpi: 150, &block)
+      path_str = path.to_s
+      raise Errors::IOError, "File not found: #{path_str}" unless File.exist?(path_str)
+
+      return enum_for(:render_pdf_pages_iter, path, dpi: dpi) unless block
+
+      native_render_pdf_pages_iter(path_str, dpi, &block)
+    end
+
     def normalize_config(config)
       return {} if config.nil?
       return config if config.is_a?(Hash)

data/lib/kreuzberg/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Kreuzberg
-  VERSION = '4.6.1'
+  VERSION = '4.6.2'
 end

data/spec/binding/render_spec.rb

@@ -0,0 +1,91 @@
+# Hand-written binding-specific edge case tests for PDF rendering.
+# Happy-path render tests are auto-generated from fixtures in e2e/.
+# These tests cover error handling, validation, and lifecycle patterns
+# that vary per language and can't be generated uniformly.
+
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+RSpec.describe 'PDF Rendering' do
+  it 'exposes rendering methods' do
+    expect(Kreuzberg).to respond_to(:render_pdf_page)
+    expect(Kreuzberg).to respond_to(:render_pdf_pages_iter)
+  end
+
+  describe '.render_pdf_page' do
+    it 'raises an error for a nonexistent file' do
+      expect do
+        Kreuzberg.render_pdf_page('/nonexistent/path/to/document.pdf', 0)
+      end.to raise_error(Kreuzberg::Errors::IOError)
+    end
+
+    it 'raises an error for an out-of-bounds page index' do
+      pdf_path = test_document_path('pdf/tiny.pdf')
+      skip 'Test PDF not available' unless File.exist?(pdf_path)
+
+      expect do
+        Kreuzberg.render_pdf_page(pdf_path, 9999)
+      end.to raise_error(StandardError)
+    end
+  end
+
+  describe '.render_pdf_page with negative index' do
+    it 'raises ArgumentError for a negative page index' do
+      pdf_path = test_document_path('pdf/tiny.pdf')
+      skip 'Test PDF not available' unless File.exist?(pdf_path)
+
+      expect do
+        Kreuzberg.render_pdf_page(pdf_path, -1)
+      end.to raise_error(ArgumentError)
+    end
+  end
+
+  describe '.render_pdf_pages_iter' do
+    it 'raises an error for a nonexistent file' do
+      expect do
+        Kreuzberg.render_pdf_pages_iter('/nonexistent/path/to/document.pdf') { |_, _| nil }
+      end.to raise_error(Kreuzberg::Errors::IOError)
+    end
+  end
+
+  describe '.render_pdf_page with empty path' do
+    it 'raises an error for an empty path' do
+      expect do
+        Kreuzberg.render_pdf_page('', 0)
+      end.to raise_error(StandardError)
+    end
+  end
+
+  describe '.render_pdf_pages_iter cleanup' do
+    it 'handles iterator cleanup without fully consuming' do
+      pdf_path = test_document_path('pdf/tiny.pdf')
+      skip 'Test PDF not available' unless File.exist?(pdf_path)
+
+      # Iterate but stop immediately — no crash
+      Kreuzberg.render_pdf_pages_iter(pdf_path) do |_page_index, _png_data|
+        break
+      end
+    end
+  end
+
+  describe '.render_pdf_pages_iter early termination' do
+    it 'returns valid PNG for the first page then stops' do
+      pdf_path = test_document_path('pdf/tiny.pdf')
+      skip 'Test PDF not available' unless File.exist?(pdf_path)
+
+      first_png = nil
+      Kreuzberg.render_pdf_pages_iter(pdf_path) do |page_index, png_data|
+        expect(page_index).to eq(0)
+        expect(png_data).to be_a(String)
+        expect(png_data.bytesize).to be > 8
+        # PNG magic bytes
+        expect(png_data.bytes[0..3]).to eq([0x89, 0x50, 0x4E, 0x47])
+        first_png = png_data
+        break
+      end
+
+      expect(first_png).not_to be_nil
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: kreuzberg
 version: !ruby/object:Gem::Version
-  version: 4.6.1
+  version: 4.6.2
 platform: aarch64-linux
 authors:
 - Na'aman Hirschfeld
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-25 00:00:00.000000000 Z
+date: 2026-03-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -220,6 +220,7 @@ files:
 - spec/binding/plugins/ocr_backend_spec.rb
 - spec/binding/plugins/postprocessor_spec.rb
 - spec/binding/plugins/validator_spec.rb
+- spec/binding/render_spec.rb
 - spec/binding/tables_spec.rb
 - spec/serialization_spec.rb
 - spec/smoke/package_spec.rb