BraveSearch Ruby Gem

gem 'brave_search'

client = BraveSearch::Client.new(api_key: 'your_api_key')
results = client.search(q: 'ruby programming', count: 10)

# Results wrapper with convenience methods
puts results.web_results.first[:title]  
puts "Found #{results.count} total results"

# Different search types
web_results = client.search(q: 'ruby programming')
news_results = client.news_search(q: 'ruby news')  
video_results = client.video_search(q: 'ruby tutorials')
image_results = client.image_search(q: 'ruby logo')

# Suggestions and spellcheck
suggestions = client.suggest(q: 'ruby prog')
spelling = client.spellcheck(q: 'rubyy')

results = client.search(q: 'ruby programming')

case results
in { web: { results: [first, *rest] }, query: { original: String => query } }
  puts "Found #{rest.length + 1} results for: '#{query}'"
  puts "Top result: #{first[:title]}"
in { web: { results: [] } }
  puts "No results found"
else
  puts "Unexpected response"
end

require 'async'

async_client = BraveSearch::AsyncClient.new

# Single async search
Async do
  result = async_client.search(q: 'ruby programming').wait
  puts result.web_results.first[:title]
end

# Concurrent searches
Async do
  results = async_client.concurrent_search([
    'ruby programming',
    'rails framework',
    'async ruby'
  ]).wait
  
  results.each { |r| puts "Found #{r.count} results" }
end

# Configure storage
BraveSearch.configure do |config|
  config.storage_provider = :hetzner
  config.storage_bucket = "research-papers"
  config.storage_endpoint = "https://fsn1.your-objectstorage.com"
end

# Search and download PDFs automatically
client = BraveSearch::Client.new
downloaded = client.search_and_download_pdfs(
  q: "machine learning papers filetype:pdf",
  count: 5,
  folder: "ml-papers/#{Date.today}"
) do |completed, total|
  puts "Downloaded #{completed}/#{total} PDFs"
end

# Manual PDF extraction and download
results = client.search(q: "research papers filetype:pdf")
pdf_urls = results.pdf_urls
puts "Found #{pdf_urls.length} PDFs"

# Download to specific storage
storage = BraveSearch::Storage.for(:digitalocean, 
  bucket: "documents", 
  endpoint: "https://nyc3.digitaloceanspaces.com"
)

results.download_pdfs(storage: storage, folder: "research") do |completed, total|
  puts "Progress: #{completed}/#{total}"
end

client = BraveSearch::Client.new
results = client.search(q: 'ruby on rails')

BraveSearch.configure do |config|
  config.api_key = 'your_api_key'
  config.timeout = 30
  config.retry_attempts = 3
end