jr-paperclip 7.3.0 → 8.0.0.beta.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2dcb9d6123a7e2e8cac589cb8675ab223acb02870cda095be974c5a4a462da46
-  data.tar.gz: 0e33374335cda82378019b9568a2434cf02335067f5145d21c6b2543513a7154
+  metadata.gz: '08e0a02cb6a9a3a1b126b744de6afe4654e9db7bf841bb710ac29b3cb702f5a2'
+  data.tar.gz: 5c3c603853869aa41d56026de0d71788f87f7b98ec4d8382adc811e23bc9eb42
 SHA512:
-  metadata.gz: 4450a199ec6fd0fd5ba03ac8def770360ce3b130d91c5127d3ec91cb6ce909d8eaf7ec328b031fb228f0b326382bfbf4752f92784051e25f272fdd18fdebfd81
-  data.tar.gz: e3806c9846036615aad3f8df575fd3a92efe281ac731df2dc9f3f82a1942d6c7b090a10b083c5f287ae0cf1a56699913e5614e0e548075df16c3a5c8b180d255
+  metadata.gz: 9b71eb967b7cb2b0980e665c4886bbb5754bac409677b0af4e13578101dde22d710ab2bc11e31287dac3e99520f53f9e9b44fe79f5285f5fd5aa2cfe070edf43
+  data.tar.gz: ab955ec831d70c792bcaccbb41b5e2b6754fe0badddc1a52735d5a974f0982e3cdda316e5db9a274da73132482515ebf5b74775780d8e179e6d2493154370610

data/.github/workflows/{test.yml → tests.yml}

@@ -1,4 +1,4 @@
-name: Test
+name: Tests
 
 on:
   push:
@@ -13,13 +13,23 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: ['3.2', '3.3', '3.4']
-        gemfile:
-          - gemfiles/7.0.gemfile
-          - gemfiles/7.1.gemfile
-          - gemfiles/7.2.gemfile
-          - gemfiles/8.0.gemfile
-          - gemfiles/8.1.gemfile
+        include:
+          - ruby: '3.0'
+            gemfile: gemfiles/7.0.gemfile
+          - ruby: '3.1'
+            gemfile: gemfiles/7.1.gemfile
+          - ruby: '3.2'
+            gemfile: gemfiles/7.2.gemfile
+          - ruby: '3.3'
+            gemfile: gemfiles/8.0.gemfile
+          - ruby: '3.4'
+            gemfile: gemfiles/7.2.gemfile
+          - ruby: '3.4'
+            gemfile: gemfiles/8.0.gemfile
+          - ruby: '3.4'
+            gemfile: gemfiles/8.1.gemfile
+          - ruby: '4.0'
+            gemfile: gemfiles/8.1.gemfile
 
     env:
       BUNDLE_GEMFILE: ${{ matrix.gemfile }}
@@ -36,7 +46,7 @@ jobs:
       - name: Install dependencies
         run: |
           sudo apt-get update
-          sudo apt-get install -y ghostscript imagemagick
+          sudo apt-get install -y ghostscript imagemagick libvips
           sudo rm -f /etc/ImageMagick-6/policy.xml
 
       - name: Run tests

data/.rubocop.yml

@@ -3,7 +3,7 @@ plugins:
 
 AllCops:
   NewCops: disable
-  TargetRubyVersion: 3.2
+  TargetRubyVersion: 3.0
   Include:
     - "**/*.gemspec"
     - "**/*.podspec"
@@ -24,6 +24,7 @@ AllCops:
     - "vendor/**/*"
     - "db/schema.rb"
     - 'gemfiles/vendor/**/*'
+    - 'tmp/**/*'
 Naming/AccessorMethodName:
   Description: Check the naming of accessor methods for get_/set_.
   Enabled: false

data/CONTRIBUTING.md

