jr-paperclip 8.0.0.beta.1 → 8.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08e0a02cb6a9a3a1b126b744de6afe4654e9db7bf841bb710ac29b3cb702f5a2'
-  data.tar.gz: 5c3c603853869aa41d56026de0d71788f87f7b98ec4d8382adc811e23bc9eb42
+  metadata.gz: 3a0a10e43e470a988afe5f30de3f2144f18bca45154654abdbf09b57817bee4b
+  data.tar.gz: 59df71bd9e4c0577f252165bf5b1d55202ffe8d363f0eae235d30db9c90b14fb
 SHA512:
-  metadata.gz: 9b71eb967b7cb2b0980e665c4886bbb5754bac409677b0af4e13578101dde22d710ab2bc11e31287dac3e99520f53f9e9b44fe79f5285f5fd5aa2cfe070edf43
-  data.tar.gz: ab955ec831d70c792bcaccbb41b5e2b6754fe0badddc1a52735d5a974f0982e3cdda316e5db9a274da73132482515ebf5b74775780d8e179e6d2493154370610
+  metadata.gz: 4ac11878b1797097dd0c6a369f39f03bc52153f2c9db2c2991d533b171a9f36fbec873b5859b55b378dbcb541d2d477f40de92d99456c7c3f5fb86c1d53eae5b
+  data.tar.gz: 8ec53d673eee2ddbfab2008ab3a3977d659dda2df53f9e7c34d9cef307b1889d53ead7ae3a3c4d4cebdc33452c9ec3e9a5c7abfefb36f46ca5e5f68ecf0bc644

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -7,32 +7,12 @@ assignees: ''
 
 ---
 
-**Describe the bug**
-A clear and concise description of what the bug is.
+Ruby version:
+Rails version:
+Paperclip version:
+ImageMagick version:
+libvips version: 
 
-**To Reproduce**
-Steps to reproduce the behavior:
-1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
+Please include your initializer, Paperclip related options, and any error message with the full backtrace.
 
-**Expected behavior**
-A clear and concise description of what you expected to happen.
-
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
-
-**Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
-
-**Smartphone (please complete the following information):**
- - Device: [e.g. iPhone6]
- - OS: [e.g. iOS8.1]
- - Browser [e.g. stock browser, safari]
- - Version [e.g. 22]
-
-**Additional context**
-Add any other context about the problem here.
+If you are using an old version, have you checked the changelogs to see if your issue has been fixed in a later version?

data/.github/workflows/tests.yml

@@ -46,7 +46,7 @@ jobs:
       - name: Install dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install -y ghostscript imagemagick libvips
+          sudo apt-get install -y ghostscript imagemagick libvips libvips-tools
           sudo rm -f /etc/ImageMagick-6/policy.xml
 
       - name: Run tests

data/NEWS

@@ -1,4 +1,4 @@
-8.0.0.beta.1 (2026-01-09)
+8.0.0 (2026-01-13)
 
 * Feature: Add libvips backend alongside ImageMagick via the image_processing gem
 * Feature: Per-attachment and per-style backend selection (`:backend` option)

data/README.md

@@ -14,20 +14,17 @@ Legacy versions were dropped to reduce maintenance overhead and keep up with upd
 
 Additional maintainers are very welcome.
 
----
-
-We plan to support and maintain paperclip, as well as clean it up.
+## Version 8.0.0 brings major new features and improvements:
 
-Please feel free to contribute Issues and pull requests.
-
----
+* Support for libvips backend alongside ImageMagick via the image_processing gem
+* ImageMagick 7 support (uses `magick` command when available)
+* Added `ALLOWED_IMAGEMAGICK_OPTIONS` security whitelist (GHSA-r4mg-4433-c7g3)
+* Cross-platform convert_options support (-strip, -quality, -rotate, etc.)
 
