ruby-thumbor 3.0.0 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3aea89d8e9ceb84d32afce82d907f37e9a36387f599cd99947955259142c2149
-  data.tar.gz: 724e15742e517340b63889d356d6195d6c6244e8835dffb86eb5ad7d873bba61
+  metadata.gz: 7f47258a05c0f11cbb6204f06e463613a467ea0dcadfddd971330de2d58202ed
+  data.tar.gz: c510bda2d4a88fdadb96ff5d6e8051070bc80834b0b1c838a1091596f7a4db14
 SHA512:
-  metadata.gz: e17c2247defe2aa6674d7b6f9ffe299207fed86acffc180c926c3d21d6a2d81bd33faddfcf2290d4fe39bcc6473836d25eb3e2045dd1b383ccb0a6810243780c
-  data.tar.gz: e76fe2e009b22c96f82d6ea2834a02faec7af7d5ebfbe4416c990020f3e23f880aa36a0060e89b46f3708453d6f9e6eafdcd937ae019be92bde6ccb7c015ff41
+  metadata.gz: 3b886a1f96d8a9703c24e338a7e469686a05283098bc7bdc9dc9460fd753a233d0afd78df66c3b9e6f5ad344b8d5f87ef113d1d0299c81ade419910d7ca7da36
+  data.tar.gz: 1a1603bc5c9851b4faec33c45852890152d497c01be0c9465c41aa9a0cc3d7b3f17d0aaf156bf4592ecf85b75a30a2d1f839c5600065cb5d96484ef31b636a0f

data/README.md

