Ruby

require 'renamed'# Initialize the clientclient = Renamed::Client.new(api_key: ENV['RENAMED_API_KEY'])# Rename a PDFresult = client.rename(File.read('invoice.pdf'))puts result.suggested_filename# -> "2024-01-15_AcmeCorp_INV-1234.pdf"# Split a multi-page PDFjob = client.pdf_split(File.read('documents.pdf'), mode: 'smart')puts job.documents# -> [{ filename: "...", download_url: "..." }, ...]# Extract structured datadata = client.extract(File.read('receipt.pdf'))puts data# -> { vendor: "...", date: "...", amount: "..." }

require 'renamed'# Initialize the clientclient = Renamed::Client.new(api_key: ENV['RENAMED_API_KEY'])# Read the PDF filepdf_bytes = File.binread('./documents/invoice.pdf')# Rename the PDFresult = client.rename(pdf_bytes)puts "Suggested filename: #{result.suggested_filename}"puts "Confidence: #{result.confidence}"# Output:# Suggested filename: 2024-01-15_AcmeCorp_INV-1234.pdf# Confidence: 0.95# Access extracted metadataputs "Vendor: #{result.metadata[:vendor]}"puts "Date: #{result.metadata[:date]}"puts "Type: #{result.metadata[:type]}"# Use custom naming instructionscustom_result = client.rename(pdf_bytes,  instructions: 'Format: YYYY-MM-DD_VendorName_Amount')puts custom_result.suggested_filename# -> "2024-01-15_AcmeCorp_$1250.pdf"# Rename from a URLurl_result = client.rename_from_url('https://example.com/document.pdf')# Use a block for cleaner file handlingresult = File.open('./documents/invoice.pdf', 'rb') do |file|  client.rename(file.read)end

require 'renamed'require 'fileutils'client = Renamed::Client.new(api_key: ENV['RENAMED_API_KEY'])# Read a multi-page PDFpdf_bytes = File.binread('./documents/combined.pdf')# Submit the split job with smart mode (AI detects document boundaries)job = client.pdf_split(pdf_bytes, mode: 'smart')puts "Job ID: #{job.job_id}"puts "Status: #{job.state}"# Option 1: Wait for completion (built-in polling)completed = job.wait_for_completion# Option 2: Manual polling for progress updates# while job.state == 'processing'#   puts "Progress: #{job.progress}%"#   sleep 1#   job = client.get_job(job.job_id)# end# Process the split documentsputs "Split into #{completed.documents.length} documents:"completed.documents.each_with_index do |doc, i|  puts "  [#{i + 1}] #{doc.filename} (pages #{doc.pages.join(', ')})"  # Output:  # [1] invoice_1.pdf (pages 1, 2)  # [2] invoice_2.pdf (pages 3, 4)  # Download each split document  doc_bytes = client.download_file(doc.download_url)  # Save to output directory  output_path = File.join('./output', doc.filename)  FileUtils.mkdir_p(File.dirname(output_path))  File.binwrite(output_path, doc_bytes)  puts "  Saved: #{output_path}"end# With a timeoutcompleted = job.wait_for_completion(timeout: 300) # 5 minutes

require 'renamed'# Define typed structs for invoice extractionLineItem = Struct.new(:description, :quantity, :unit_price, keyword_init: true)Invoice = Struct.new(  :invoice_number,  :vendor,  :date,  :line_items,  :subtotal,  :tax,  :total,  keyword_init: true)# Initialize the clientclient = Renamed::Client.new(api_key: ENV['RENAMED_API_KEY'])# Read the PDF filepdf_bytes = File.binread('./documents/invoice.pdf')# Basic extraction (returns a Hash with symbol keys)data = client.extract(pdf_bytes)puts "Vendor: #{data[:vendor]}"puts "Date: #{data[:date]}"puts "Total: #{data[:total]}"# Output:# Vendor: Acme Corp# Date: 2024-01-15# Total: 1250.00# Typed extraction: convert to a structline_items = data[:line_items].map do |item|  LineItem.new(    description: item[:description],    quantity: item[:quantity],    unit_price: item[:unit_price]  )endinvoice = Invoice.new(  invoice_number: data[:invoice_number],  vendor: data[:vendor],  date: data[:date],  line_items: line_items,  subtotal: data[:subtotal],  tax: data[:tax],  total: data[:total])# Now you have typed accessputs "Invoice ##{invoice.invoice_number} from #{invoice.vendor}"puts "Line items: #{invoice.line_items.length}"invoice.line_items.each do |item|  puts "  - #{item.description}: #{item.quantity} x $#{'%.2f' % item.unit_price}"endputs "Total: $#{'%.2f' % invoice.total}"# Output:# Invoice #INV-2024-1234 from Acme Corp# Line items: 2#   - Widget Pro: 5 x $199.00#   - Support Plan: 1 x $342.50# Total: $1337.50

require 'renamed'client = Renamed::Client.new(api_key: ENV['RENAMED_API_KEY'])begin  pdf_bytes = File.binread('invoice.pdf')  result = client.rename(pdf_bytes)  puts "Renamed to: #{result.suggested_filename}"rescue Renamed::RateLimitError => e  # Rate limited - wait and retry  puts "Rate limited. Retry after #{e.retry_after} seconds"  sleep e.retry_after  # Retry the request...rescue Renamed::InvalidFileError => e  # File is not a valid PDF or is corrupted  puts "Invalid file: #{e.message}"rescue Renamed::AuthenticationError => e  # API key is invalid or expired  puts "Authentication failed: #{e.message}"rescue Renamed::ApiError => e  # Other API errors  puts "API Error [#{e.code}]: #{e.message}"  puts "Details: #{e.details}" if e.detailsrescue Renamed::NetworkError => e  # Network/connection errors  puts "Network error: #{e.message}"rescue StandardError => e  # Other errors (file I/O, etc.)  puts "Unexpected error: #{e.message}"end# Using retry with exponential backoffdef rename_with_retry(client, pdf_bytes, max_retries: 3)  retries = 0  begin    client.rename(pdf_bytes)  rescue Renamed::RateLimitError => e    retries += 1    raise if retries > max_retries    sleep_time = e.retry_after || (2 ** retries)    puts "Rate limited, retrying in #{sleep_time}s (attempt #{retries}/#{max_retries})"    sleep sleep_time    retry  rescue Renamed::ApiError => e    retries += 1    raise if retries > max_retries || !e.retryable?    sleep_time = 2 ** retries    puts "API error, retrying in #{sleep_time}s (attempt #{retries}/#{max_retries})"    sleep sleep_time    retry  endend