-# Existing documentation
+Please check the [Image Processor](#image-processor) and [Post Processing](#post-processing) sections for more details and the [VIPS Migration Guide](https://github.com/jukra/jr-paperclip/blob/master/VIPS_MIGRATION_GUIDE.md) for migration instructions.
 
 ## Documentation valid for `master` branch
 
----
-
 <!-- START doctoc generated TOC please keep comment here to allow auto update -->
 <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
 
@@ -100,7 +97,7 @@ Requirements
 
 ### Ruby and Rails
 
-Paperclip now requires Ruby version **>= 2.3** and Rails version **>= 4.2**
+Paperclip now requires Ruby version **>= 3.0** and Rails version **>= 7.0**
 (only if you're going to use Paperclip with Ruby on Rails).
 
 ### Image Processor
@@ -149,6 +146,9 @@ brew install vips
 
 # Ubuntu/Debian
 sudo apt install libvips
+
+# If you also need the vips and vipsheader command line tools (for example custom processors)
+sudo apt install libvips-tools
 ```
 
 Then configure Paperclip to use it as the default backend in `config/initializers/paperclip.rb` (or in your environment configuration):
@@ -211,7 +211,7 @@ Paperclip is distributed as a gem, which is how it should be used in your app.
 Include the gem in your Gemfile:
 
 ```ruby
-gem "jr-paperclip", "~> 7.3"
+gem "jr-paperclip", "~> 8.0"
 ```
 
 Or, if you want to get the latest, you can get master from the main paperclip repository:
@@ -723,6 +723,7 @@ has_attached_file :avatar, styles: { thumb: ["32x32#", :png] }
 This will convert the "thumb" style to a 32x32 square in PNG format, regardless
 of what was uploaded. If the format is not specified, it is kept the same (e.g.
 JPGs will remain JPGs). `Paperclip::Thumbnail` uses the [image_processing](https://github.com/janko/image_processing) gem to process images. This allows support for both ImageMagick (via MiniMagick) and libvips backends.
+
 [ImageMagick's geometry documentation](http://www.imagemagick.org/script/command-line-processing.php#geometry)
 has more information on the accepted style formats, which are generally supported by both backends in Paperclip.
 
@@ -734,12 +735,14 @@ has_attached_file :image, styles: { regular: ['800x800>', :png]},
     convert_options: { regular: "-posterize 3"}
 ```
 
-Since Paperclip now delegates to the `image_processing` gem, you should refer to its documentation for available methods/operations for your chosen backend:
+Paperclip delegates to the `image_processing` gem, but **whitelists supported options** for security. For ImageMagick, most standard options are supported. For libvips, a curated set of common options is available (see table below) and `Paperclip::Thumbnail` class for details. Unsupported options are logged as warnings and skipped.
+
+For full backend capabilities, refer to the image_processing documentation:
 
 *   **ImageMagick:** [ImageProcessing::MiniMagick documentation](https://github.com/janko/image_processing/blob/master/doc/minimagick.md)
 *   **libvips:** [ImageProcessing::Vips documentation](https://github.com/janko/image_processing/blob/master/doc/vips.md)
 
-Common options like `-strip`, `-quality`, `-rotate`, `-blur` are supported on both backends, but backend-specific options (like `-density` for ImageMagick) might not be available or behave differently on libvips.
+Common options like `-strip`, `-quality`, `-rotate`, `-blur` are supported on both backends. Backend-specific options (like `-density` for ImageMagick) may not be available on libvips.
 
 ### Cross-Platform Convert Options
 
@@ -757,6 +760,7 @@ Many common `convert_options` now work with **both** ImageMagick and libvips bac
 | `-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"` |
 
@@ -770,14 +774,6 @@ has_attached_file :avatar,
 
 **Note:** Some options only work with ImageMagick (e.g., `-density`, `-depth`, `-gravity`, `-crop`, `-trim`). When using the vips backend, these will be skipped with a warning logged.
 
-ImageMagick supports a number of environment variables for controlling its resource limits. For example, you can enforce memory or execution time limits by setting the following variables in your application's process environment:
-
-* `MAGICK_MEMORY_LIMIT=128MiB`
-* `MAGICK_MAP_LIMIT=64MiB`
-* `MAGICK_TIME_LIMIT=30`
-
-For a full list of variables and description, see [ImageMagick's resources documentation](http://www.imagemagick.org/script/resources.php).
-
 ---
 
 Image Processing Backends
@@ -787,16 +783,24 @@ jr-paperclip supports two image processing backends:
 
 ### ImageMagick (Default)
 
-The traditional backend, using ImageMagick via shell commands.
+The traditional backend. Paperclip uses the `image_processing` gem (via `mini_magick`) to generate shell commands for ImageMagick.
 
 ```ruby
 has_attached_file :avatar,
   styles: { thumb: "100x100#" }
 ```
 
+ImageMagick supports a number of environment variables for controlling its resource limits. For example, you can enforce memory or execution time limits by setting the following variables in your application's process environment:
+
+* `MAGICK_MEMORY_LIMIT=128MiB`
+* `MAGICK_MAP_LIMIT=64MiB`
+* `MAGICK_TIME_LIMIT=30`
+
+For a full list of variables and description, see [ImageMagick's resources documentation](http://www.imagemagick.org/script/resources.php).
+
 ### libvips (Recommended for Performance)
 
-libvips is significantly faster and uses less memory than ImageMagick.
+libvips is significantly faster and uses less memory than ImageMagick. Paperclip uses the `image_processing` gem (via `ruby-vips`) to interface with libvips.
 
 **Usage:**
 
@@ -820,6 +824,12 @@ has_attached_file :document,
   }
 ```
 
+libvips keeps a cache of recently executed operations. You can disable this for a drop in memory use:
+```ruby
+Vips::cache_set_max 0
+```
+**Note:** Typically this is not needed as libvips is already memory efficient. Disabling the cache is mostly useful in extremely memory-constrained environments (like AWS Lambda) where every MB counts. This [issue](https://github.com/libvips/ruby-vips/issues/225) has more information on memory usage.
+
 ---
 
 Custom Attachment Processors

data/VIPS_MIGRATION_GUIDE.md

@@ -14,6 +14,9 @@ brew install vips
 
 # Ubuntu/Debian
 sudo apt install libvips
+
+# If you also need the vips and vipsheader command line tools (for example custom processors)
+sudo apt install libvips-tools
 ```
 
 ## Step 1: Update your Gemfile
@@ -23,7 +26,7 @@ sudo apt install libvips
 Ensure you are using the latest version of the gem:
 
 ```ruby
-gem "jr-paperclip", "~> 8.0.0.beta"
+gem "jr-paperclip", "~> 8.0"
 ```
 
 ## Step 2: Gradual Migration (Per-Attachment)
@@ -73,7 +76,7 @@ has_attached_file :avatar,
 
 ### ImageMagick-Only Options
 
-The following options only work with ImageMagick. When used with the vips backend, they will be skipped and a warning will be logged:
+For example the following options only work with ImageMagick. When used with the vips backend, they will be skipped and a warning will be logged:
 
 `-density`, `-depth`, `-gravity`, `-crop`, `-extent`, `-alpha`, `-background`, `-type`, `-posterize`, `-dither`, `-colors`, `-channel`, `-transpose`, `-transverse`, `-normalize`, `-equalize`, `-trim`, `-monochrome`
 
@@ -89,6 +92,9 @@ However, if you want to migrate a custom processor to libvips, you can now use t
 module Paperclip
   class MyVipsProcessor < Processor
     def make
+      basename = File.basename(file.path, File.extname(file.path))
+      dst = Paperclip::TempfileFactory.new.generate("#{basename}.png")
+
       # Use the new vips helper instead of convert
       vips("thumbnail :src :dst 100",
            src: File.expand_path(file.path),

data/lib/paperclip/geometry_detector_factory.rb

@@ -48,7 +48,7 @@ module Paperclip
       begin
         require "vips"
       rescue LoadError => e
-        raise Errors::CommandNotFoundError.new("Could not load ruby-vips. Please install libvips and the image_processing gem.")
+        raise Errors::CommandNotFoundError.new("Could not load ruby-vips. Please install libvips.")
       end
 
       begin

data/lib/paperclip/processor.rb

@@ -80,7 +80,7 @@ module Paperclip
       begin
         require "vips"
       rescue LoadError
-        raise Errors::CommandNotFoundError.new("Could not load ruby-vips. Please install libvips and the vips gem.")
+        raise Errors::CommandNotFoundError.new("Could not load ruby-vips. Please install libvips.")
       end
       Vips::Image.new_from_file(file_path, **options)
     end

data/lib/paperclip/thumbnail.rb

@@ -476,30 +476,51 @@ module Paperclip
         pipeline.custom(&:flipver)
       when "flop"
         pipeline.custom(&:fliphor)
-      when "blur"
+      when "blur", "gaussian_blur", "gaussblur"
         # Vips uses gaussblur with sigma parameter
         # ImageMagick blur is "radiusxsigma", extract sigma
         sigma = extract_blur_sigma(value)
-        sigma ? pipeline.custom { |img| img.gaussblur(sigma) } : pipeline
-      when "gaussian_blur"
-        sigma = extract_blur_sigma(value)
-        sigma ? pipeline.custom { |img| img.gaussblur(sigma) } : pipeline
+        sigma ? pipeline.gaussblur(sigma) : pipeline
       when "sharpen"
         # Vips sharpen has different parameters than ImageMagick
         # Use sensible defaults for unsharp masking
         pipeline.custom(&:sharpen)
-      when "colorspace"
+      when "colorspace", "colourspace"
         # Vips uses British spelling "colourspace"
-        value ? pipeline.custom { |img| img.colourspace(vips_colorspace(value)) } : pipeline
+        value ? pipeline.colourspace(vips_colorspace(value)) : pipeline
+      when "gamma"
+        # Vips gamma uses keyword argument
+        value ? pipeline.custom { |img| img.gamma(exponent: value.to_f) } : pipeline
       when "flatten"
         pipeline.custom { |img| img.flatten(background: [255, 255, 255]) }
       when "negate", "invert"
         pipeline.custom(&:invert)
-      when "auto_orient"
+      when "auto_orient", "autorot"
         pipeline.autorot
       when "interlace"
         # Vips handles interlacing via saver options
         pipeline.saver(interlace: true)
+      # Vips-native options (direct vips method names)
+      when "median"
+        value ? pipeline.median(value.to_i) : pipeline
+      when "rot90"
+        pipeline.rot90
+      when "rot180"
+        pipeline.rot180
+      when "rot270"
+        pipeline.rot270
+      when "similarity"
+        # similarity for arbitrary rotation/scale
+        value ? pipeline.custom { |img| img.similarity(angle: value.to_f) } : pipeline
+      # Edge detection filters (no arguments)
+      when "canny"
+        pipeline.canny
+      when "sobel"
+        pipeline.sobel
+      when "prewitt"
+        pipeline.custom(&:prewitt)
+      when "scharr"
+        pipeline.custom(&:scharr)
       else
         # Unknown option - log warning for vips
         Paperclip.log("Warning: -#{opt_name} is not supported with vips backend, skipping")

data/lib/paperclip/version.rb

@@ -1,3 +1,3 @@
 module Paperclip
-  VERSION = "8.0.0.beta.1" unless defined?(Paperclip::VERSION)
+  VERSION = "8.0.0".freeze
 end

data/spec/paperclip/migration_guide_example_spec.rb

@@ -0,0 +1,44 @@
+require "spec_helper"
+
+module Paperclip
+  class MyVipsProcessor < Processor
+    def make
+      basename = File.basename(file.path, File.extname(file.path))
+      dst = Paperclip::TempfileFactory.new.generate("#{basename}.png")
+
+      # Use the new vips helper instead of convert
+      vips("thumbnail :src :dst 100",
+           src: File.expand_path(file.path),
+           dst: File.expand_path(dst.path))
+      dst
+    end
+  end
+end
+
+describe Paperclip::MyVipsProcessor do
+  let(:file) { File.open(fixture_file("50x50.png")) }
+  let(:options) { {} }
+  let(:attachment) { double }
+  let(:processor) { Paperclip::MyVipsProcessor.new(file, options, attachment) }
+
+  subject { processor.make }
+
+  it "processes the image using vips helper" do
+    expect(subject).to respond_to(:path)
+    expect(File.exist?(subject.path)).to be true
+
+    # Check width using vipsheader
+    require "shellwords"
+    dimensions = `identify -format "%wx%h" "#{Shellwords.escape(subject.path)}"`.strip
+    expect(dimensions).to eq("100x100")
+  end
+
+  it "calls the vips command" do
+    expect(Paperclip).to receive(:run).with(
+      "vips",
+      "thumbnail :src :dst 100",
+      hash_including(:src, :dst),
+    )
+    processor.make
+  end
+end

data/spec/paperclip/thumbnail_custom_options_spec.rb

@@ -11,8 +11,8 @@ describe Paperclip::Thumbnail do
 
     it "correctly applies options starting with +" do
       # The user's specific options - with Shellwords, quoted values are parsed correctly
-      convert_options = '-coalesce +profile "!icc,*" +set date:modify +set date:create +set date:timestamp'
-
+      convert_options = '-coalesce -quality 90 +profile "!icc,*" +set date:modify ' \
+                        "+set date:create +set date:timestamp -define jpeg:dct-method=float"
       thumb = Paperclip::Thumbnail.new(@file, {
                                          geometry: "100x100",
                                          convert_options: convert_options,
@@ -20,15 +20,17 @@ describe Paperclip::Thumbnail do
                                        }, @attachment)
 
       # Spy on the pipeline to verify the correct methods/arguments are called on it.
-      allow(thumb).to receive(:apply_single_option).and_call_original
+      allow(thumb).to receive(:apply_imagemagick_option).and_call_original
       expect { thumb.make }.not_to raise_error
 
       # With Shellwords parsing, the outer quotes are stripped from "!icc,*" -> !icc,*
-      expect(thumb).to have_received(:apply_single_option).with(anything, "coalesce", nil, "-")
-      expect(thumb).to have_received(:apply_single_option).with(anything, "profile", "!icc,*", "+")
-      expect(thumb).to have_received(:apply_single_option).with(anything, "set", "date:modify", "+")
-      expect(thumb).to have_received(:apply_single_option).with(anything, "set", "date:create", "+")
-      expect(thumb).to have_received(:apply_single_option).with(anything, "set", "date:timestamp", "+")
+      expect(thumb).to have_received(:apply_imagemagick_option).with(anything, "coalesce", nil, "-")
+      expect(thumb).to have_received(:apply_imagemagick_option).with(anything, "quality", "90", "-")
+      expect(thumb).to have_received(:apply_imagemagick_option).with(anything, "profile", "!icc,*", "+")
+      expect(thumb).to have_received(:apply_imagemagick_option).with(anything, "set", "date:modify", "+")
+      expect(thumb).to have_received(:apply_imagemagick_option).with(anything, "set", "date:create", "+")
+      expect(thumb).to have_received(:apply_imagemagick_option).with(anything, "set", "date:timestamp", "+")
+      expect(thumb).to have_received(:apply_imagemagick_option).with(anything, "define", "jpeg:dct-method=float", "-")
     end
   end
 
@@ -170,4 +172,54 @@ describe Paperclip::Thumbnail do
       expect(output).to include("second_prop: Second Value")
     end
   end
+
+  context "with vips-specific convert_options" do
+    before do
+      begin
+        require "vips"
+      rescue LoadError
+        skip "libvips not installed"
+      end
+      @file = File.new(fixture_file("5k.png"), "rb")
+      @attachment = double("Attachment", options: {})
+    end
+
+    after { @file.close if @file && !@file.closed? }
+
+    it "processes vips-native options correctly" do
+      convert_options = "-rot90"
+      file = File.new(fixture_file("rotated.jpg"), "rb")
+
+      thumb = Paperclip::Thumbnail.new(file, {
+                                         geometry: "100x100",
+                                         convert_options: convert_options,
+                                         backend: :vips,
+                                       }, @attachment)
+
+      # Processes without error
+      result = nil
+      expect { result = thumb.make }.not_to raise_error
+
+      require "shellwords"
+      dimensions = `identify -format "%wx%h" "#{Shellwords.escape(result.path)}"`.strip
+      width, height = dimensions.split("x").map(&:to_i)
+      # After 90 degree rotate, width should be greater than height
+      expect(width).to be > height
+      file.close
+    end
+
+    it "logs warning for unsupported vips options" do
+      convert_options = "-coalesce -unknown_vips_option foo"
+
+      thumb = Paperclip::Thumbnail.new(@file, {
+                                         geometry: "100x100",
+                                         convert_options: convert_options,
+                                         backend: :vips,
+                                       }, @attachment)
+
+      expect(Paperclip).to receive(:log).with(/Warning.*coalesce.*not supported/)
+      expect(Paperclip).to receive(:log).with(/Warning.*unknown_vips_option.*not supported/)
+      expect { thumb.make }.not_to raise_error
+    end
+  end
 end

data/spec/paperclip/thumbnail_spec.rb

@@ -71,20 +71,20 @@ describe Paperclip::Thumbnail do
 
         # Process with vips backend
         vips_processor = described_class.new(@file, {
-          geometry: "50x50#",
-          backend: :vips,
-          style: :vips_thumb
-        }, attachment)
+                                               geometry: "50x50#",
+                                               backend: :vips,
+                                               style: :vips_thumb,
+                                             }, attachment)
         vips_result = vips_processor.make
 
         @file.rewind
 
         # Process with image_magick backend
         magick_processor = described_class.new(@file, {
-          geometry: "50x50#",
-          backend: :image_magick,
-          style: :magick_thumb
-        }, attachment)
+                                                 geometry: "50x50#",
+                                                 backend: :image_magick,
+                                                 style: :magick_thumb,
+                                               }, attachment)
         magick_result = magick_processor.make
 
         # Both should produce valid 50x50 images
@@ -108,20 +108,20 @@ describe Paperclip::Thumbnail do
 
         # Large preview with vips (faster for large images)
         vips_processor = described_class.new(@file, {
-          geometry: "200x200>",
-          backend: :vips,
-          style: :preview
-        }, attachment)
+                                               geometry: "200x200>",
+                                               backend: :vips,
+                                               style: :preview,
+                                             }, attachment)
         vips_result = vips_processor.make
 
         @file.rewind
 
         # Small thumbnail with image_magick
         magick_processor = described_class.new(@file, {
-          geometry: "32x32#",
-          backend: :image_magick,
-          style: :icon
-        }, attachment)
+                                                 geometry: "32x32#",
+                                                 backend: :image_magick,
+                                                 style: :icon,
+                                               }, attachment)
         magick_result = magick_processor.make
 
         # Verify dimensions
