image_processing 0.11.2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 99835dc44c17bab77f81bca431807996d31042d2
-  data.tar.gz: c6b0c1b08d70e871a90f63ae66e5a501edc7c521
+  metadata.gz: 8c6647897aed5a610f76eae2edef4327ec092653
+  data.tar.gz: '09335920e634fc2cb83a8be2111dda2c340421e2'
 SHA512:
-  metadata.gz: 529a954d4f587f756e55aa5316743f34747c5786c0c8ec729db1a9977c24bc5304575e9a96394d5270f234e180240fbd0f33035c0640e89993687377df4e744d
-  data.tar.gz: b6752c0ec43316e402b30bd54bd714b392bba09aac391979d4502c54f915cce2ceb989fcf3b366982c16084cc5208fa2168bb67a0d2097ba98b8c1a126fa966b
+  metadata.gz: f1fbf330dc866bcabe44121cdf1f27ee488db46cbcdcc0d6cbfae07b95c9064740047d5faf63a02fc2ce6e11e14b8cf425dfa59ae716ff964ec5947a5e98be96
+  data.tar.gz: 332f2ad092e5ea7a5bda88388d152d11f8a788cd7659cb53e8370a83fcd5358c4078d677af6d89e594adfa04e050d12b2fcd4dcb1d2586020449b5285f098cb1

data/CHANGELOG.md

@@ -1,3 +1,25 @@
+## 1.0.0 (2018-04-04)
+
+* Depend on `mini_magick` and `ruby-vips` gems (@janko-m, @mokolabs)
+
+* [minimagick] Remove deprecated API in favor of the chainable API (@janko-m)
+
+* [core] Rename `Builder#default_options` to `Builder#options` (@janko-m)
+
+* [minimagick] Remove `:fail` loader option in favor of the existing `:regard_warnings` (@janko-m)
+
+* [vips, minimagick] Don't fail on warnings when loading the image (@janko-m)
+
+* [vips] Don't apply `Vips::Image#autorot` if `:autorotate` loader option was passed in (@janko-m)
+
+* [minimagick] Allow using value `nil` to add ImageMagick options that don't have a value (@janko-m)
+
+* [vips] Accept `:quality` saver option as an alias to `:Q` (@janko-m)
+
+* [minimagick] Automatically sharpen thumbnails after resizing (@janko-m, @mokolabs)
+
+* [vips] Automatically sharpen thumbnails after resizing (@janko-m, @mokolabs)
+
 ## 0.11.2 (2018-03-31)
 
 * [minimagick] Avoid `#resize_*` operations stripping data by switching back to `-resize` (@janko-m)

data/README.md

@@ -1,17 +1,44 @@
 # ImageProcessing
 
-Provides higher-level image processing functionality that is commonly needed
-when accepting user uploads. Supports processing with [libvips] and [ImageMagick].
+Provides higher-level image processing helpers that are commonly needed
+when handling image uploads.
+
+This gem can process images with either [ImageMagick] or [libvips] libraries.
+ImageMagick is a good default choice, especially if you are migrating from
+another gem or library that uses ImageMagick. libvips is a newer library that
+can process images [very rapidly][libvips performance] (up to 10x faster than
+ImageMagick).
+
+
+## Goal
+
+The goal of this project is to have a single gem that contains all the
+helper methods needed to resize and process images.
+
+Currently, existing attachment gems (like Paperclip, CarrierWave, Refile,
+Dragonfly, ActiveStorage, and others) implement their own custom image
+helper methods. But why? That's not very DRY, is it?
+
+Let's be honest. Image processing is a dark, mysterious art. So we want to
+combine every great idea from all of these separate gems into a single awesome
+library that is constantly updated with best-practice thinking about
+how to resize and process images.
 
-The goal of this project is to have a single place where common image
-processing helper methods are maintained, instead of Paperclip, CarrierWave,
-Refile, Dragonfly and ActiveStorage each implementing their own versions.
 
 ## Installation
 
-```rb
-gem "image_processing", "~> 0.11"
-```
+1. Install ImageMagick and/or libvips:
+
+  ```sh
+  $ brew install imagemagick vips
+  ```
+
+2. Add the gem to your Gemfile:
+
+  ```rb
+  gem "image_processing", "~> 1.0"
+  ```
+
 
 ## Usage
 
@@ -28,10 +55,10 @@ processed = ImageProcessing::MiniMagick
   .convert("png")
   .call
 