@@ -13,7 +13,7 @@ Here's a quick guide for contributing:
 1. Make sure you have ImageMagick and Ghostscript installed. See [this section](./README.md#image-processor) of the README.
 
 1. Run the tests. We only take pull requests with passing tests, and it's great
-to know that you have a clean slate: `bundle && bundle exec rake`
+to know that you have a clean slate: `bundle && bundle exec appraisal rake`
 
 1. Add a test for your change. Only refactoring and documentation changes
 require no new tests. If you are adding functionality or fixing a bug, we need

data/Gemfile

@@ -10,6 +10,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/NEWS

@@ -1,5 +1,20 @@
-7.3.0 (2025-12-16)
+8.0.0.beta.1 (2026-01-09)
+
+* Feature: Add libvips backend alongside ImageMagick via the image_processing gem
+* Feature: Per-attachment and per-style backend selection (`:backend` option)
+* Feature: ImageMagick 7 detection (uses `magick` command when available)
+* Feature: Add `ALLOWED_IMAGEMAGICK_OPTIONS` security whitelist (GHSA-r4mg-4433-c7g3)
+* Feature: Cross-platform convert_options support (-strip, -quality, -rotate, etc.)
+* Documentation: Add VIPS_MIGRATION_GUIDE.md with step-by-step migration instructions
+* Documentation: Expand README with backend configuration examples
+* Chores: Add image_processing ~> 1.14 as runtime dependency
+* Chores: CI now installs libvips for testing both backends
+* Tests: Comprehensive test coverage for both backends, geometry modifiers, and convert options
+
+7.3.1 (2025-12-17)
+* Improvement: Relax Ruby requirement to 3.0 and optimize CI matrix
 
+7.3.0 (2025-12-16)
 * Breaking: Require Ruby >= 3.2.0 and Rails >= 7.0.0
 * Feature: Add support for Rails 7.0, 7.1, 7.2, 8.0, and 8.1
 * Improvement: Support aws-sdk-s3 >= 1.196.1 with TransferManager for multipart uploads/downloads

data/README.md

@@ -1,11 +1,12 @@
 Paperclip
 =========
 
+[![Gem Version](https://badge.fury.io/rb/jr-paperclip.svg)](https://rubygems.org/gems/jr-paperclip)
 [![Maintainability](https://qlty.sh/gh/jukra/projects/jr-paperclip/maintainability.svg)](https://qlty.sh/gh/jukra/projects/jr-paperclip)
-![Tests](https://github.com/jukra/jr-paperclip/actions/workflows/test.yml/badge.svg)
-![Reviewdog](https://github.com/jukra/jr-paperclip/actions/workflows/reviewdog.yml/badge.svg)
+[![Tests](https://github.com/jukra/jr-paperclip/actions/workflows/tests.yml/badge.svg)](https://github.com/jukra/jr-paperclip/actions/workflows/tests.yml)
+[![reviewdog](https://github.com/jukra/jr-paperclip/actions/workflows/reviewdog.yml/badge.svg)](https://github.com/jukra/jr-paperclip/actions/workflows/reviewdog.yml)
 
-**Revived fork with active maintenance and support for Rails 7.0, 7.1, 8.0, and 8.1 on Ruby 3.2 and newer.**
+**Revived fork with active maintenance and support for Rails 7.0, 7.1, 8.0, and 8.1 on Ruby 3.0 and newer.**
 
 If you are looking for older versions, please check the [original fork](https://github.com/kreeti/kt-paperclip).
 
@@ -57,6 +58,7 @@ Please feel free to contribute Issues and pull requests.
   - [Understanding Storage](#understanding-storage)
 - [IO Adapters](#io-adapters)
 - [Post Processing](#post-processing)
+- [Image Processing Backends](#image-processing-backends)
 - [Custom Attachment Processors](#custom-attachment-processors)
 - [Events](#events)
 - [URI Obfuscation](#uri-obfuscation)
@@ -103,6 +105,10 @@ Paperclip now requires Ruby version **>= 2.3** and Rails version **>= 4.2**
 
 ### Image Processor
 
+Paperclip supports two main image processing backends: **ImageMagick** (default) and **libvips** (recommended for performance).
+
+#### ImageMagick
+
 [ImageMagick](http://www.imagemagick.org) must be installed and Paperclip must have access to it. To ensure
 that it does, on your command line, run `which convert` (one of the ImageMagick
 utilities). This will give you the path where that utility is installed. For
@@ -131,6 +137,32 @@ the following with apt-get:
 
     sudo apt-get install imagemagick -y
 
+#### libvips (Recommended for Performance)
+
+[libvips](https://www.libvips.org/) is significantly faster and uses less memory than ImageMagick. 
+
+To use libvips, install the system library:
+
+```bash
+# macOS
+brew install vips
+
+# Ubuntu/Debian
+sudo apt install libvips
+```
+
+Then configure Paperclip to use it as the default backend in `config/initializers/paperclip.rb` (or in your environment configuration):
+
+```ruby
+config.paperclip_defaults = {
+  backend: :vips
+}
+```
+
+You can also specify the backend per-attachment (see [Image Processing Backends](#image-processing-backends)).
+
+**Note on Geometry Detection:** When `vips` is the active backend, Paperclip uses the ruby-vips gem to determine image dimensions instead of ImageMagick's `identify` command.
+
 ### `file`
 
 The Unix [`file` command](https://en.wikipedia.org/wiki/File_(command)) is required for content-type checking.
@@ -690,11 +722,11 @@ 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 ImageMagick to process
-images; [ImageMagick's geometry documentation](http://www.imagemagick.org/script/command-line-processing.php#geometry)
-has more information on the accepted style formats.
+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.
 
-For more fine-grained control of the conversion process, `source_file_options` and `convert_options` can be used to pass flags and settings directly to ImageMagick's powerful Convert tool, [documented here](https://www.imagemagick.org/script/convert.php). For example:
+For more fine-grained control of the conversion process, `source_file_options` and `convert_options` can be used. These options are parsed and applied to the `image_processing` pipeline.
 
 ```ruby
 has_attached_file :image, styles: { regular: ['800x800>', :png]},
@@ -702,6 +734,42 @@ 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:
+
+*   **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.
+
+### Cross-Platform Convert Options
+
+Many common `convert_options` now work with **both** ImageMagick and libvips backends:
+
+| 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"` |
+| `-auto-orient` | Auto-rotate via EXIF | `convert_options: "-auto-orient"` |
+| `-interlace X` | Progressive output | `convert_options: "-interlace Plane"` |
+
+Example:
+
+```ruby
+has_attached_file :avatar,
+  styles: { thumb: "100x100#" },
+  convert_options: { all: "-strip -quality 80" }
+```
+
+**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`
@@ -712,6 +780,48 @@ For a full list of variables and description, see [ImageMagick's resources docum
 
 ---
 
+Image Processing Backends
+-------------------------
+
+jr-paperclip supports two image processing backends:
+
+### ImageMagick (Default)
+
+The traditional backend, using ImageMagick via shell commands.
+
+```ruby
+has_attached_file :avatar,
+  styles: { thumb: "100x100#" }
+```
+
+### libvips (Recommended for Performance)
+
+libvips is significantly faster and uses less memory than ImageMagick.
+
+**Usage:**
+
+```ruby
+# Global default (in config/initializers/paperclip.rb or environment config)
+config.paperclip_defaults = {
+  backend: :vips
+}
+
+# Or per-attachment
+has_attached_file :avatar,
+  styles: { thumb: "100x100#" },
+  backend: :vips,
+  convert_options: { all: "-strip -quality 75" }
+
+# Per-style backend selection (mix backends in one attachment)
+has_attached_file :document,
+  styles: {
+    preview: { geometry: "800x800>", backend: :vips },
+    thumb: { geometry: "100x100#", backend: :image_magick }
+  }
+```
+
+---
+
 Custom Attachment Processors
 -------
 
@@ -1078,6 +1188,7 @@ Thank you to all [the contributors](https://github.com/jukra/jr-paperclip/graphs
 License
 -------
 
-Copyright © 2020-2021 Kreeti Technologies Pvt. Ltd.
+Copyright (c) 2025- Jukka Rautanen
+Copyright © 2020-2025 Kreeti Technologies Pvt. Ltd.
 Copyright © 2008-2017 thoughtbot, inc.
 It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.

data/UPGRADING

@@ -0,0 +1,5 @@
+jr-paperclip – HEADS UP (major changes)
+
+This version adds libvips support as a high-performance alternative to ImageMagick.
+It also introduces ImageMagick 7 compatibility and updates geometry detection behavior.
+For migration instructions and details, see README.md and VIPS_MIGRATION_GUIDE.md.

data/VIPS_MIGRATION_GUIDE.md

@@ -0,0 +1,131 @@
+# Migrating to the libvips Backend
+
+Paperclip now supports [libvips](https://www.libvips.org/) via the `image_processing` gem. libvips is significantly faster and uses much less memory than ImageMagick, making it highly recommended for production environments.
+
+This guide explains how to migrate your application to use libvips, either globally or gradually.
+
+## Prerequisites
+
+You must install the libvips system library on your server or development machine:
+
+```bash
+# macOS
+brew install vips
+
+# Ubuntu/Debian
+sudo apt install libvips
+```
+
+## Step 1: Update your Gemfile
+
+`jr-paperclip` already includes the `image_processing` gem, which automatically provides the `ruby-vips` and `mini_magick` bindings. You do **not** need to add these gems explicitly to your `Gemfile`.
+
+Ensure you are using the latest version of the gem:
+
+```ruby
+gem "jr-paperclip", "~> 8.0.0.beta"
+```
+
+## Step 2: Gradual Migration (Per-Attachment)
+
+The safest way to migrate is one attachment at a time. This allows you to verify that the output remains consistent and doesn't interfere with existing custom processors.
+
+Simply add the `backend: :vips` option to a specific attachment:
+
+```ruby
+class User < ActiveRecord::Base
+  has_attached_file :avatar,
+    styles: { medium: "300x300>", thumb: "100x100#" },
+    backend: :vips
+end
+```
+
+Other attachments in your application will continue to use ImageMagick by default.
+
+## Step 3: Cross-Platform Convert Options
+
+Good news! Many common `convert_options` now work with **both** ImageMagick and libvips backends. You can keep using them as-is:
+
+### 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 |
+
+**Example:**
+```ruby
+has_attached_file :avatar,
+  styles: { thumb: "100x100#" },
+  backend: :vips,
+  convert_options: { all: "-strip -quality 80" }
+```
+
+### 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:
+
+`-density`, `-depth`, `-gravity`, `-crop`, `-extent`, `-alpha`, `-background`, `-type`, `-posterize`, `-dither`, `-colors`, `-channel`, `-transpose`, `-transverse`, `-normalize`, `-equalize`, `-trim`, `-monochrome`
+
+If you rely heavily on these options, consider keeping those specific attachments on the ImageMagick backend.
+
+## Step 4: Handling Custom Processors
+
+If you have custom processors defined in `lib/paperclip`, they will continue to work even if you switch the primary backend to `:vips`, as long as they are still calling the `convert` or `identify` helper methods.
+
+However, if you want to migrate a custom processor to libvips, you can now use the `vips`, `vips_image` and `vipsheader` helpers:
+
+```ruby
+module Paperclip
+  class MyVipsProcessor < Processor
+    def make
+      # 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
+```
+
+## Step 5: Global Migration
+
+Once you have verified that your attachments and processors work correctly with libvips, you can switch the entire application over by updating your global configuration:
+
+```ruby
+# config/initializers/paperclip.rb or config/environments/production.rb
+config.paperclip_defaults = {
+  backend: :vips,
+  convert_options: { all: "-strip -quality 85" }
+}
+```
+
+You can also use per-style backend selection to mix backends within a single attachment:
+
+```ruby
+has_attached_file :document,
+  styles: {
+    # Use vips for large previews (faster)
+    preview: { geometry: "800x800>", backend: :vips },
+    # Use ImageMagick for thumbnails needing specific options
+    thumb: { geometry: "100x100#", backend: :image_magick }
+  }
+```
+
+## Important Considerations
+
+1.  **Output Parity**: While libvips aims for high quality, its resizing algorithms (Lanczos) may produce slightly different visual results than ImageMagick.
+2.  **PDF/SVG Support**: libvips requires additional libraries (like `poppler` or `librsvg`) to process these formats. If you process complex vector formats, ensure the appropriate libraries are installed on your system.
+3.  **Exotic Formats**: If you rely on very specific ImageMagick features (like specialized filters or complex layer manipulation), test those attachments thoroughly before switching.

data/features/basic_integration.feature

@@ -83,3 +83,30 @@ Feature: Rails integration
     Then I should see "Name: something"
     And I should see an image with a path of "//s3.amazonaws.com/paperclip/attachments/original/5k.png"
     And the file at "//s3.amazonaws.com/paperclip/attachments/original/5k.png" should be uploaded to S3
+
+  Scenario: libvips integration test
+    Given I add this snippet to config/application.rb:
+      """
+      config.paperclip_defaults = {
+        :backend => :vips
+      }
+      """
+    And I attach :attachment with:
+      """
+      url: "/system/:attachment/:style/:filename",
+      styles: { thumb: "100x100#" }
+      """
+    And I start the rails application
+    And I overwrite "app/views/users/show.html.erb" with:
+      """
+      <p>Name: <%= @user.name %></p>
+      <p>Original: <%= image_tag @user.attachment.url(:original) %></p>
+      <p>Thumb: <%= image_tag @user.attachment.url(:thumb) %></p>
+      """
+    When I go to the new user page
+    And I fill in "Name" with "vips user"
+    And I attach the file "spec/support/fixtures/5k.png" to "Attachment"
+    And I press "Submit"
+    Then I should see "Name: vips user"
+    And the file at "/system/attachments/original/5k.png" should have dimensions "434x66"
+    And the file at "/system/attachments/thumb/5k.png" should have dimensions "100x100"

data/features/step_definitions/attachment_steps.rb

@@ -86,6 +86,23 @@ Then /^the attachment file "([^"]*)" should (not )?exist$/ do |filename, not_exi
   end
 end
 
+Then /^the file at "([^"]*)" should have dimensions "([^"]*)"$/ do |web_path, dimension|
+  cd(".") do
+    local_path = "public#{web_path}"
+    # Try identify first, then vipsheader
+    require "shellwords"
+    escaped_path = Shellwords.escape(local_path)
+    geometry = `identify -format "%wx%h" #{escaped_path} 2>/dev/null`.strip
+    if geometry.empty?
+      width = `vipsheader -f width #{escaped_path} 2>/dev/null`.strip
+      height = `vipsheader -f height #{escaped_path} 2>/dev/null`.strip
+      geometry = "#{width}x#{height}"
+    end
+    raise "Could not determine dimensions for #{local_path}" if geometry == "x" || geometry.empty?
+    expect(geometry).to eq(dimension)
+  end
+end
+
 Then /^I should have attachment columns for "([^"]*)"$/ do |attachment_name|
   cd(".") do
     columns = eval(`bundle exec rails runner "puts User.columns.map{ |column| [column.name, column.sql_type] }.inspect"`.strip)

data/gemfiles/7.0.gemfile

@@ -11,6 +11,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/gemfiles/7.1.gemfile

@@ -11,6 +11,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/gemfiles/7.2.gemfile

@@ -11,6 +11,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/gemfiles/8.0.gemfile

@@ -11,6 +11,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/gemfiles/8.1.gemfile

@@ -11,6 +11,7 @@ group :development, :test do
   gem "activerecord-import"
   gem "bootsnap", require: false
   gem "builder"
+  gem "image_processing", "~> 1.14"
   gem "listen"
   gem "rspec"
   gem "rubocop", require: false

data/lib/paperclip/attachment.rb

@@ -34,7 +34,8 @@ module Paperclip
         validate_media_type:               true,
         adapter_options:                   { hash_digest: Digest::MD5 },
         check_validity_before_processing:  true,
-        return_file_attributes_on_destroy: false
+        return_file_attributes_on_destroy: false,
+        backend:                           Paperclip.options[:backend]
       }
     end
 
@@ -537,7 +538,7 @@ module Paperclip
                                 for(@queued_for_write[name], @options[:adapter_options])
       unadapted_file.close if unadapted_file.respond_to?(:close)
       @queued_for_write[name]
-    rescue Paperclip::Errors::NotIdentifiedByImageMagickError => e
+    rescue Paperclip::Errors::NotIdentifiedByBackendError => e
       log("An error was received while processing: #{e.inspect}")
       (@errors[:processing] ||= []) << e.message if @options[:whiny]
     ensure

data/lib/paperclip/errors.rb

@@ -18,12 +18,11 @@ module Paperclip
     class MissingRequiredValidatorError < Paperclip::Error
     end
 
-    # Will be thrown when ImageMagic cannot determine the uploaded file's
-    # metadata, usually this would mean the file is not an image. If you are
-    # consistently receiving this error on PDFs make sure that you have
-    # installed Ghostscript.
-    class NotIdentifiedByImageMagickError < Paperclip::Error
+    # Will be thrown when the backend cannot determine the uploaded file's
+    # metadata, usually this would mean the file is not an image.
+    class NotIdentifiedByBackendError < Paperclip::Error
     end
+    NotIdentifiedByImageMagickError = NotIdentifiedByBackendError
 
     # Will be thrown if the interpolation is creating an infinite loop. If you
     # are creating an interpolator which might cause an infinite loop, you

data/lib/paperclip/geometry.rb

@@ -21,8 +21,8 @@ module Paperclip
     end
 
     # Extracts the Geometry from a file (or path to a file)
-    def self.from_file(file)
-      GeometryDetector.new(file).make
+    def self.from_file(file, backend = nil)
+      GeometryDetector.new(file, backend: backend).make
     end
 
     # Extracts the Geometry from a "WxH,O" string
@@ -84,7 +84,7 @@ module Paperclip
       to_s
     end
 
-    # Returns the scaling and cropping geometries (in string-based ImageMagick format)
+    # Returns the scaling and cropping geometries (in string format)
     # neccessary to transform this Geometry into the Geometry given. If crop is true,
     # then it is assumed the destination Geometry will be the exact final resolution.
     # In this case, the source Geometry is scaled so that an image containing the