@@ -186,11 +186,9 @@ describe Paperclip::Thumbnail do
 
       context "with vips backend" do
         before do
-          begin
-            require "vips"
-          rescue LoadError
-            skip "libvips not installed"
-          end
+          require "vips"
+        rescue LoadError
+          skip "libvips not installed"
         end
 
         it "resizes image to specified dimensions" do
@@ -216,7 +214,7 @@ describe Paperclip::Thumbnail do
           # Verify it detects logical dimensions (rotated from 300x200 to 200x300)
           expect(processor.current_geometry.width).to eq(200)
           result = processor.make
-        
+
           cmd = %[identify -format "%wx%h" "#{result.path}"]
           # Original 300x200 with orientation 6 (90 deg CW).
           # Post autorot: 200x300.
@@ -225,7 +223,8 @@ describe Paperclip::Thumbnail do
         end
 
         it "strips metadata when requested via convert_options" do
-          processor = described_class.new(@file, { geometry: "50x50", convert_options: "-strip", backend: :vips }, attachment)
+          processor = described_class.new(@file, { geometry: "50x50", convert_options: "-strip", backend: :vips },
+                                          attachment)
           result = processor.make
 
           # identify -verbose shows less output when stripped
@@ -407,10 +406,10 @@ describe Paperclip::Thumbnail do
           # -strip is cross-platform, should work without warning
           expect(Paperclip).not_to receive(:log).with(/Warning/)
           processor = described_class.new(@file, {
-            geometry: "50x50",
-            backend: :vips,
-            convert_options: "-strip",
-          }, attachment)
+                                            geometry: "50x50",
+                                            backend: :vips,
+                                            convert_options: "-strip",
+                                          }, attachment)
           processor.make
         end
 