-processed #=> #<File:/var/folders/.../image_processing20180316-18446-1j247h6.png>
+processed #=> #<Tempfile:/var/folders/.../image_processing20180316-18446-1j247h6.png>
 ```
 
-This allows easy branching when generating multiple derivatives:
+This allows easy branching when generating multiple derivates:
 
 ```rb
 require "image_processing/vips"
@@ -70,6 +97,25 @@ processed = ImageProcessing::MiniMagick
   .resize_to_limit!(400, 400) # bang method
 ```
 
+You can inspect the pipeline options at any point before executing it:
+
+```rb
+pipeline = ImageProcessing::MiniMagick
+  .source(image)
+  .loader(page: 1)
+  .convert("png")
+  .resize_to_limit(400, 400)
+  .strip
+
+pipeline.options
+# => {:source=>#<File:/path/to/source.jpg>,
+#     :loader=>{:page=>1},
+#     :saver=>{},
+#     :format=>"png",
+#     :operations=>[[:resize_to_limit, [400, 400]], [:strip, []]],
+#     :processor_class=>ImageProcessing::MiniMagick::Processor}
+```
+
 The source object needs to responds to `#path`, or be a String, a Pathname, or
 a `Vips::Image`/`MiniMagick::Tool` object.
 
@@ -80,10 +126,10 @@ ImageProcessing::Vips.source(Pathname.new("source.jpg"))
 ImageProcessing::Vips.source(Vips::Image.new_from_file("source.jpg"))
 ```
 
-Without any call options the result of processing is a newly created `Tempfile`
-object. You can save processing result to a specific location by passing
-`:destination` to `#call`. You can also pass `save: false` to `#call` to
-retrieve the raw `Vips::Image`/`MiniMagick::Tool` object.
+When `#call` is called without options, the result of processing is a
+`Tempfile` object. You can save the processing result to a specific location by
+passing `:destination` to `#call`, or pass `save: false` to retrieve the raw
+`Vips::Image`/`MiniMagick::Tool` object.
 
 ```rb
 pipeline = ImageProcessing::Vips.source(image)
@@ -100,10 +146,10 @@ You can continue reading the API documentation for specific modules:
 
 See the **[wiki]** for additional "How To" guides for common scenarios.
 
+
 ## Contributing
 
-Test suite requires `imagemagick` and `libvips` to be installed. On Mac OS you
-can install them with Homebrew:
+Our test suite requires both `imagemagick` and `libvips` libraries to be installed.
 
 ```
 $ brew install imagemagick vips
