pura-image

require "pura-image"

# Load any format (auto-detected from magic bytes)
image = Pura::Image.load("photo.jpg")
image = Pura::Image.load("icon.webp")
image.width   #=> 800
image.height  #=> 600

# Save to any format (detected from extension)
Pura::Image.save(image, "output.png")

# Convert between formats
Pura::Image.convert("input.bmp", "output.jpg", quality: 85)
Pura::Image.convert("photo.tiff", "photo.png")

image = Pura::Image.load("photo.jpg")

# Resize
image.resize_to_limit(800, 600)   # downsize only, keep aspect ratio
image.resize_to_fit(400, 400)     # resize to fit, keep aspect ratio
image.resize_to_fill(400, 400)    # fill exact size, center crop excess
image.resize_and_pad(400, 400)    # fit within bounds, pad with black
image.resize_to_cover(400, 400)   # cover bounds, no crop

# Transform
image.crop(10, 10, 200, 200)      # crop region
image.rotate(90)                   # rotate 90/180/270 degrees
image.grayscale                    # convert to grayscale

# Chain operations
result = Pura::Image.load("photo.jpg")
  .resize_to_limit(800, 600)
  .rotate(90)
  .grayscale

Pura::Image.save(result, "thumb.jpg", quality: 80)

# Gemfile
gem "image_processing"
gem "pura-image"

# config/application.rb
config.active_storage.variant_processor = :pura

class User < ApplicationRecord
  has_one_attached :avatar do |attachable|
    attachable.variant :thumb, resize_to_limit: [200, 200]
  end
end

require "image_processing/pura"

# Same API as ImageProcessing::Vips
processed = ImageProcessing::Pura
  .source("photo.jpg")
  .resize_to_limit(400, 400)
  .convert("png")
  .call(destination: "output.png")

# Pipeline branching
pipeline = ImageProcessing::Pura.source("photo.jpg")
large  = pipeline.resize_to_limit(800, 800).call(destination: "large.jpg")
medium = pipeline.resize_to_limit(500, 500).call(destination: "medium.jpg")
small  = pipeline.resize_to_limit(300, 300).call(destination: "small.jpg")

# Validation
ImageProcessing::Pura.valid_image?("photo.jpg")  #=> true