@@ -424,10 +423,10 @@ describe Paperclip::Thumbnail do
           # -density is ImageMagick-only, should warn
           expect(Paperclip).to receive(:log).with(/Warning.*density.*not supported.*vips/)
           processor = described_class.new(@file, {
-            geometry: "50x50",
-            backend: :vips,
-            convert_options: "-density 150",
-          }, attachment)
+                                            geometry: "50x50",
+                                            backend: :vips,
+                                            convert_options: "-density 150",
+                                          }, attachment)
           processor.make
         end
       end
@@ -439,10 +438,10 @@ describe Paperclip::Thumbnail do
       # Helper to create a thumbnail with specific convert_options
       def make_thumb_with_options(file, options_string)
         thumb = Paperclip::Thumbnail.new(file, {
-          geometry: "100x100",
-          convert_options: options_string,
-          backend: :image_magick,
-        }, attachment)
+                                           geometry: "100x100",
+                                           convert_options: options_string,
+                                           backend: :image_magick,
+                                         }, attachment)
         thumb.make
       end
 
@@ -576,11 +575,11 @@ describe Paperclip::Thumbnail do
           # Use JPEG to test interlacing (PNG reports format name instead)
           file = File.new(fixture_file("rotated.jpg"), "rb")
           thumb = Paperclip::Thumbnail.new(file, {
-            geometry: "100x100",
-            convert_options: "-interlace Plane",
-            backend: :image_magick,
-            format: :jpg,
-          }, attachment)
+                                             geometry: "100x100",
+                                             convert_options: "-interlace Plane",
+                                             backend: :image_magick,
+                                             format: :jpg,
+                                           }, attachment)
           result = thumb.make
 
           interlace = `identify -format "%[interlace]" "#{result.path}"`.strip