@@ -115,18 +161,29 @@ Afterwards you can run tests with
 $ bundle exec rake test
 ```
 
+
+## Feedback
+
+We welcome your feedback! What would you like to see added to image_processing?
+How can we improve this gem? Open an issue and let us know!
+
+
 ## Credits
 
 The `ImageProcessing::MiniMagick` functionality was extracted from
-[refile-mini_magick].
+[refile-mini_magick]. The chainable interface was heavily inspired by
+[HTTP.rb].
+
 
 ## License
 
 [MIT](LICENSE.txt)
 
-[libvps]: http://jcupitt.github.io/libvips/
+[libvips]: http://jcupitt.github.io/libvips/
 [ImageMagick]: https://www.imagemagick.org
 [`ImageProcessing::Vips`]: /doc/vips.md#imageprocessingvips
 [`ImageProcessing::MiniMagick`]: /doc/minimagick.md#imageprocessingminimagick
 [refile-mini_magick]: https://github.com/refile/refile-mini_magick
 [wiki]: https://github.com/janko-m/image_processing/wiki
+[HTTP.rb]: https://github.com/httprb/http
+[libvips performance]: https://github.com/jcupitt/libvips/wiki/Speed-and-memory-use

data/image_processing.gemspec

@@ -16,11 +16,12 @@ Gem::Specification.new do |spec|
   spec.files         = Dir["README.md", "LICENSE.txt", "CHANGELOG.md", "lib/**/*.rb", "*.gemspec"]
   spec.require_paths = ["lib"]
 
+  spec.add_dependency "mini_magick", "~> 4.0"
+  spec.add_dependency "ruby-vips", ">= 2.0.10", "< 3"
+
   spec.add_development_dependency "rake"
   spec.add_development_dependency "minitest", "~> 5.8"
   spec.add_development_dependency "minitest-hooks", ">= 1.4.2"
   spec.add_development_dependency "minispec-metadata"
-  spec.add_development_dependency "mini_magick", ">= 4.3.5"
-  spec.add_development_dependency "ruby-vips", ">= 2.0.0"
   spec.add_development_dependency "phashion" unless RUBY_ENGINE == "jruby"
 end

data/lib/image_processing/builder.rb

@@ -2,12 +2,14 @@ module ImageProcessing
   class Builder
     include Chainable
 
+    attr_reader :options
+
     def initialize(options)
-      @default_options = options
+      @options = options
     end
 
     def call!(**options)
-      Pipeline.new(default_options).call(**options)
+      Pipeline.new(self.options).call(**options)
     end
   end
 end

data/lib/image_processing/chainable.rb

@@ -1,30 +1,23 @@
 module ImageProcessing
   module Chainable
     def source(file)
-      branch default_options.merge(source: file)
+      branch source: file
     end
 
     def convert(format)
-      branch default_options.merge(format: format)
+      branch format: format
     end
 
     def loader(**options)
-      loader = default_options[:loader].merge(options)
-      branch default_options.merge(loader: loader)
+      branch loader: options
     end
 
     def saver(**options)
-      saver = default_options[:saver].merge(options)
-      branch default_options.merge(saver: saver)
-    end
-
-    def operation(name, *args)
-      operations = default_options[:operations] + [[name, args]]
-      branch default_options.merge(operations: operations)
+      branch saver: options
     end
 
     def custom(&block)
-      block ? operation(:custom, block) : self
+      operation :custom, block
     end
 
     def method_missing(name, *args)
@@ -37,29 +30,39 @@ module ImageProcessing
       end
     end
 
+    def operation(name, *args)
+      branch operations: [[name, args]]
+    end
+
     def call(file = nil, destination: nil, **call_options)
-      options = default_options
+      options = {}
       options = options.merge(source: file) if file
       options = options.merge(destination: destination) if destination
 
       branch(options).call!(**call_options)
     end
 
-    def branch(options)
+    def branch(loader: nil, saver: nil, operations: nil, **other_options)
+      options = respond_to?(:options) ? self.options : DEFAULT_OPTIONS
+
+      options = options.merge(loader: options[:loader].merge(loader)) if loader
+      options = options.merge(saver: options[:saver].merge(saver)) if saver
+      options = options.merge(operations: options[:operations] + operations) if operations
       options = options.merge(processor_class: self::Processor) unless self.is_a?(Builder)
+      options = options.merge(other_options)
+
+      options.freeze
 
       Builder.new(options)
     end
 
-    def default_options
-      @default_options ||= {
-        source:          nil,
-        loader:          {},
-        saver:           {},
-        format:          nil,
-        operations:      [],
-        processor_class: nil,
-      }
-    end
+    DEFAULT_OPTIONS = {
+      source:          nil,
+      loader:          {},
+      saver:           {},
+      format:          nil,
+      operations:      [],
+      processor_class: nil,
+    }.freeze
   end
 end

data/lib/image_processing/mini_magick.rb

@@ -1,14 +1,10 @@
-gem "mini_magick", "~> 4.0"
 require "mini_magick"
-
 require "image_processing"
-require "image_processing/mini_magick/deprecated_api"
 
 module ImageProcessing
   module MiniMagick
     def self.valid_image?(file)
       ::MiniMagick::Tool::Convert.new do |convert|
-        convert.regard_warnings
         convert << file.path
         convert << "null:"
       end
@@ -18,27 +14,28 @@ module ImageProcessing
     end
 
     class Processor < ImageProcessing::Processor
-      IMAGE_CLASS = ::MiniMagick::Tool
+      IMAGE_CLASS        = ::MiniMagick::Tool
+      SHARPEN_PARAMETERS = { radius: 0, sigma: 1 }
 
-      def resize_to_limit(magick, width, height)
-        magick.resize "#{width}x#{height}>"
+      def resize_to_limit(magick, width, height, **options)
+        thumbnail(magick, "#{width}x#{height}>", **options)
       end
 
-      def resize_to_fit(magick, width, height)
-        magick.resize "#{width}x#{height}"
+      def resize_to_fit(magick, width, height, **options)
+        thumbnail(magick, "#{width}x#{height}", **options)
       end
 
-      def resize_to_fill(magick, width, height, gravity: "Center")
-        magick.resize "#{width}x#{height}^"
+      def resize_to_fill(magick, width, height, gravity: "Center", **options)
+        thumbnail(magick, "#{width}x#{height}^", **options)
         magick.gravity gravity
         magick.background "rgba(255,255,255,0.0)" # transparent
         magick.extent "#{width}x#{height}"
       end
 
-      def resize_and_pad(magick, width, height, background: :transparent, gravity: "Center")
+      def resize_and_pad(magick, width, height, background: :transparent, gravity: "Center", **options)
         background = "rgba(255,255,255,0.0)" if background.to_s == "transparent"
 
-        magick.resize "#{width}x#{height}"
+        thumbnail(magick, "#{width}x#{height}", **options)
         magick.background background
         magick.gravity gravity
         magick.extent "#{width}x#{height}"
@@ -46,22 +43,20 @@ module ImageProcessing
 
       def limits(magick, options)
         limit_args = options.flat_map { |type, value| %W[-limit #{type} #{value}] }
-        magick.args.replace limit_args + magick.args
-        magick
+        prepend_args(magick, limit_args)
       end
 
       def append(magick, *args)
         magick.merge! args
       end
 
-      def load_image(path_or_magick, page: nil, geometry: nil, fail: true, auto_orient: true, define: {}, **options)
+      def load_image(path_or_magick, page: nil, geometry: nil, auto_orient: true, **options)
         if path_or_magick.is_a?(::MiniMagick::Tool)
           magick = path_or_magick
         else
           source_path = path_or_magick
           magick = ::MiniMagick::Tool::Convert.new
 
-          apply_define(magick, define)
           apply_options(magick, options)
 
           input_path  = source_path
@@ -71,14 +66,11 @@ module ImageProcessing
           magick << input_path
         end
 
-        magick.regard_warnings if fail
         magick.auto_orient if auto_orient
-
         magick
       end
 
-      def save_image(magick, destination_path, define: {}, **options)
-        apply_define(magick, define)
+      def save_image(magick, destination_path, **options)
         apply_options(magick, options)
 
         magick << destination_path
@@ -88,6 +80,31 @@ module ImageProcessing
 
       private
 
+      def thumbnail(magick, geometry, sharpen: {})
+        magick.resize(geometry)
+        magick.sharpen(sharpen_value(sharpen)) if sharpen
+        magick
+      end
+
+      def sharpen_value(parameters)
+        parameters    = SHARPEN_PARAMETERS.merge(parameters)
+        radius, sigma = parameters.values_at(:radius, :sigma)
+
+        "#{radius}x#{sigma}"
+      end
+
+      def apply_options(magick, define: {}, **options)
+        options.each do |option, value|
+          case value
+          when true, nil then magick.send(option)
+          when false     then magick.send(option).+
+          else                magick.send(option, *value)
+          end
+        end
+
+        apply_define(magick, define)
+      end
+
       def apply_define(magick, define)
         define.each do |namespace, options|
           namespace = namespace.to_s.gsub("_", "-")
@@ -100,19 +117,12 @@ module ImageProcessing
         end
       end
 
-      def apply_options(magick, options)
-        options.each do |option, value|
-          case value
-          when true  then magick.send(option)
-          when false then magick.send(option).+
-          else            magick.send(option, *value)
-          end
-        end
+      def prepend_args(magick, args)
+        magick.args.replace args + magick.args
+        magick
       end
     end
 
     extend Chainable
-
-    include DeprecatedApi
   end
 end

data/lib/image_processing/processor.rb

@@ -13,7 +13,7 @@ module ImageProcessing
     end
 
     def custom(image, block)
-      block.call(image) || image
+      (block && block.call(image)) || image
     end
 
     private

data/lib/image_processing/version.rb

@@ -1,3 +1,3 @@
 module ImageProcessing
-  VERSION = "0.11.2"
+  VERSION = "1.0.0"
 end

data/lib/image_processing/vips.rb

@@ -1,6 +1,4 @@
-gem "ruby-vips", "~> 2.0"
 require "vips"
-
 require "image_processing"
 
 fail "image_processing/vips requires libvips 8.6+" unless Vips.at_least_libvips?(8, 6)
@@ -8,17 +6,18 @@ fail "image_processing/vips requires libvips 8.6+" unless Vips.at_least_libvips?
 module ImageProcessing
   module Vips
     def self.valid_image?(file)
-      ::Vips::Image.new_from_file(file.path, access: :sequential, fail: true).avg
+      ::Vips::Image.new_from_file(file.path, access: :sequential).avg
       true
     rescue ::Vips::Error
       false
     end
 
     class Processor < ImageProcessing::Processor
-      IMAGE_CLASS = ::Vips::Image
-      # libvips has this arbitrary number as a sanity-check upper bound on image
-      # size.
-      MAX_COORD = 10_000_000
+      IMAGE_CLASS  = ::Vips::Image
+      # default sharpening mask that provides a fast and mild sharpen
+      SHARPEN_MASK = ::Vips::Image.new_from_array [[-1, -1, -1],
+                                                   [-1, 32, -1],
+                                                   [-1, -1, -1]], 24
 
       def apply_operation(name, image, *args)
         result = super
@@ -27,23 +26,23 @@ module ImageProcessing
 
       def resize_to_limit(image, width, height, **options)
         width, height = default_dimensions(width, height)
-        image.thumbnail_image(width, height: height, size: :down, **options)
+        generate_thumbnail(image, width, height, size: :down, **options)
       end
 
       def resize_to_fit(image, width, height, **options)
         width, height = default_dimensions(width, height)
-        image.thumbnail_image(width, height: height, **options)
+        generate_thumbnail(image, width, height, **options)
       end
 
       def resize_to_fill(image, width, height, **options)
-        image.thumbnail_image(width, height: height, crop: :centre, **options)
+        generate_thumbnail(image, width, height, crop: :centre, **options)
       end
 
       def resize_and_pad(image, width, height, gravity: "centre", extend: nil, background: nil, alpha: nil, **options)
         embed_options = { extend: extend, background: background }
         embed_options.reject! { |name, value| value.nil? }
 
-        image = image.thumbnail_image(width, height: height, **options)
+        image = generate_thumbnail(image, width, height, **options)
         image = add_alpha(image) if alpha && !has_alpha?(image)
         image.gravity(gravity, width, height, **embed_options)
       end
@@ -55,14 +54,15 @@ module ImageProcessing
           source_path = path_or_image
           options     = select_valid_loader_options(source_path, options)
 
-          image = ::Vips::Image.new_from_file(source_path, fail: true, **options)
+          image = ::Vips::Image.new_from_file(source_path, **options)
         end
 
-        image = image.autorot if autorot
+        image = image.autorot if autorot && !options.key?(:autorotate)
         image
       end
 
-      def save_image(image, destination_path, **options)
+      def save_image(image, destination_path, quality: nil, **options)
+        options = options.merge(Q: quality) if quality
         options = select_valid_saver_options(destination_path, options)
 
         image.write_to_file(destination_path, **options)
@@ -70,6 +70,12 @@ module ImageProcessing
 
       private
 
+      def generate_thumbnail(image, width, height, sharpen: SHARPEN_MASK, **options)
+        image = image.thumbnail_image(width, height: height, **options)
+        image = image.conv(sharpen) if sharpen
+        image
+      end
+
       # Port of libvips' vips_addalpha().
       def add_alpha(image)
         max_alpha = (image.interpretation == :grey16 || image.interpretation == :rgb16) ? 65535 : 255
@@ -86,7 +92,7 @@ module ImageProcessing
       def default_dimensions(width, height)
         raise Error, "either width or height must be specified" unless width || height
 
-        [width || MAX_COORD, height || MAX_COORD]
+        [width || ::Vips::MAX_COORD, height || ::Vips::MAX_COORD]
       end
 
       def select_valid_loader_options(source_path, options)

metadata

@@ -1,99 +1,105 @@
 --- !ruby/object:Gem::Specification
 name: image_processing
 version: !ruby/object:Gem::Version
-  version: 0.11.2
+  version: 1.0.0
 platform: ruby
 authors:
 - Janko Marohnić
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-03-30 00:00:00.000000000 Z
+date: 2018-04-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: mini_magick
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
+        version: '4.0'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '4.0'
 - !ruby/object:Gem::Dependency
-  name: minitest
+  name: ruby-vips
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.8'
-  type: :development
+        version: 2.0.10
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '5.8'
+        version: 2.0.10
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3'
 - !ruby/object:Gem::Dependency
-  name: minitest-hooks
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.4.2
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.4.2
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: minispec-metadata
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '5.8'
 - !ruby/object:Gem::Dependency
-  name: mini_magick
+  name: minitest-hooks
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.3.5
+        version: 1.4.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 4.3.5
+        version: 1.4.2
 - !ruby/object:Gem::Dependency
-  name: ruby-vips
+  name: minispec-metadata
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: phashion
   requirement: !ruby/object:Gem::Requirement
@@ -123,7 +129,6 @@ files:
 - lib/image_processing/builder.rb
 - lib/image_processing/chainable.rb
 - lib/image_processing/mini_magick.rb
-- lib/image_processing/mini_magick/deprecated_api.rb
 - lib/image_processing/pipeline.rb
 - lib/image_processing/processor.rb
 - lib/image_processing/version.rb

data/lib/image_processing/mini_magick/deprecated_api.rb

@@ -1,120 +0,0 @@
-require "tempfile"
-require "fileutils"
-
-module ImageProcessing
-  module MiniMagick
-    module DeprecatedApi
-      def self.included(base)
-        base.extend(self)
-      end
-
-      def self.deprecated_processing_method(name, &body)
-        define_method(name) do |*args, &block|
-          return ImageProcessing::MiniMagick.send(name, *args, &block) if self != ImageProcessing::MiniMagick
-          return super(*args, &block) unless args.first.respond_to?(:read)
-
-          warn "[IMAGE_PROCESSING DEPRECATION WARNING] This API is deprecated and will be removed in ImageProcessing 1.0. Please use the new chainable API."
-
-          file = args.shift
-
-          if file.respond_to?(:path)
-            instance_exec(file, *args, block, &body)
-          else
-            Utils.copy_to_tempfile(file) do |tempfile|
-              instance_exec(tempfile, *args, block, &body)
-            end
-          end
-        end
-
-        define_method("#{name}!") do |*args, &block|
-          return ImageProcessing::MiniMagick.send("#{name}!", *args, &block) if self != ImageProcessing::MiniMagick
-          return super(*args, &block) unless args.first.respond_to?(:read)
-
-          processed = send(name, *args, &block)
-          source    = args.first
-
-          if name == :convert
-            File.delete(source.path)
-          else
-            processed.close
-            FileUtils.mv processed.path, source.path
-            source.open if source.is_a?(Tempfile)
-          end
-
-          source
-        end
-      end
-
-      deprecated_processing_method :resize_to_limit do |file, *args, block|
-        source(file)
-          .custom(&block)
-          .resize_to_limit!(*args)
-      end
-
-      deprecated_processing_method :resize_to_fit do |file, *args, block|
-        source(file)
-          .custom(&block)
-          .resize_to_fit!(*args)
-      end
-
-      deprecated_processing_method :resize_to_fill do |file, *args, block|
-        source(file)
-          .custom(&block)
-          .resize_to_fill!(*args)
-      end
-
-      deprecated_processing_method :resize_and_pad do |file, *args, block|
-        source(file)
-          .custom(&block)
-          .resize_and_pad!(*args)
-      end
-
-      deprecated_processing_method :convert do |file, format, page = nil, block|
-        source(file)
-          .loader(page: page)
-          .custom(&block)
-          .convert!(format)
-      end
-
-      deprecated_processing_method :auto_orient do |file, *args, block|
-        source(file)
-          .custom(&block)
-          .auto_orient!(*args)
-      end
-
-      deprecated_processing_method :resample do |file, width, height, block|
-        source(file)
-          .custom(&block)
-          .resample!("#{width}x#{height}")
-      end
-
-      deprecated_processing_method :crop do |file, width, height, x_offset = 0, y_offset = 0, block|
-        source(file)
-          .custom(&block)
-          .crop!("#{width}x#{height}+#{x_offset}+#{y_offset}")
-      end
-
-      deprecated_processing_method :corrupted? do |file, block|
-        valid_image?(file)
-      end
-
-      module Utils
-        module_function
-
-        def copy_to_tempfile(io)
-          extension = File.extname(io.path) if io.respond_to?(:path)
-          tempfile  = Tempfile.new(["image_processing", extension.to_s], binmode: true)
-
-          IO.copy_stream(io, tempfile)
-
-          io.rewind
-          tempfile.open # refresh content
-
-          yield tempfile
-        ensure
-          tempfile.close! if tempfile
-        end
-      end
-    end
-  end
-end