@@ -0,0 +1,83 @@
+# ruby-thumbor [![Github Actions](https://github.com/thumbor/ruby-thumbor/actions/workflows/main.yml/badge.svg)](https://github.com/thumbor/ruby-thumbor/actions) [![Gem Version](https://badge.fury.io/rb/ruby-thumbor.svg)](https://rubygems.org/gems/ruby-thumbor) [![Coverage Status](https://coveralls.io/repos/thumbor/ruby-thumbor/badge.svg?branch=master&service=github)](https://coveralls.io/github/thumbor/ruby-thumbor?branch=master)
+
+ruby-thumbor is the Ruby client to the thumbor imaging service (http://github.com/thumbor/thumbor).
+
+## Features
+* Generate thumbor encrypted URLs
+* Obtain metadata from image operations in thumbor
+
+## Install
+``` bash
+gem install ruby-thumbor
+```
+
+## Using it
+``` ruby
+require 'ruby-thumbor'
+
+image = Thumbor::Cascade.new('my-security-key', 'remote-image.com/path/to/image.jpg')
+image.width(300).height(200).watermark_filter('http://remote-image.com/path/to/image.jpg', 30).generate
+
+# url will contain something like:
+# /2913921in321n3k2nj32hjhj3h22/remote-image.com/path/to/image.jpg
+
+# Now you just need to concatenate this generated path, with your thumbor server url
+```
+
+### or
+``` ruby
+require 'ruby-thumbor'
+
+crypto = Thumbor::CryptoURL.new 'my-security-key'
+
+url = crypto.generate(width: 200, height: 300, image: 'remote-image.com/path/to/image.jpg')
+```
+
+## Available Thumbor arguments
+``` ruby
+meta: bool # flag that indicates that thumbor should return only meta-data on the operations it would otherwise perform;
+
+crop: [<int>, <int>, <int>, <int>] # Coordinates for manual cropping. The first item is the two arguments are the coordinates for the left, top point and the last two are the coordinates for the right, bottom point (thus forming the square to crop);
+
+width: <int> # the width for the thumbnail;
+
+height: <int> # the height for the thumbnail;
+
+flip: <bool> # flag that indicates that thumbor should flip horizontally (on the vertical axis) the image;
+
+flop: <bool> # flag that indicates that thumbor should flip vertically (on the horizontal axis) the image;
+
+halign: :left, :center or :right # horizontal alignment that thumbor should use for cropping;
+
+valign: :top, :middle or :bottom # horizontal alignment that thumbor should use for cropping;
+
+smart: <bool> # flag that indicates that thumbor should use smart cropping;
+
+filters: ['blur(20)', 'watermark(http://my.site.com/img.png,-10,-10,50)'] # array of filters and their arguments
+```
+
+If you need more info on what each option does, check thumbor's documentation at https://thumbor.readthedocs.io/en/latest/index.html.
+
+## License
+(The MIT License)
+
+Copyright (c) 2022 Bernardo Heynemann <heynemann@gmail.com>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/ruby-thumbor.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'thumbor/crypto_url'
 require 'thumbor/cascade'
 

data/lib/thumbor/cascade.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'forwardable'
 require 'openssl'
 require 'base64'
@@ -8,14 +10,17 @@ module Thumbor
   class Cascade
     attr_accessor :image, :crypto, :options, :filters
 
-    @available_options = [
-      :meta, :crop, :center,
-      :original_width, :original_height,
-      :width, :height, :flip,
-      :flop, :halign, :valign,
-      :smart, :fit_in, :adaptive_fit_in,
-      :full_fit_in, :adaptive_full_fit_in,
-      :trim, :debug]
+    FILTER_REGEX = Regexp.new('^(.+)_filter$')
+
+    @available_options = %i[
+      meta crop center
+      original_width original_height
+      width height flip
+      flop halign valign
+      smart fit_in adaptive_fit_in
+      full_fit_in adaptive_full_fit_in
+      trim debug
+    ]
 
     extend Forwardable
 
@@ -29,7 +34,7 @@ module Thumbor
       end
     end
 
-    def initialize(key=false, image=nil)
+    def initialize(key = nil, image = nil)
       @key = key
       @image = image
       @options = {}
@@ -38,36 +43,39 @@ module Thumbor
     end
 
     def generate
-      @crypto.generate prepare_options(@options).merge({image: @image, filters: @filters})
+      @crypto.generate prepare_options(@options).merge({ image: @image, filters: @filters })
     end
 
-    def method_missing(m, *args)
-      if /^(.+)_filter$/.match(m.to_s)
-        @filters << "#{$1}(#{escape_args(args).join(',')})"
+    def method_missing(method, *args)
+      if method =~ FILTER_REGEX
+        @filters << "#{FILTER_REGEX.match(method)[1]}(#{escape_args(args).join(',')})"
         self
       else
         super
       end
     end
 
+    def respond_to_missing?(method, include_private = false)
+      method =~ FILTER_REGEX || super
+    end
+
     private
 
     def escape_args(args)
       args.map do |arg|
-        arg = CGI::escape(arg) if arg.is_a? String and arg.match(/^https?:\/\//)
+        arg = CGI.escape(arg) if arg.is_a?(String) && arg.match(%r{^https?://})
         arg
       end
     end
 
     def prepare_options(options)
-      options.reduce({}) do |final_options, item|
+      options.each_with_object({}) do |item, final_options|
         value = if item[1].length == 1
-          item[1].first
-        else
-          item[1]
-        end
+                  item[1].first
+                else
+                  item[1]
+                end
         final_options[item[0]] = value
-        final_options
       end
     end
   end

data/lib/thumbor/crypto_url.rb

@@ -1,216 +1,192 @@
+# frozen_string_literal: true
+
 require 'openssl'
 require 'base64'
 require 'digest/md5'
 require 'cgi'
 
 module Thumbor
-    class CryptoURL
-        attr_writer :computed_key
-
-        def initialize(key=false)
-            @key = key
-        end
+  class CryptoURL
+    def initialize(key = nil)
+      @key = key
+    end
 
-        def computed_key
-            (@key * 16)[0..15]
-        end
+    def calculate_width_and_height(url_parts, options)
+      width = options[:width]
+      height = options[:height]
+
+      width *= -1 if width && options[:flip]
+      height *= -1 if height && options[:flop]
+
+      if width || height
+        width ||= 0
+        height ||= 0
+      end
+
+      has_width = width
+      has_height = height
+      if options[:flip] && !has_width && !has_height
+        width = '-0'
+        height = '0' if !has_height && !(options[:flop])
+      end
+      if options[:flop] && !has_width && !has_height
+        height = '-0'
+        width = '0' if !has_width && !(options[:flip])
+      end
+
+      url_parts.push("#{width}x#{height}") if width || height
+    end
 
-        def calculate_width_and_height(url_parts, options)
-            width = options[:width]
-            height = options[:height]
-
-            if width and options[:flip]
-                width = width * -1
-            end
-            if height and options[:flop]
-                height = height * -1
-            end
-
-            if width or height
-                width = 0 if not width
-                height = 0 if not height
-            end
-
-            has_width = width
-            has_height = height
-            if options[:flip] and not has_width and not has_height
-                width = "-0"
-                height = '0' if not has_height and not options[:flop]
-            end
-            if options[:flop] and not has_width and not has_height
-                height = "-0"
-                width = '0' if not has_width and not options[:flip]
-            end
-
-            url_parts.push("#{width}x#{height}") if width || height
+    def calculate_centered_crop(options)
+      width = options[:width]
+      height = options[:height]
+      original_width = options[:original_width]
+      original_height = options[:original_height]
+      center = options[:center]
+
+      return unless original_width &&
+                    original_height &&
+                    center &&
+                    (width || height)
+
+      raise 'center must be an array of x,y' unless center.is_a?(Array) && center.length == 2
+
+      center_x, center_y = center
+      width ||= original_width
+      height ||= original_height
+      width = width.abs
+      height = height.abs
+      new_aspect_ratio = width / height.to_f
+      original_aspect_ratio = original_width / original_height.to_f
+
+      crop = nil
+      # We're going wider, vertical crop
+      if new_aspect_ratio > original_aspect_ratio
+        # How tall should we be? because new_aspect_ratio is > original_aspect_ratio we can be sure
+        # that cropped_height is always less than original_height (original). This is assumed below.
+        cropped_height = (original_width / new_aspect_ratio).round
+        # Calculate coordinates around center
+        top_crop_point = (center_y - (cropped_height * 0.5)).round
+        bottom_crop_point = (center_y + (cropped_height * 0.5)).round
+
+        # If we've gone above the top of the image, take all from the bottom
+        if top_crop_point.negative?
+          top_crop_point = 0
+          bottom_crop_point = cropped_height
+        # If we've gone below the top of the image, take all from the top
+        elsif bottom_crop_point > original_height
+          top_crop_point = original_height - cropped_height
+          bottom_crop_point = original_height
+          # Because cropped_height < original_height, top_crop_point and
+          # bottom_crop_point will never both be out of bounds
         end
 
-        def calculate_centered_crop(options)
-            width = options[:width]
-            height = options[:height]
-            original_width = options[:original_width]
-            original_height = options[:original_height]
-            center = options[:center]
-
-            return unless original_width &&
-                            original_height &&
-                            center &&
-                            (width || height)
-
-            unless center.kind_of?(Array) && center.length == 2
-                raise 'center must be an array of x,y'
-            end
-
-            center_x, center_y = center
-            width ||= original_width
-            height ||= original_height
-            width = width.abs
-            height = height.abs
-            new_aspect_ratio = width / height.to_f
-            original_aspect_ratio = original_width/original_height.to_f
-
-            crop = nil
-            # We're going wider, vertical crop
-            if new_aspect_ratio > original_aspect_ratio
-              # How tall should we be? because new_aspect_ratio is > original_aspect_ratio we can be sure
-              # that cropped_height is always less than original_height (original). This is assumed below.
-              cropped_height = (original_width / new_aspect_ratio).round
-              # Calculate coordinates around center
-              top_crop_point = (center_y - (cropped_height * 0.5)).round
-              bottom_crop_point = (center_y + (cropped_height * 0.5)).round
-
-              # If we've gone above the top of the image, take all from the bottom
-              if top_crop_point < 0
-                top_crop_point = 0
-                bottom_crop_point = cropped_height
-              # If we've gone below the top of the image, take all from the top
-              elsif bottom_crop_point > original_height
-                top_crop_point = original_height - cropped_height
-                bottom_crop_point = original_height
-              # Because cropped_height < original_height, top_crop_point and
-              # bottom_crop_point will never both be out of bounds
-              end
-
-              # Put it together
-              crop = [0, top_crop_point, original_width, bottom_crop_point]
-            # We're going taller, horizontal crop
-            elsif new_aspect_ratio < original_aspect_ratio
-              # How wide should we be? because new_aspect_ratio is < original_aspect_ratio we can be sure
-              # that cropped_width is always less than original_width (original). This is assumed below.
-              cropped_width = (original_height * new_aspect_ratio).round
-              # Calculate coordinates around center
-              left_crop_point = (center_x - (cropped_width * 0.5)).round
-              right_crop_point = (center_x + (cropped_width * 0.5)).round
-
-              # If we've gone beyond the left of the image, take all from the right
-              if left_crop_point < 0
-                left_crop_point = 0
-                right_crop_point = cropped_width
-              # If we've gone beyond the right of the image, take all from the left
-              elsif right_crop_point > original_width
-                left_crop_point = original_width - cropped_width
-                right_crop_point = original_width
-              # Because cropped_width < original_width, left_crop_point and
-              # right_crop_point will never both be out of bounds
-              end
-
-              # Put it together
-              crop = [left_crop_point, 0, right_crop_point, original_height]
-            end
-
-            options[:crop] = crop
+        # Put it together
+        crop = [0, top_crop_point, original_width, bottom_crop_point]
+      # We're going taller, horizontal crop
+      elsif new_aspect_ratio < original_aspect_ratio
+        # How wide should we be? because new_aspect_ratio is < original_aspect_ratio we can be sure
+        # that cropped_width is always less than original_width (original). This is assumed below.
+        cropped_width = (original_height * new_aspect_ratio).round
+        # Calculate coordinates around center
+        left_crop_point = (center_x - (cropped_width * 0.5)).round
+        right_crop_point = (center_x + (cropped_width * 0.5)).round
+
+        # If we've gone beyond the left of the image, take all from the right
+        if left_crop_point.negative?
+          left_crop_point = 0
+          right_crop_point = cropped_width
+        # If we've gone beyond the right of the image, take all from the left
+        elsif right_crop_point > original_width
+          left_crop_point = original_width - cropped_width
+          right_crop_point = original_width
+          # Because cropped_width < original_width, left_crop_point and
+          # right_crop_point will never both be out of bounds
         end
 
-        def url_for(options)
-            if not options[:image]
-                raise 'image is a required argument.'
-            end
+        # Put it together
+        crop = [left_crop_point, 0, right_crop_point, original_height]
+      end
 
-            url_parts = Array.new
+      options[:crop] = crop
+    end
 
-            if options[:debug]
-                url_parts.push('debug')
-            end
+    def url_for(options)
+      raise 'image is a required argument.' unless options[:image]
 
-            if options[:trim]
-                trim_options  = ['trim']
-                trim_options << options[:trim] unless options[:trim] == true or options[:trim][0] == true
-                url_parts.push(trim_options.join(':'))
-            end
+      url_parts = []
 
-            if options[:meta]
-                url_parts.push('meta')
-            end
+      url_parts.push('debug') if options[:debug]
 
-            calculate_centered_crop(options)
+      if options[:trim]
+        trim_options = ['trim']
+        trim_options << options[:trim] unless (options[:trim] == true) || (options[:trim][0] == true)
+        url_parts.push(trim_options.join(':'))
+      end
 
-            crop = options[:crop]
-            if crop
-                crop_left = crop[0]
-                crop_top = crop[1]
-                crop_right = crop[2]
-                crop_bottom = crop[3]
+      url_parts.push('meta') if options[:meta]
 
-                if crop_left > 0 or crop_top > 0 or crop_bottom > 0 or crop_right > 0
-                    url_parts.push(crop_left.to_s << 'x' << crop_top.to_s << ':' << crop_right.to_s << 'x' << crop_bottom.to_s)
-                end
-            end
+      calculate_centered_crop(options)
 
-            [:fit_in, :adaptive_fit_in, :full_fit_in, :adaptive_full_fit_in].each do |fit|
-                if options[fit]
-                    url_parts.push(fit.to_s.gsub('_','-'))
-                end
-            end
+      crop = options[:crop]
+      if crop
+        crop_left = crop[0]
+        crop_top = crop[1]
+        crop_right = crop[2]
+        crop_bottom = crop[3]
 
-            if options.include?(:fit_in) or options.include?(:full_fit_in) and not (options.include?(:width) or options.include?(:height))
-                raise ArgumentError, 'When using fit-in or full-fit-in, you must specify width and/or height.'
-            end
+        if crop_left.positive? || crop_top.positive? || crop_bottom.positive? || crop_right.positive?
+          url_parts.push(crop_left.to_s << 'x' << crop_top.to_s << ':' << crop_right.to_s << 'x' << crop_bottom.to_s)
+        end
+      end
 
-            calculate_width_and_height(url_parts, options)
+      %i[fit_in adaptive_fit_in full_fit_in adaptive_full_fit_in].each do |fit|
+        url_parts.push(fit.to_s.gsub('_', '-')) if options[fit]
+      end
 
-            if options[:halign] and options[:halign] != :center
-                url_parts.push(options[:halign])
-            end
+      if (options.include?(:fit_in) || options.include?(:full_fit_in)) && !(options.include?(:width) || options.include?(:height))
+        raise ArgumentError, 'When using fit-in or full-fit-in, you must specify width and/or height.'
+      end
 
-            if options[:valign] and options[:valign] != :middle
-                url_parts.push(options[:valign])
-            end
+      calculate_width_and_height(url_parts, options)
 
-            if options[:smart]
-                url_parts.push('smart')
-            end
+      url_parts.push(options[:halign]) if options[:halign] && (options[:halign] != :center)
 
-            if options[:filters] && !options[:filters].empty?
-              filter_parts = []
-              options[:filters].each do |filter|
-                filter_parts.push(filter)
-              end
+      url_parts.push(options[:valign]) if options[:valign] && (options[:valign] != :middle)
 
-              url_parts.push("filters:#{ filter_parts.join(':') }")
-            end
+      url_parts.push('smart') if options[:smart]
 
-            return url_parts.join('/')
+      if options[:filters] && !options[:filters].empty?
+        filter_parts = []
+        options[:filters].each do |filter|
+          filter_parts.push(filter)
         end
 
-        def url_safe_base64(str)
-            Base64.encode64(str).gsub('+', '-').gsub('/', '_').gsub!(/[\n]/, '')
-        end
+        url_parts.push("filters:#{filter_parts.join(':')}")
+      end
 
-        def generate(options)
-            thumbor_path = ""
+      url_parts.join('/')
+    end
 
-            image_options = url_for(options)
-            thumbor_path << image_options + '/' unless image_options.empty?
+    def url_safe_base64(str)
+      Base64.encode64(str).gsub('+', '-').gsub('/', '_').gsub!(/\n/, '')
+    end
 
-            thumbor_path << options[:image]
+    def generate(options)
+      thumbor_path = []
 
-            if @key
-                signature = url_safe_base64(OpenSSL::HMAC.digest('sha1', @key, thumbor_path))
-                thumbor_path.insert(0, "/#{signature}/")
-            else
-                thumbor_path.insert(0, "/unsafe/")
-            end
-            thumbor_path
-        end
+      image_options = url_for(options)
+      thumbor_path << "#{image_options}/" unless image_options.empty?
+
+      thumbor_path << options[:image]
+
+      if @key.nil?
+        thumbor_path.insert(0, '/unsafe/')
+      else
+        signature = url_safe_base64(OpenSSL::HMAC.digest('sha1', @key, thumbor_path.join))
+        thumbor_path.insert(0, "/#{signature}/")
+      end
+      thumbor_path.join
     end
+  end
 end

data/lib/thumbor/version.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Thumbor
-  VERSION = '3.0.0'
+  VERSION = '4.0.0'
 end

data/spec/spec_helper.rb

@@ -1,17 +1,29 @@
+# frozen_string_literal: true
+
 require 'simplecov'
-begin
-  require 'coveralls'
-rescue LoadError
-  puts 'Running on Jruby'
+require 'simplecov-lcov'
+
+SimpleCov::Formatter::LcovFormatter.config do |config|
+  config.report_with_single_file = true
+  config.single_report_path = 'coverage/lcov.info'
 end
 
-Coveralls.wear! if defined? Coveralls
+SimpleCov.formatters = SimpleCov::Formatter::MultiFormatter.new(
+  [
+    SimpleCov::Formatter::HTMLFormatter,
+    SimpleCov::Formatter::LcovFormatter
+  ]
+)
 
 SimpleCov.start do
   add_filter '/spec/'
 end
 
+SimpleCov.at_exit do
+  SimpleCov.result.format!
+end
+
 RSpec.configure do |c|
-  c.filter_run :focus => true
+  c.filter_run focus: true
   c.run_all_when_everything_filtered = true
 end

data/spec/thumbor/cascade_spec.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'spec_helper'
 require 'json'
 require 'ruby-thumbor'
@@ -8,311 +10,309 @@ describe Thumbor::Cascade do
 
   subject { Thumbor::Cascade.new key, image_url }
 
-  describe '#new' do
-
-    it "should create a new instance passing key and keep it" do
-      expect(subject.computed_key).to eq 'my-security-keym'
-    end
+  it 'should raise an error' do
+    expect { subject.god_of_war_crop }.to raise_error(NoMethodError)
   end
 
-  it 'should raise an error' do
-    expect{ subject.god_of_war_crop }.to raise_error(NoMethodError)
+  it 'should respond to filter methods' do
+    expect(subject.respond_to?('quality_filter')).to be_truthy
   end
 
   describe '#generate' do
-
-    it "should create an unsafe url" do
-      url = Thumbor::Cascade.new(false, image_url).width(300).height(200).generate
+    it 'should create an unsafe url' do
+      url = Thumbor::Cascade.new(nil, image_url).width(300).height(200).generate
       expect(url).to eq '/unsafe/300x200/my.domain.com/some/image/url.jpg'
     end
 
-    it "should create an url with debug" do
+    it 'should create an url with debug' do
       url = subject.debug(true).height(200).generate
       expect(url).to eq '/5_eX4HHQYk81HQVkc1gBIAvPbLo=/debug/0x200/my.domain.com/some/image/url.jpg'
     end
 
-    it "should create a new instance passing key and keep it" do
+    it 'should create a new instance passing key and keep it' do
       url = subject.width(300).height(200).generate
       expect(url).to eq '/TQfyd3H36Z3srcNcLOYiM05YNO8=/300x200/my.domain.com/some/image/url.jpg'
     end
 
-    it "should be able to change the Thumbor key" do
+    it 'should be able to change the Thumbor key' do
       url1 = subject.width(300).height(200).generate
       url2 = Thumbor::Cascade.new('another-thumbor-key', image_url).width(300).height(200).generate
       expect(url1).not_to eq url2
     end
 
-    it "should create a new instance passing key and keep it" do
+    it 'should create a new instance passing key and keep it' do
       url = subject.width(300).height(200).meta(true).generate
       expect(url).to eq '/YBQEWd3g_WRMnVEG73zfzcr8Zj0=/meta/300x200/my.domain.com/some/image/url.jpg'
     end
 
-    it "should create a new instance passing key and keep it" do
+    it 'should create a new instance passing key and keep it' do
       url = subject.width(300).height(200).meta(true).smart(true).generate
       expect(url).to eq '/jP89J0qOWHgPlm_lOA28GtOh5GU=/meta/300x200/smart/my.domain.com/some/image/url.jpg'
     end
 
-    it "should create a new instance passing key and keep it" do
+    it 'should create a new instance passing key and keep it' do
       url = subject.width(300).height(200).meta(true).smart(true).fit_in(true).generate
       expect(url).to eq '/zrrOh_TtTs4kiLLEQq1w4bcTYdc=/meta/fit-in/300x200/smart/my.domain.com/some/image/url.jpg'
     end
 
-    it "should create a new instance passing key and keep it" do
+    it 'should create a new instance passing key and keep it' do
       url = subject.width(300).height(200).meta(true).smart(true).fit_in(true).flip(true).generate
       expect(url).to eq '/4t1XK1KH43cOb1QJ9tU00-W2_k8=/meta/fit-in/-300x200/smart/my.domain.com/some/image/url.jpg'
     end
 
-    it "should create a new instance passing key and keep it" do
+    it 'should create a new instance passing key and keep it' do
       url = subject.width(300).height(200).meta(true).smart(true).fit_in(true).flip(true).flop(true).generate
       expect(url).to eq '/HJnvjZU69PkPOhyZGu-Z3Uc_W_A=/meta/fit-in/-300x-200/smart/my.domain.com/some/image/url.jpg'
     end
 
-    it "should create a new instance passing key and keep it" do
+    it 'should create a new instance passing key and keep it' do
       url = subject.quality_filter(20).brightness_filter(10).generate
       expect(url).to eq '/q0DiFg-5-eFZIqyN3lRoCvg2K0s=/filters:quality(20):brightness(10)/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return just the image hash if no arguments passed" do
+    it 'should return just the image hash if no arguments passed' do
       url = subject.generate
       expect(url).to eq '/964rCTkAEDtvjy_a572k7kRa0SU=/my.domain.com/some/image/url.jpg'
     end
 
-    it "should raise if no image passed" do
+    it 'should raise if no image passed' do
       expect { Thumbor::Cascade.new.generate }.to raise_error(RuntimeError)
     end
 
-    it "should return proper url for width-only" do
+    it 'should return proper url for width-only' do
       url = subject.width(300).generate
       expect(url).to eq '/eFwrBWryxtRw9hDSbQPhi5iLpo8=/300x0/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper url for height-only" do
+    it 'should return proper url for height-only' do
       url = subject.height(300).generate
       expect(url).to eq '/-VGIgp7g8cMKcfF2gFK9ZpmB_5w=/0x300/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper url for width and height" do
+    it 'should return proper url for width and height' do
       url = subject.width(200).height(300).generate
       expect(url).to eq '/TrM0qqfcivb6VxS3Hxlxn43W21k=/200x300/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper smart url" do
+    it 'should return proper smart url' do
       url = subject.width(200).height(300).smart(true).generate
       expect(url).to eq '/hdzhxXzK45DzNTru5urV6x6xxSs=/200x300/smart/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper fit-in url" do
+    it 'should return proper fit-in url' do
       url = subject.width(200).height(300).fit_in(true).generate
       expect(url).to eq '/LOv6ArMOJA2VRpfMQjjs4xSyZpM=/fit-in/200x300/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper adaptive-fit-in url" do
+    it 'should return proper adaptive-fit-in url' do
       url = subject.width(200).height(300).adaptive_fit_in(true).generate
       expect(url).to eq '/V2xmSmQZm4i5-0Flx8iuRtawOkg=/adaptive-fit-in/200x300/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper full-fit-in url" do
+    it 'should return proper full-fit-in url' do
       url = subject.width(200).height(300).full_fit_in(true).generate
       expect(url).to eq '/geXhR7ZFxztQTsKzmkDxYCX-HHg=/full-fit-in/200x300/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper adaptive-full-fit-in url" do
+    it 'should return proper adaptive-full-fit-in url' do
       url = subject.width(200).height(300).adaptive_full_fit_in(true).generate
       expect(url).to eq '/jlUfjdC-6rG6jmuHgFp6eKgPy2g=/adaptive-full-fit-in/200x300/my.domain.com/some/image/url.jpg'
     end
 
-    [:fit_in, :full_fit_in].each do |fit|
+    %i[fit_in full_fit_in].each do |fit|
       it "should raise error when using #{fit} without width or height" do
         subject.send(fit, true)
-        expect{subject.generate}.to raise_error(ArgumentError)
+        expect { subject.generate }.to raise_error(ArgumentError)
       end
     end
 
-    it "should return proper flip url if no width and height" do
+    it 'should return proper flip url if no width and height' do
       url = subject.flip(true).generate
       expect(url).to eq '/rlI4clPR-p-PR2QAxj5ZWiTfvH4=/-0x0/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper flop url if no width and height" do
+    it 'should return proper flop url if no width and height' do
       url = subject.flop(true).generate
       expect(url).to eq '/-4dmGj-TwIEqTAL9_9yEqUM8cks=/0x-0/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper flip-flop url if no width and height" do
+    it 'should return proper flip-flop url if no width and height' do
       url = subject.flip(true).flop(true).generate
       expect(url).to eq '/FnMxpQMmxiMpdG219Dsj8pD_4Xc=/-0x-0/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper flip url if width" do
+    it 'should return proper flip url if width' do
       url = subject.width(300).flip(true).generate
       expect(url).to eq '/ccr2PoSYcTEGL4_Wzt4u3wWVRKU=/-300x0/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper flop url if height" do
+    it 'should return proper flop url if height' do
       url = subject.height(300).flop(true).generate
       expect(url).to eq '/R5K91tkyNgXO65F6E0txgA6C9lY=/0x-300/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return horizontal align" do
+    it 'should return horizontal align' do
       url = subject.halign(:left).generate
       expect(url).to eq '/GTJE3wUt3sURik0O9Nae8sfI928=/left/my.domain.com/some/image/url.jpg'
     end
 
-    it "should not return horizontal align if it is center" do
+    it 'should not return horizontal align if it is center' do
       url = subject.halign(:center).generate
       expect(url).to eq '/964rCTkAEDtvjy_a572k7kRa0SU=/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return vertical align" do
+    it 'should return vertical align' do
       url = subject.valign(:top).generate
       expect(url).to eq '/1QQo5ihObuhgwl95--Z3g78vjiE=/top/my.domain.com/some/image/url.jpg'
     end
 
-    it "should not return vertical align if it is middle" do
+    it 'should not return vertical align if it is middle' do
       url = subject.valign(:middle).generate
       expect(url).to eq '/964rCTkAEDtvjy_a572k7kRa0SU=/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return halign and valign properly" do
+    it 'should return halign and valign properly' do
       url = subject.halign(:left).valign(:top).generate
       expect(url).to eq '/yA2rmtWv_uzHd9klz5OuMIZ5auI=/left/top/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return meta properly" do
+    it 'should return meta properly' do
       url = subject.meta(true).generate
       expect(url).to eq '/WvIJFDJDePgIl5hZcLgtrzIPxfY=/meta/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper crop url when param is array" do
+    it 'should return proper crop url when param is array' do
       url = subject.crop([10, 20, 30, 40]).generate
       expect(url).to eq '/QcnhqNfHwiP6BHLbD6UvneX7K28=/10x20:30x40/my.domain.com/some/image/url.jpg'
     end
 
-    it "should return proper crop url" do
+    it 'should return proper crop url' do
       url = subject.crop(10, 20, 30, 40).generate
       expect(url).to eq '/QcnhqNfHwiP6BHLbD6UvneX7K28=/10x20:30x40/my.domain.com/some/image/url.jpg'
     end
 
-    it "should ignore crop if all zeros" do
+    it 'should ignore crop if all zeros' do
       url = subject.crop(0, 0, 0, 0).generate
       expect(url).to eq '/964rCTkAEDtvjy_a572k7kRa0SU=/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have smart after halign and valign" do
+    it 'should have smart after halign and valign' do
       url = subject.halign(:left).valign(:top).smart(true).generate
       expect(url).to eq '/KS6mVuzlGE3hJ75n3JUonfGgSFM=/left/top/smart/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have quality filter" do
+    it 'should have quality filter' do
       url = subject.quality_filter(20).generate
       expect(url).to eq '/NyA-is4NojxiRqo0NcmJDhB6GTs=/filters:quality(20)/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have brightness filter" do
+    it 'should have brightness filter' do
       url = subject.brightness_filter(30).generate
       expect(url).to eq '/oXDmnGD7vQV-rXcj8kCl1tcS3jc=/filters:brightness(30)/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have 2 filters" do
+    it 'should have 2 filters' do
       url = subject.brightness_filter(30).quality_filter(20).generate
       expect(url).to eq '/SW9o4xQG1QAzE69WzEzarL_G3MI=/filters:brightness(30):quality(20)/my.domain.com/some/image/url.jpg'
     end
 
-    it "should escape url args" do
+    it 'should escape url args' do
       url = subject.watermark_filter('http://my-server.com/image.png', 30).quality_filter(20).generate
       expect(url).to eq '/4b9kwg0-zsojf7Ed01TPKPYOel4=/filters:watermark(http%3A%2F%2Fmy-server.com%2Fimage.png,30):quality(20)/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have trim without params" do
+    it 'should have trim without params' do
       url = subject.trim.generate
       expect(url).to eq '/w23BC0dUiYBFrUnuoYJe8XROuyw=/trim/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have trim with direction param" do
+    it 'should have trim with direction param' do
       url = subject.trim('bottom-right').generate
       expect(url).to eq '/kXPwSmqEvPFQezgzBCv9BtPWmBY=/trim:bottom-right/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have trim with direction and tolerance param" do
+    it 'should have trim with direction and tolerance param' do
       url = subject.trim('bottom-right', 15).generate
       expect(url).to eq '/TUCEIhtWfI1Uv9zjavCSl_i0A_8=/trim:bottom-right:15/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have the right crop when cropping horizontally and given a left center" do
+    it 'should have the right crop when cropping horizontally and given a left center' do
       url = subject.original_width(100).original_height(100).width(40).height(50).center(0, 50).generate
       expect(url).to eq '/SZIT3w4Qgebv5DuVJ8G1IH1mkCU=/0x0:80x100/40x50/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have the right crop when cropping horizontally and given a right center" do
+    it 'should have the right crop when cropping horizontally and given a right center' do
       url = subject.original_width(100).original_height(100).width(40).height(50).center(100, 50).generate
       expect(url).to eq '/NEtCYehaISE7qR3zFj15CxnZoCs=/20x0:100x100/40x50/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have the right crop when cropping horizontally and given the actual center" do
+    it 'should have the right crop when cropping horizontally and given the actual center' do
       url = subject.original_width(100).original_height(100).width(40).height(50).center(50, 50).generate
       expect(url).to eq '/JLH65vJTu6d-cXBmqe5hYoSD4ho=/10x0:90x100/40x50/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have the right crop when cropping vertically and given a top center" do
+    it 'should have the right crop when cropping vertically and given a top center' do
       url = subject.original_width(100).original_height(100).width(50).height(40).center(50, 0).generate
       expect(url).to eq '/FIMZcLatW6bjgSRH9xTkEwUZAZ8=/0x0:100x80/50x40/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have the right crop when cropping vertically and given a bottom center" do
+    it 'should have the right crop when cropping vertically and given a bottom center' do
       url = subject.original_width(100).original_height(100).width(50).height(40).center(50, 100).generate
       expect(url).to eq '/9Ud0sVo6i9DLOjlKbQP_4JXgFmA=/0x20:100x100/50x40/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have the right crop when cropping vertically and given the actual center" do
+    it 'should have the right crop when cropping vertically and given the actual center' do
       url = subject.original_width(100).original_height(100).width(50).height(40).center(50, 50).generate
       expect(url).to eq '/WejLJn8djJLn7DkMUq3S0zZCvZE=/0x10:100x90/50x40/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have the no crop when not necessary" do
+    it 'should have the no crop when not necessary' do
       url = subject.original_width(100).original_height(100).width(50).height(50).center(50, 0).generate
       expect(url).to eq '/trIjfr513nkGkCpKXK6qgox2jPA=/50x50/my.domain.com/some/image/url.jpg'
     end
 
-    it "should blow up with a bad center" do
-      expect { subject.original_width(100).original_height(100).width(50).height(50).center(50).generate }.to raise_error(RuntimeError)
+    it 'should blow up with a bad center' do
+      expect do
+        subject.original_width(100).original_height(100).width(50).height(50).center(50).generate
+      end.to raise_error(RuntimeError)
     end
 
-    it "should have no crop with a missing original_height" do
+    it 'should have no crop with a missing original_height' do
       url = subject.original_width(100).width(50).height(40).center(50, 0).generate
       expect(url).to eq '/veYlY0msKmemAaXpeav2kCNftmU=/50x40/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have no crop with a missing original_width" do
+    it 'should have no crop with a missing original_width' do
       url = subject.original_height(100).width(50).height(40).center(50, 0).generate
       expect(url).to eq '/veYlY0msKmemAaXpeav2kCNftmU=/50x40/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have no crop with out a width and height" do
+    it 'should have no crop with out a width and height' do
       url = subject.original_width(100).original_height(100).center(50, 50).generate
       expect(url).to eq '/964rCTkAEDtvjy_a572k7kRa0SU=/my.domain.com/some/image/url.jpg'
     end
 
-    it "should use the original width with a missing width" do
+    it 'should use the original width with a missing width' do
       url = subject.original_width(100).original_height(100).height(80).center(50, 50).generate
       expect(url).to eq '/02BNIIJ9NYNV9Q03JHPtlP0DIDg=/0x10:100x90/0x80/my.domain.com/some/image/url.jpg'
     end
 
-    it "should use the original height with a missing height" do
+    it 'should use the original height with a missing height' do
       url = subject.original_width(100).original_height(100).width(80).center(50, 50).generate
       expect(url).to eq '/0XL5BmMi3vlJQfw6aGOVW-M1vVI=/10x0:90x100/80x0/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have the right crop with a negative width" do
+    it 'should have the right crop with a negative width' do
       url = subject.original_width(100).original_height(100).width(-50).height(40).center(50, 50).generate
       expect(url).to eq '/IuRNPlFlpTVol45bDkOm2PGvneo=/0x10:100x90/-50x40/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have the right crop with a negative height" do
+    it 'should have the right crop with a negative height' do
       url = subject.original_width(100).original_height(100).width(50).height(-40).center(50, 50).generate
       expect(url).to eq '/-8IhWGEeXaY1uv945i9EHLVjwuk=/0x10:100x90/50x-40/my.domain.com/some/image/url.jpg'
     end
 
-    it "should have the right crop with a negative height and width" do
+    it 'should have the right crop with a negative height and width' do
       url = subject.original_width(100).original_height(100).width(-50).height(-40).center(50, 50).generate
       expect(url).to eq '/lfjGLTTEaW_Rcvc1q0ZhfYup2jg=/0x10:100x90/-50x-40/my.domain.com/some/image/url.jpg'
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby-thumbor
 version: !ruby/object:Gem::Version
-  version: 3.0.0
+  version: 4.0.0
 platform: ruby
 authors:
 - Bernardo Heynemann
@@ -9,73 +9,88 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-01-29 00:00:00.000000000 Z
+date: 2022-01-28 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '3.10'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.8.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 2.8.0
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.21.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.21.2
 - !ruby/object:Gem::Dependency
-  name: rspec_junit_formatter
+  name: simplecov-lcov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.8.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 0.8.0
 description: ruby-thumbor is the client to the thumbor imaging service (http://github.com/thumbor/thumbor).
 email:
 - heynemann@gmail.com
-- guivideojob@gmail.com
+- guilherme@souza.tech
 executables: []
 extensions: []
-extra_rdoc_files: []
+extra_rdoc_files:
+- README.md
 files:
-- README.rdoc
+- README.md
 - lib/ruby-thumbor.rb
 - lib/thumbor/cascade.rb
 - lib/thumbor/crypto_url.rb
@@ -83,12 +98,22 @@ files:
 - spec/spec_helper.rb
 - spec/thumbor/cascade_spec.rb
 homepage: http://github.com/thumbor/ruby-thumbor
-licenses: []
-metadata: {}
+licenses:
+- MIT
+metadata:
+  bug_tracker_uri: https://github.com/thumbor/ruby-thumbor/issues
+  documentation_uri: https://www.rubydoc.info/gems/ruby-thumbor
+  homepage_uri: http://github.com/thumbor/ruby-thumbor
+  source_code_uri: https://github.com/thumbor/ruby-thumbor
 post_install_message: 
 rdoc_options:
+- "--title"
+- Ruby-Thumbor
 - "--main"
-- README.rdoc
+- README.md
+- "--line-numbers"
+- "--inline-source"
+- "--quiet"
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -102,8 +127,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.6
+rubygems_version: 3.3.3
 signing_key: 
 specification_version: 4
 summary: ruby-thumbor is the client to the thumbor imaging service (http://github.com/thumbor/thumbor).

data/README.rdoc

@@ -1,106 +0,0 @@
-= ruby-thumbor {<img src="https://secure.travis-ci.org/thumbor/ruby-thumbor.png?branch=master" alt="Build Status" />}[http://travis-ci.org/thumbor/ruby-thumbor] {<img src="https://badge.fury.io/rb/ruby-thumbor.svg" alt="Gem Version" />}[http://badge.fury.io/rb/ruby-thumbor] {<img src="https://coveralls.io/repos/thumbor/ruby-thumbor/badge.svg?branch=master&service=github" alt="Coverage Status" />}[https://coveralls.io/github/thumbor/ruby-thumbor?branch=master]
-
-
-* http://github.com/thumbor/ruby-thumbor
-
-== DESCRIPTION:
-
-ruby-thumbor is the client to the thumbor imaging service (http://github.com/thumbor/thumbor).
-
-== FEATURES:
-
-* Generate thumbor encrypted URLs
-* Obtain metadata from image operations in thumbor
-
-== DEPENDENCIES
-
-No dependencies required for regular usage.
-
-* thumbor (http://github.com/thumbor/thumbor) for running ruby-thumbor tests.
-
-== INSTALL:
-
-    gem install ruby-thumbor
-
-    gem 'ruby-thumbor'
-
-== BREAKING CHANGE ON 3.0:
-
-    Old image Url isn't supported anymore
-    Switch from #url_for to #generate method
-
-== USAGE:
-
-    require 'ruby-thumbor'
-
-    crypto = Thumbor::CryptoURL.new 'my-security-key'
-
-    url = crypto.generate :width => 200, :height => 300, :image => 'remote-image.com/path/to/image.jpg'
-
-    # url will contain something like:
-    # /2913921in321n3k2nj32hjhj3h22/remote-image.com/path/to/image.jpg
-
-    # Now you just need to concatenate this generated path, with your thumbor server url
-
-or
-
-    require 'ruby-thumbor'
-
-    image = Thumbor::Cascade.new('my-security-key', 'remote-image.com/path/to/image.jpg')
-    image.width(300).height(200).watermark_filter('http://remote-image.com/path/to/image.jpg', 30).generate
-
-Available arguments to the generate method:
-
-    :meta => bool - flag that indicates that thumbor should return only meta-data on the operations it would
-                    otherwise perform;
-
-    :crop => [<int>, <int>, <int>, <int>] - Coordinates for manual cropping. The first item is the two arguments are
-                                            the coordinates for the left, top point and the last two are the coordinates
-                                            for the right, bottom point (thus forming the square to crop);
-
-    :width => <int> - the width for the thumbnail;
-
-    :height => <int> - the height for the thumbnail;
-
-    :flip => <bool> - flag that indicates that thumbor should flip horizontally (on the vertical axis) the image;
-
-    :flop => <bool> - flag that indicates that thumbor should flip vertically (on the horizontal axis) the image;
-
-    :halign => :left, :center or :right - horizontal alignment that thumbor should use for cropping;
-
-    :valign => :top, :middle or :bottom - horizontal alignment that thumbor should use for cropping;
-
-    :smart => <bool> - flag that indicates that thumbor should use smart cropping;
-
-    :filters => ['blur(20)', 'watermark(http://my.site.com/img.png,-10,-10,50)'] - array of filters and their arguments
-
-If you need more info on what each option does, check thumbor's documentation at https://github.com/thumbor/thumbor/wiki.
-
-== CONTRIBUTIONS:
-
-* Hugo Lopes (hugobr) - Fixes in the usage readme part of the docs.
-
-== LICENSE:
-
-(The MIT License)
-
-Copyright (c) 2011 Bernardo Heynemann <heynemann@gmail.com>
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-'Software'), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.