@@ -602,10 +601,10 @@ describe Paperclip::Thumbnail do
           # Use a square image for predictable crop results
           file = File.new(fixture_file("50x50.png"), "rb")
           thumb = Paperclip::Thumbnail.new(file, {
-            geometry: "50x50",  # Keep original size
-            convert_options: "-crop 25x25+0+0 +repage",
-            backend: :image_magick,
-          }, attachment)
+                                             geometry: "50x50", # Keep original size
+                                             convert_options: "-crop 25x25+0+0 +repage",
+                                             backend: :image_magick,
+                                           }, attachment)
           result = thumb.make
 
           dimensions = `identify -format "%wx%h" "#{result.path}"`.strip
@@ -759,11 +758,9 @@ describe Paperclip::Thumbnail do
       let(:attachment) { double("Attachment", options: {}) }
 
       before do
-        begin
-          require "vips"
-        rescue LoadError
-          skip "libvips not installed"
-        end
+        require "vips"
+      rescue LoadError
+        skip "libvips not installed"
       end
 
       # Helper to create a thumbnail with vips backend and specific convert_options
@@ -1211,8 +1208,11 @@ describe Paperclip::Thumbnail do
           end
 
           def width; 100; end
+
           def height; 100; end
+
           def modifier; nil; end
+
           def auto_orient; end
         end
 
