jr-paperclip 8.0.0 → 8.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3a0a10e43e470a988afe5f30de3f2144f18bca45154654abdbf09b57817bee4b
-  data.tar.gz: 59df71bd9e4c0577f252165bf5b1d55202ffe8d363f0eae235d30db9c90b14fb
+  metadata.gz: 832b95743f1be2588ee95b5739e548c630a0c522f579da2234d083b58d82d708
+  data.tar.gz: 0034d60bdc931cb92fcd9a338bb2126419a183a9017344e2b036eb553e01ad8a
 SHA512:
-  metadata.gz: 4ac11878b1797097dd0c6a369f39f03bc52153f2c9db2c2991d533b171a9f36fbec873b5859b55b378dbcb541d2d477f40de92d99456c7c3f5fb86c1d53eae5b
-  data.tar.gz: 8ec53d673eee2ddbfab2008ab3a3977d659dda2df53f9e7c34d9cef307b1889d53ead7ae3a3c4d4cebdc33452c9ec3e9a5c7abfefb36f46ca5e5f68ecf0bc644
+  metadata.gz: e2828741e3347c89141a90baef60b1a9dd96482a29687a2ca146f663477d7e15f8dade773ff4b5f7e5d092c54ebf4fb7ed301baaa9c823286b5dceb6bfd08781
+  data.tar.gz: fd6704473b2934cbc999a82d986e144ce10e266b070d67b38802fe73daa07d650dbd5b1e47aeb112caa3bd0f889fd841315b5f740d3158c7341d1a9cafcdbbd0

data/NEWS

@@ -1,3 +1,15 @@
+8.0.2 (2026-01-19)
+
+* Performance: Optimized image thumbnail processing pipeline to handle EXIF orientation more efficiently when using vips backend.
+* Bugix: Vips backend now uses copy_memory for operations that need random access.
+
+8.0.1 (2026-01-19)
+
+* Performance: Vips backend now uses sequential access by default for better memory efficiency.
+  Sequential access streams images from top to bottom, keeping only a few scanlines in memory
+  rather than loading the entire image. This significantly reduces memory usage for large images.
+  Users can override via source_file_options: { access: :random } if needed.
+
 8.0.0 (2026-01-13)
 
 * Feature: Add libvips backend alongside ImageMagick via the image_processing gem

data/VIPS_MIGRATION_GUIDE.md

@@ -51,20 +51,22 @@ Good news! Many common `convert_options` now work with **both** ImageMagick and
 
 ### Options That Work on Both Backends
 
