Ruby & Rails SDK

Ruby on Rails, Sinatra 및 Sidekiq 백그라운드 환경을 위한 공식 smallpict gem.

공식 SmallPict Ruby gem은 Ruby 3.0+ 및 Ruby on Rails 프레임워크와 호환됩니다.

패키지 설치

Shell

gem install smallpict# 또는 Gemfile에 추가gem 'smallpict', '~> 0.0.2'

빠른 시작 예제

Ruby

require 'smallpict'
client = SmallPict::Client.new(  api_key: ENV['SMALLPICT_API_KEY'],  secret_key: ENV['SMALLPICT_SECRET_KEY'])
# 1. 로컬 이미지 최적화result = client.optimize(  'hero.jpg',  format: 'avif',  quality: 80)
puts "최적화 URL: #{result.url}"puts "절감률: #{result.savings_percentage}%"
# 2. 쿼터 사용량 확인quota = client.get_quotaputs "플랜: #{quota.plan}, 사용률: #{quota.quota_percentage}%"
# 3. CDN 캐시 퍼지client.purge_cdn(['https://cdn.smallpict.app/opt/hero.avif'])

Rails ActiveStorage 연동

SmallPict는 공식 ActiveStorage 서비스 어댑터를 내장하고 있습니다:

Ruby

# config/initializers/smallpict.rbSmallPict.configure do |config|  config.api_key    = Rails.application.credentials.dig(:smallpict, :api_key)  config.secret_key = Rails.application.credentials.dig(:smallpict, :secret_key)end