# pdftract-ruby

Ruby SDK for pdftract - PDF extraction and conformance testing.

## Installation

```bash
gem install pdftract -v {{ version }}
```

Or in your Gemfile:

```ruby
gem 'pdftract', '~> {{ version }}'
```

## Usage

### Basic extract

```ruby
require 'pdftract'

client = Pdftract.client
doc = client.extract(Pdftract::PathSource.new('document.pdf'))
puts "Pages: #{doc.pages.length}"
```

### Extract with OCR

```ruby
options = OpenStruct.new(
  ocr_language: 'eng',
  ocr_threshold: 0.7
)

doc = client.extract(Pdftract::PathSource.new('scanned.pdf'), options)
```

### Search

```ruby
client.search(Pdftract::PathSource.new('document.pdf'), 'invoice').each do |match|
  puts "Found on page #{match.page}: #{match.text}"
end
```

### Stream extraction

```ruby
client.extract_stream(Pdftract::PathSource.new('large.pdf')).each do |page|
  puts "Page #{page.page}: #{page.blocks&.length || 0} blocks"
end
```

## Binary version compatibility

This SDK requires pdftract {{ version }}. Download from:
https://github.com/jedarden/pdftract/releases/tag/v{{ version }}

## Troubleshooting

### Binary not found
Ensure `pdftract` is on your PATH. The SDK probes PATH for the executable.

### Version mismatch
The SDK will refuse to invoke mismatched binary versions. Install the correct version.

### Network failure
For remote URLs, check your network connection and TLS certificate chain.