-| Option | Description |
-|--------|-------------|
-| `-strip` | Remove metadata/EXIF data |
-| `-quality N` | Output quality (1-100) |
-| `-rotate N` | Rotate by degrees |
-| `-flip` | Vertical flip |
-| `-flop` | Horizontal flip |
-| `-blur 0xN` | Gaussian blur |
-| `-sharpen 0xN` | Sharpen image |
-| `-colorspace X` | Color space (Gray, sRGB, CMYK) |
-| `-negate` | Invert colors |
-| `-flatten` | Flatten transparency |
-| `-auto-orient` | Auto-rotate via EXIF |
-| `-interlace X` | Progressive/interlaced output |
+| Option | Description | Example |
+|--------|-------------|---------|
+| `-strip` | Remove metadata/EXIF | `convert_options: "-strip"` |
+| `-quality N` | Output quality (1-100) | `convert_options: "-quality 80"` |
+| `-rotate N` | Rotate by degrees | `convert_options: "-rotate 90"` |
+| `-flip` | Vertical flip | `convert_options: "-flip"` |
+| `-flop` | Horizontal flip | `convert_options: "-flop"` |
+| `-blur 0xN` | Gaussian blur | `convert_options: "-blur 0x2"` |
+| `-sharpen 0xN` | Sharpen image | `convert_options: "-sharpen 0x1"` |
+| `-colorspace X` | Color space (Gray, sRGB, CMYK) | `convert_options: "-colorspace Gray"` |
+| `-negate` | Invert colors | `convert_options: "-negate"` |
+| `-flatten` | Flatten transparency | `convert_options: "-flatten"` |
+| `-gamma N` | Adjust image gamma | `convert_options: "-gamma 1.5"` |
+| `-auto-orient` | Auto-rotate via EXIF | `convert_options: "-auto-orient"` |
+| `-interlace X` | Progressive output | `convert_options: "-interlace Plane"` |
+
 
 **Example:**
 ```ruby

data/lib/paperclip/thumbnail.rb

@@ -183,6 +183,22 @@ module Paperclip
     def build_pipeline(source_path)
       pipeline = image_processing_module.source(source_path)
 
+      # Auto-orient based on EXIF data
+      if auto_orient
+        if backend == :vips
+          pipeline = pipeline.loader(autorotate: true)
+        elsif backend == :image_magick
+          pipeline = pipeline.auto_orient
+        end
+      end
+
+      # For vips backend, default to sequential access for better memory efficiency.
+      # Sequential access streams the image from top to bottom, keeping only a few
+      # scanlines in memory. Users can override via source_file_options: { access: :random }
+      if backend == :vips
+        pipeline = pipeline.loader(access: :sequential)
+      end
+
       # Handle source file options
       if @source_file_options
         loader_options = parse_loader_options(@source_file_options)
@@ -210,15 +226,6 @@ module Paperclip
         end
       end
 
-      # Auto-orient based on EXIF data
-      if auto_orient
-        pipeline = if backend == :vips
-                     pipeline.autorot
-                   else
-                     pipeline.auto_orient
-                   end
-      end
-
       # Apply resize operation
       if target_geometry
         pipeline = apply_resize(pipeline)
@@ -467,13 +474,15 @@ module Paperclip
         # Vips rotate via similarity for arbitrary angles
         if value
           angle = value.to_f
-          pipeline.custom { |img| img.similarity(angle: angle) }
+          # Similarity requires random access (or memory copy) for non-trivial angles
+          pipeline.custom { |img| img.copy_memory.similarity(angle: angle) }
         else
           pipeline
         end
       when "flip"
         # Vips uses flip with direction
-        pipeline.custom(&:flipver)
+        # Vertical flip requires random access (needs full image)
+        pipeline.custom { |img| img.copy_memory.flipver }
       when "flop"
         pipeline.custom(&:fliphor)
       when "blur", "gaussian_blur", "gaussblur"
@@ -504,14 +513,15 @@ module Paperclip
       when "median"
         value ? pipeline.median(value.to_i) : pipeline
       when "rot90"
-        pipeline.rot90
+        # Rotations change scanline order, requiring random access
+        pipeline.custom { |img| img.copy_memory.rot90 }
       when "rot180"
-        pipeline.rot180
+        pipeline.custom { |img| img.copy_memory.rot180 }
       when "rot270"
-        pipeline.rot270
+        pipeline.custom { |img| img.copy_memory.rot270 }
       when "similarity"
         # similarity for arbitrary rotation/scale
-        value ? pipeline.custom { |img| img.similarity(angle: value.to_f) } : pipeline
+        value ? pipeline.custom { |img| img.copy_memory.similarity(angle: value.to_f) } : pipeline
       # Edge detection filters (no arguments)
       when "canny"
         pipeline.canny

data/lib/paperclip/version.rb

@@ -1,3 +1,3 @@
 module Paperclip
-  VERSION = "8.0.0".freeze
+  VERSION = "8.0.2".freeze
 end

data/spec/paperclip/thumbnail_spec.rb

@@ -830,6 +830,34 @@ describe Paperclip::Thumbnail do
         end
       end
 
+      describe "-rot90" do
+        it "rotates the image 90 degrees" do
+          result = make_vips_thumb_with_options(@file, "-rot90")
+          expect(File.exist?(result.path)).to be true
+
+          dimensions = `identify -format "%wx%h" "#{result.path}"`.strip
+          # Resized to 100x15, then rotated 90 -> 15x100
+          expect(dimensions).to eq("15x100")
+        end
+      end
+
+      describe "-rot180" do
+        it "rotates the image 180 degrees" do
+          File.open(fixture_file("big_image.jpg"), "rb") do |file|
+            thumb = Paperclip::Thumbnail.new(file, {
+                                               geometry: "2000x2000",
+                                               convert_options: "-rot180",
+                                               backend: :vips,
+                                             }, attachment)
+            result = thumb.make
+            expect(File.exist?(result.path)).to be true
+
+            dimensions = `identify -format "%wx%h" "#{result.path}"`.strip
+            expect(dimensions).to eq("2000x1581")
+          end
+        end
+      end
+
       describe "-flip" do
         it "flips the image vertically" do
           result = make_vips_thumb_with_options(@file, "-flip")

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jr-paperclip
 version: !ruby/object:Gem::Version
-  version: 8.0.0
+  version: 8.0.2
 platform: ruby
 authors:
 - Jukka Rautanen
@@ -571,6 +571,7 @@ files:
 - spec/support/fixtures/animated.unknown
 - spec/support/fixtures/aws_s3.yml
 - spec/support/fixtures/bad.png
+- spec/support/fixtures/big_image.jpg
 - spec/support/fixtures/empty.html
 - spec/support/fixtures/empty.xlsx
 - spec/support/fixtures/fog.yml
@@ -712,6 +713,7 @@ test_files:
 - spec/support/fixtures/animated.unknown
 - spec/support/fixtures/aws_s3.yml
 - spec/support/fixtures/bad.png
+- spec/support/fixtures/big_image.jpg
 - spec/support/fixtures/empty.html
 - spec/support/fixtures/empty.xlsx
 - spec/support/fixtures/fog.yml