rack_resize 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 89ff24cb927e939e377fa9de0e4af8d736e026d2536a5721a94c8884c745de16
-  data.tar.gz: 13e4ca927f5ef1f058a528ded9158cd324e2eaf0e34c2797b21e1791028a31fc
+  metadata.gz: '09480d8110a0fd174b70144ea5df62c1146f2c16399cd9e173a0638d5cf818b7'
+  data.tar.gz: 24f936049e0bed57e1ff90c49f588d48480700adae2b2b6829685df011ecb89f
 SHA512:
-  metadata.gz: 58f951cd5354359a5a6261a739ded0e7136d346a91572c4bc8ba856530feb57644b1825959acc4ecdc79f91a15ab93e1e38c58d3578d82bd4c803a70ac015fdc
-  data.tar.gz: 462e57a07904d0e4c845b40611a2d7bc601e4c2fb207b8b7f2cccac9de934d6471bc222550e770ba19e0e58235d977d86b4ed8df0771761ac4b09a884495f106
+  metadata.gz: be9835971015420520f16a1332a0ac5664668150f06d6f577148803a7a299142c9edffdd9e33581d64b76b0a0aa8fb2cec9cbd2ce8524cdfa45f966721177610
+  data.tar.gz: b48663c5733f65c3e55fff126df2a31ff99f64bc0fceccd3c9fbc10261ea0ed5acfd99e7705333e24486ef6464d776df2d7ab9b92c5d8ab198d8646b1ae0d224

data/.github/workflows/test.yml

@@ -0,0 +1,29 @@
+name: Test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['3.3', '3.4', '4.0']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install package
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libvips42 imagemagick libimlib2 libimlib2-dev
+
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: ${{ matrix.ruby }}
+          bundler-cache: true
+
+      - run: bundle exec rake test

data/.gitignore

@@ -1,3 +1,4 @@
 .idea/
 Gemfile.lock
 .DS_Store
+*.gem

data/Gemfile

@@ -2,6 +2,9 @@ source 'https://rubygems.org'
 
 gemspec
 
+gem 'image_processing'
 gem 'mini_magick'
 gem 'ruby-vips'
 gem 'rszr'
+gem 'minitest'
+gem 'rake'

data/README.md