@@ -1237,7 +1237,9 @@ describe Paperclip::Thumbnail do
           end
 
           def width; 151; end
+
           def height; 167; end
+
           def modifier; nil; end
         end
 
@@ -1403,7 +1405,7 @@ describe Paperclip::Thumbnail do
           @file,
           geometry: "50x50",
           frame_index: 5,
-          format: :jpg
+          format: :jpg,
         )
       end
 
@@ -1415,11 +1417,9 @@ describe Paperclip::Thumbnail do
 
     context "with vips backend" do
       before do
-        begin
-          require "vips"
-        rescue LoadError
-          skip "libvips not installed"
-        end
+        require "vips"
+      rescue LoadError
+        skip "libvips not installed"
       end
 
       it "preserves animation when output is GIF" do
@@ -1431,7 +1431,8 @@ describe Paperclip::Thumbnail do
       end
 
       it "collapses animation when animated: false is set" do
-        processor = Paperclip::Thumbnail.new(@file, { geometry: "50x50", format: :gif, animated: false, backend: :vips })
+        processor = Paperclip::Thumbnail.new(@file,
+                                             { geometry: "50x50", format: :gif, animated: false, backend: :vips })
         dst = processor.make
         cmd = %[identify -format "%wx%h," "#{dst.path}"]
         frames = `#{cmd}`.chomp.split(",").reject(&:empty?)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jr-paperclip
 version: !ruby/object:Gem::Version