@@ -1,6 +1,108 @@
+[![Gem Version](https://badge.fury.io/rb/rack_resize.svg)](https://badge.fury.io/rb/rack_resize)
 
-RESIZE IMAGE mini_magick samples/big.jpg - {:width=>"150"} - 0.949s
-RESIZE IMAGE sips samples/big.jpg - {:width=>"150"} - 0.121s
-RESIZE IMAGE vips samples/big.jpg - {:width=>"150"} - 0.116s
+Designed to be local simulation of CDN's resize feature
 
-s.add_runtime_dependency "image_processing", ["> 1.0", "< 3.0"]
+How to use with Rails
+
+```ruby
+group :development do
+  gem "rack_resize", require: "rack_resize/rails_autoload"
+end
+```
+
+How to use with Rack
+
+```ruby
+use RackResize::RackApp, processor: :imlib2, assets_folder: "samples"
+use Rack::Static, urls: [""], root: "samples", index: "index.html" # optional
+```
+
+### URL Formats:
+
+Cloudflare format: (can be used with helpers from `carrierwave-cloudflare` gem)
+```
+/cdn-cgi/image/width=426,format=auto/assets/pets/dog.jpg
+```
+Fastly and bunny.net: (tbd)
+```
+/assets/pets/dog.jpg?width=300
+```
+
+### Configuration:
+
+```ruby
+RackResize.configure do |config|
+  config.assets_folder      = Rails.root.join('app', 'assets', 'images')
+  config.processor          = :sips / :vips / :mini_magick / :imlib2
+  config.default_quality    = 95
+  config.save_resized       = false
+  config.cache_folder       = Rails.root.join('tmp', 'rack_resize_cache') # used if save_resized enabled
+  config.http_cache_max_age = 86400
+end
+```
+
+### Supported Processing Backends:
+
+<table>
+<tr>
+<th>libaray</th>
+<th>dependency</th>
+<th>config</th>
+</tr>
+<tr>
+<td>mini_magick</td>
+<td>
+
+```ruby
+gem "image_processing"
+gem  "mini_magick"
+```
+
+</td>
+<td>
+
+`processor: :mini_magick`
+
+</td>
+</tr>
+<tr>
+<td>vips</td>
+<td>
+
+```ruby
+gem "image_processing"
+gem  "ruby-vips"
+```
+
+</td>
+<td>
+
+`processor: :vips`
+
+</td>
+</tr>
+<tr>
+<td>sips (MacOS only)</td>
+<td>none</td>
+<td>
+
+`processor: :sips`
+
+</td>
+</tr>
+<tr>
+<td>imlib2</td>
+<td>
+
+```ruby
+gem  "rszr"
+```
+
+</td>
+<td>
+
+`processor: :imlib2`
+
+</td>
+</tr>
+</table>

data/Rakefile

@@ -0,0 +1,9 @@
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+task default: :test

data/config.ru

@@ -1,7 +1,13 @@
+#
+# usage:
+#   gem install rackup
+#   rackup
+#
+
 require_relative "lib/rack_resize"
 require "rack/static"
 
-use RackResize::RackApp, processor: :imlib2, assets_folder: "samples" # save_resized: false,
+use RackResize::RackApp, processor: :imlib2, assets_folder: "samples"
 
 use Rack::Static, urls: [""], root: "samples", index: "index.html"
 

data/lib/rack_resize/configuration.rb

@@ -4,20 +4,24 @@ class RackResize::Configuration
   PROCESSORS = %i[sips vips mini_magick imlib2].freeze
 
   attr_reader :processor
-  attr_accessor :save_resized, :default_quality, :cache_folder, :assets_folder
+  attr_accessor :save_resized, :default_quality, :cache_folder, :assets_folder, :http_cache_max_age
 
   alias_method :save_resized?, :save_resized
 
   def initialize(options = {})
-    @processor       = options[:processor] || RUBY_PLATFORM.include?('darwin') ? :sips : :mini_magick
-    @save_resized    = options.key?(:save_resized) ? options[:save_resized] : true
-    @default_quality = options[:default_quality] || 95
-    @cache_folder    = options[:cache_folder]
-    @assets_folder   = options[:assets_folder] ? Pathname.new(options[:assets_folder]) : nil
+    @processor          = options[:processor] || RUBY_PLATFORM.include?('darwin') ? :sips : :mini_magick
+    @save_resized       = options.key?(:save_resized) ? options[:save_resized] : false
+    @default_quality    = options[:default_quality] || 95
+    @cache_folder       = options[:cache_folder]
+    @assets_folder      = options[:assets_folder] ? Pathname.new(options[:assets_folder]) : nil
+    @http_cache_max_age = options[:http_cache_max_age] || 86400 # 1 day
 
     if defined?(Rails)
       @cache_folder ||= Rails.root.join('tmp', 'rack_resize_cache')
       @assets_folder ||= Rails.root.join('app', 'assets', 'images')
+      unless options.key?(:save_resized)
+        @save_resized = true
+      end
     end
 
     if options[:processor]

data/lib/rack_resize/rack_app.rb

@@ -13,20 +13,20 @@ class RackResize::RackApp
 
     @config = options == {} ? RackResize.config : RackResize::Configuration.new(options)
     @processing = RackResize::Processing.new(config: @config)
-    @path_prefix = options[:path_prefix] || "/cdn-cgi/image"
+    @cf_path_prefix = options[:cf_path_prefix] || "/cdn-cgi/image"
   end
 
   def call(env)
-    # process string like this
-    # /cdn-cgi/image/width=426,format=auto/assets/templates/vancouver-27c47f55.jpg
-
     request = Rack::Request.new(env)
     fullpath = request.path_info
 
-    unless fullpath.start_with?(@path_prefix)
+    unless fullpath.start_with?(@cf_path_prefix)
       return @app.call(env)
     end
 
+    # process string like this
+    # /cdn-cgi/image/width=426,format=auto/assets/templates/vancouver-27c47f55.jpg
+
     fullpath = fullpath.delete_prefix("/cdn-cgi").delete_prefix("/image").delete_prefix("/")
     file_path_match = fullpath.match(%r{(?<params>[^\/]+)(?<file>\/.+?)(-[\da-f]{8})?(?<ext>\.\w{2,})$})
 
@@ -58,7 +58,6 @@ class RackResize::RackApp
 
   def send_file(asset_file:, file_content: nil)
     content_type = Rack::Mime.mime_type(File.extname(asset_file), "application/octet-stream")
-    # file = file_path ? File.open(file_path, "rb") : StringIO.new(file_content)
 
     [
       200,
@@ -66,7 +65,7 @@ class RackResize::RackApp
         "content-type"        => content_type,
         "content-length"      => file_content.size.to_s,
         "content-disposition" => "inline",
-        "cache-control"       => "max-age=86400" # 1 day
+        "cache-control"       => "max-age=#{config.http_cache_max_age}" # 1 day
       },
       file_content
     ]

data/rack_resize.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name        = "rack_resize"
-  s.version     = "0.1.0"
+  s.version     = "0.1.1"
   s.author      = ["Pavel Evstigneev"]
   s.email       = ["pavel.evst@gmail.com"]
   s.homepage    = "https://github.com/paxa/rack_resize"

data/samples/index.html

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+
+<p>
+    height 150: <br>
+    <img src="/cdn-cgi/image/height=150/samples/image_1.jpeg"/>
+    <img src="/cdn-cgi/image/height=150/samples/image_2.jpeg"/>
+    <img src="/cdn-cgi/image/height=150/samples/image_3.jpeg"/>
+    <img src="/cdn-cgi/image/height=150/samples/image_4.jpeg"/>
+</p>
+
+<p>
+    width 150: <br>
+    <img src="/cdn-cgi/image/width=150/samples/image_1.jpeg"/>
+    <img src="/cdn-cgi/image/width=150/samples/image_2.jpeg"/>
+    <img src="/cdn-cgi/image/width=150/samples/image_3.jpeg"/>
+    <img src="/cdn-cgi/image/width=150/samples/image_4.jpeg"/>
+</p>
+
+<p>
+    width 50: <br>
+    <img src="/cdn-cgi/image/width=50/samples/image_1.jpeg"/>
+    <img src="/cdn-cgi/image/width=50/samples/image_2.jpeg"/>
+    <img src="/cdn-cgi/image/width=50/samples/image_3.jpeg"/>
+    <img src="/cdn-cgi/image/width=50/samples/image_4.jpeg"/>
+</p>
+
+<p>
+    originals: <br>
+    <img src="image_1.jpeg"/>
+    <img src="image_2.jpeg"/>
+    <img src="image_3.jpeg"/>
+    <img src="image_4.jpeg"/>
+</p>
+

data/test/rack_app_test.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require_relative 'test_helper'
+
+class RackAppTest < Minitest::Test
+  UPSTREAM = ->(env) { [200, { 'content-type' => 'text/plain' }, ['upstream']] }
+
+  def setup
+    @tmpdir = Dir.mktmpdir('rack_resize_test')
+    File.write(File.join(@tmpdir, 'photo.jpg'), 'fake jpeg content')
+
+    @app = RackResize::RackApp.new(
+      UPSTREAM,
+      assets_folder: @tmpdir,
+      processor:     :sips,
+      save_resized:  false
+    )
+
+    fake_processing = Object.new
+    def fake_processing.process!(**) = StringIO.new('processed image data')
+    @app.instance_variable_set(:@processing, fake_processing)
+  end
+
+  def teardown
+    FileUtils.rm_rf(@tmpdir)
+  end
+
+  # --- error_resp ---
+
+  def test_error_resp_default_status
+    status, headers, body = @app.error_resp('oops')
+    assert_equal 404, status
+    assert_equal({}, headers)
+    assert_equal ['oops'], body
+  end
+
+  def test_error_resp_custom_status
+    status, _, body = @app.error_resp('bad input', http_code: 422)
+    assert_equal 422, status
+    assert_equal ['bad input'], body
+  end
+
+  # --- send_file ---
+
+  def test_send_file_returns_200_with_headers
+    asset_file = Pathname.new(File.join(@tmpdir, 'photo.jpg'))
+    content    = StringIO.new('hello')
+    status, headers, _ = @app.send_file(asset_file:, file_content: content)
+
+    assert_equal 200, status
+    assert_equal 'image/jpeg', headers['content-type']
+    assert_equal '5', headers['content-length']
+    assert_equal 'inline', headers['content-disposition']
+    assert_match(/\d+/, headers['cache-control'])
+  end
+
+  # --- pass-through for non-cdn-cgi paths ---
+
+  def test_passes_through_unrelated_paths
+    env    = Rack::MockRequest.env_for('/foo/bar.jpg')
+    status, _, body = @app.call(env)
+    assert_equal 200, status
+    assert_equal ['upstream'], body
+  end
+
+  def test_passes_through_root_path
+    env = Rack::MockRequest.env_for('/')
+    _, _, body = @app.call(env)
+    assert_equal ['upstream'], body
+  end
+
+  # --- path parsing errors ---
+
+  def test_returns_404_for_unparseable_path
+    env = Rack::MockRequest.env_for('/cdn-cgi/image/bad-path-no-extension')
+    status, _, body = @app.call(env)
+    assert_equal 404, status
+    assert_equal ["can't parse file path"], body
+  end
+
+  def test_returns_404_for_path_traversal
+    env = Rack::MockRequest.env_for('/cdn-cgi/image/width=100/assets/../etc/photo.jpg')
+    status, _, body = @app.call(env)
+    assert_equal 404, status
+    assert_equal ['.. is not allowed in image path'], body
+  end
+
+  def test_returns_404_for_missing_file
+    env = Rack::MockRequest.env_for('/cdn-cgi/image/width=100/assets/missing.jpg')
+    status, _, body = @app.call(env)
+    assert_equal 404, status
+    assert_equal ['file not exists on a server'], body
+  end
+
+  # --- successful processing ---
+
+  def test_returns_200_for_valid_request
+    env = Rack::MockRequest.env_for('/cdn-cgi/image/width=100/assets/photo.jpg')
+    status, headers, _ = @app.call(env)
+    assert_equal 200, status
+    assert_equal 'image/jpeg', headers['content-type']
+  end
+
+  def test_valid_request_with_multiple_params
+    env = Rack::MockRequest.env_for('/cdn-cgi/image/width=200,format=auto,quality=80/assets/photo.jpg')
+    status, = @app.call(env)
+    assert_equal 200, status
+  end
+
+  def test_response_body_is_processed_content
+    env = Rack::MockRequest.env_for('/cdn-cgi/image/width=100/assets/photo.jpg')
+    _, headers, body = @app.call(env)
+    assert_equal 'processed image data'.bytesize.to_s, headers['content-length']
+  end
+
+  # --- fingerprinted filenames (Rails asset digest) ---
+
+  def test_strips_digest_fingerprint_from_filename
+    File.write(File.join(@tmpdir, 'photo.jpg'), 'fake jpeg content')
+    env = Rack::MockRequest.env_for('/cdn-cgi/image/width=100/assets/photo-1a2b3c4d.jpg')
+    status, _, _ = @app.call(env)
+    assert_equal 200, status
+  end
+
+  # --- custom cf_path_prefix ---
+
+  def test_custom_cf_path_prefix_does_not_intercept_default_prefix
+    app = RackResize::RackApp.new(
+      UPSTREAM,
+      assets_folder:  @tmpdir,
+      processor:      :sips,
+      save_resized:   false,
+      cf_path_prefix: '/img'
+    )
+    env = Rack::MockRequest.env_for('/cdn-cgi/image/width=100/assets/photo.jpg')
+    _, _, body = app.call(env)
+    assert_equal ['upstream'], body
+  end
+
+  # --- without upstream app ---
+
+  def test_initializes_without_upstream_app
+    app = RackResize::RackApp.new(assets_folder: @tmpdir, processor: :sips, save_resized: false)
+    assert_nil app.instance_variable_get(:@app)
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+require 'minitest/autorun'
+require 'rack/mock'
+require_relative '../lib/rack_resize'

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: rack_resize
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Pavel Evstigneev
 bindir: bin
 cert_chain: []
-date: 2026-07-15 00:00:00.000000000 Z
+date: 2026-07-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -35,9 +35,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/workflows/test.yml"
 - ".gitignore"
 - Gemfile
 - README.md
+- Rakefile
 - config.ru
 - lib/rack_resize.rb
 - lib/rack_resize/configuration.rb
@@ -50,6 +52,13 @@ files:
 - lib/rack_resize/rack_app.rb
 - lib/rack_resize/rails_autoload.rb
 - rack_resize.gemspec
+- samples/image_1.jpeg
+- samples/image_2.jpeg
+- samples/image_3.jpeg
+- samples/image_4.jpeg
+- samples/index.html
+- test/rack_app_test.rb
+- test/test_helper.rb
 homepage: https://github.com/paxa/rack_resize
 licenses:
 - MIT