-  version: 8.0.0.beta.1
+  version: 8.0.0
 platform: ruby
 authors:
 - Jukka Rautanen
@@ -389,7 +389,6 @@ extra_rdoc_files: []
 files:
 - ".github/FUNDING.yml"
 - ".github/ISSUE_TEMPLATE/bug_report.md"
-- ".github/ISSUE_TEMPLATE/custom.md"
 - ".github/ISSUE_TEMPLATE/feature_request.md"
 - ".github/workflows/reviewdog.yml"
 - ".github/workflows/tests.yml"
@@ -533,6 +532,7 @@ files:
 - spec/paperclip/matchers/validate_attachment_size_matcher_spec.rb
 - spec/paperclip/media_type_spoof_detector_spec.rb
 - spec/paperclip/meta_class_spec.rb
+- spec/paperclip/migration_guide_example_spec.rb
 - spec/paperclip/paperclip_missing_attachment_styles_spec.rb
 - spec/paperclip/paperclip_spec.rb
 - spec/paperclip/plural_cache_spec.rb
@@ -673,6 +673,7 @@ test_files:
 - spec/paperclip/matchers/validate_attachment_size_matcher_spec.rb
 - spec/paperclip/media_type_spoof_detector_spec.rb
 - spec/paperclip/meta_class_spec.rb
+- spec/paperclip/migration_guide_example_spec.rb
 - spec/paperclip/paperclip_missing_attachment_styles_spec.rb
 - spec/paperclip/paperclip_spec.rb
 - spec/paperclip/plural_cache_spec.rb

data/.github/ISSUE_TEMPLATE/custom.md

@@ -1,10 +0,0 @@
----
-name: Custom issue template
-about: Describe this issue template's purpose here.
-title: ''
-labels: ''
-assignees: ''
-
----
-
-