presto 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9124e378a7b3b0f59475c54788e8824253fcbf9e
+  data.tar.gz: dda68438585b0fb4a1c55d2195b72725de6f2ba3
+SHA512:
+  metadata.gz: 9f6f23a0791b28f5c8f0fe962d76abbd81d5ce8b5467c8c79002d3fc7f0871d8c15b46113867caca7b43561a0735c651992c8a17ab8bd647e150de4c0bd3d816
+  data.tar.gz: e120f3060c2a3a97f2652d2e9d5097ffde3ac0b9dd7d071c9ccc7f3edb6673b437b042317c0691caef221d9eb492c60b9441e14a9b4301673655d00df42acda4

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+spec/processed_images
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in presto.gemspec
+gemspec

data/Guardfile

@@ -0,0 +1,9 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :minitest, :all_on_start => false do
+	# with Minitest::Spec
+	watch(%r{^spec/(.*)_spec\.rb})
+	watch(%r{^lib/(.+)\.rb})         { |m| "spec/lib/#{m[1]}_spec.rb" }
+	watch(%r{^spec/spec_helper\.rb}) { 'spec' }
+end

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Erik Lott
+
+MIT License
+
+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/README.md

@@ -0,0 +1,67 @@
+# Presto
+
+Presto allows you to quickly manipulate images in Ruby with minimal
+effort. It is currently a wrapper for the MiniMagick DSL.
+
+Tested on the following Rubies: MRI 2.0.0.
+
+## Installation
+
+Add the gem to your Gemfile:
+
+    gem 'presto'
+
+
+Since Presto is a wrapper for the [MiniMagick](https://github.com/minimagick/minimagick) gem, it will also need to be included in your gemfile.
+
+## Usage
+
+Require the Presto mini_magick extension after mini_magick:
+
+    require 'mini_magick'
+    require 'presto/mini_magick'
+    
+Open and manipulate images using MiniMagick and the new **presto** method
+
+    image = MiniMagick::Image.open("input.jpg")
+    image.presto(w:500, h:200, fit:'crop', q:75, fm:'jpg', bg:'e2e2e2')
+    image.write "output.jpg"
+    
+## Api
+
+### w, h
+The width and height in pixels of the output image.
+
+If only one dimension is specified, the other dimension will be calculated according to the aspect ratio of the input image.
+
+### fit
+Controls how the image is transformed to reach the target dimensions. Possible values are:
+
+ - **clip** (default): Resize the image to fit within the target dimensions while maintaining the aspect ratio.
+ - **crop**: Resize the image to fill the target dimensions, and crop, removing any portion of the image laying outside of the target dimensions.
+ - **fill**: Resize the image to fit within the target dimensions, and fill the remaining whitespace with the assigned background color.
+ - **scale**: Scale the image to the target dimensions, and disregard the image's aspect ratio.
+ - **max**: Resize the image to fit within the target dimensions, if it is larger. This option will not resize an image if it is already equal to or less than the target dimensions.
+ 
+### bg (background)
+Assigns the background color to use when excess space or transparency is encountered. The hexidecimal color can be assigned in any of the following formats:
+
+ - **3-Value RGB**: F00 (red)
+ - **6-Value RRGGBB**: 00FF00 (green)
+ - **8-Value RRGGBBAA**: FFFFFF00 (transparent white)
+ 
+ 
+### fm (format) 
+Sets the format of the output image. Valid values are **jpg** or **png**.
+
+### q (quality) 
+A numeric value between 1 (worst) and 100 (best) representing the quality of the output image. Only applies to jpg format images.
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/presto/configuration.rb

@@ -0,0 +1,14 @@
+module Presto
+	class Configuration
+
+		attr_accessor :max_width, :min_width, :max_height, :min_height, :extension_white_list
+
+		def initialize
+			self.max_width = 2000
+			self.min_width = 1
+			self.max_height = 2000
+			self.min_height = 1
+			self.extension_white_list = %w(jpg png)
+		end
+	end
+end

data/lib/presto/dimensions.rb

@@ -0,0 +1,23 @@
+module Presto
+	class Dimensions < Struct.new(:width, :height)
+		def self.resize from_w, from_h, to_w=nil, to_h=nil
+			if to_w && to_h
+				w = to_w
+				h = to_h
+			elsif to_w
+				w = to_w
+				scale_x = to_w / from_w.to_f
+				h = (scale_x * from_h).round
+			elsif to_h
+				h = to_h
+				scale_y = to_h / from_h.to_f
+				w = (scale_y * from_w).round
+			else
+				w = from_w
+				h = from_h
+			end
+			
+			new(w, h)
+		end
+	end
+end

data/lib/presto/errors.rb

@@ -0,0 +1,48 @@
+module Presto
+	class Errors < ::Hash
+		ATTRIBUTE_JOINER = ' and '.freeze
+
+		# Adds an error for the given attribute.
+		#
+		#   errors.add(:name, 'is not valid') if name == 'invalid'
+		def add(att, msg)
+			fetch(att){self[att] = []} << msg
+		end
+
+		# Return the total number of error messages.
+		#
+		#   errors.count # => 3
+		def count
+			values.inject(0){|m, v| m + v.length}
+		end
+
+		# Return true if there are no error messages, false otherwise.
+		def empty?
+			count == 0
+		end
+
+		# Returns an array of fully-formatted error messages.
+		#
+		#   errors.full_messages
+		#   # => ['name is not valid',
+		#   #     'hometown is not at least 2 letters']
+		def full_messages
+			inject([]) do |m, kv| 
+				att, errors = *kv
+				errors.each {|e| m << "#{att} #{e}"}
+				m
+			end
+		end
+
+		# Returns the array of errors for the given attribute, or nil
+		# if there are no errors for the attribute.
+		#
+		#   errors.on(:name) # => ['name is not valid']
+		#   errors.on(:id) # => nil
+		def on(att)
+			if v = fetch(att, nil) and !v.empty?
+				v
+			end
+		end
+	end
+end

data/lib/presto/exceptions.rb

@@ -0,0 +1,4 @@
+module Presto
+	class PrestoError < StandardError; end
+	class InvalidTransformation < PrestoError; end
+end

data/lib/presto/mini_magick.rb

@@ -0,0 +1,93 @@
+require 'mini_magick'
+require 'presto/transformation'
+require 'presto/dimensions'
+
+module Presto
+	module MiniMagick
+		class Processor
+			def self.process image, params={}
+				new(params).process(image)
+			end
+			
+			attr_reader :params
+
+			def initialize params={}
+				@params = ::Presto::Transformation.new(params).tap{ |t| t.validate! }
+			end
+
+			def process image
+				process_fit(image) if params[:w] || params[:h]
+				process_format(image) if params[:fm]
+				process_quality(image) if params[:q]
+				image
+			end
+
+			private
+
+			def process_fit image
+				send("process_#{params[:fit]}_fit", image)
+			end
+
+			def process_crop_fit image
+				d = replaced_dimensions(image)
+				image.combine_options do |cmd|
+					cmd.resize "#{d.width}x#{d.height}^"
+					cmd.background params[:bg]
+					cmd.gravity 'Center'
+					cmd.extent "#{d.width}x#{d.height}"
+				end
+			end
+
+			def process_clip_fit image
+				d = resized_dimensions(image)
+				image.resize "#{d.width}x#{d.height}"
+			end
+
+			def process_scale_fit image
+				d = replaced_dimensions(image)
+				image.resize "#{d.width}x#{d.height}!"
+			end
+
+			def process_max_fit image
+				d = replaced_dimensions(image)
+				image.resize "#{d.width}x#{d.height}>"
+			end
+
+			def process_fill_fit image
+				d = replaced_dimensions(image)
+				image.combine_options do |cmd|
+					cmd.resize "#{d.width}x#{d.height}"
+					cmd.background params[:bg]
+					cmd.gravity 'Center'
+					cmd.extent "#{d.width}x#{d.height}"
+				end
+			end
+
+			def process_format image
+				image.format params[:fm]
+			end
+
+			def process_quality image
+				image.quality params[:q]
+			end
+
+			def resized_dimensions image
+				::Presto::Dimensions.resize(image[:width], image[:height], params[:w], params[:h])
+			end
+
+			def replaced_dimensions image
+				w = params[:w] || image[:width]
+				h = params[:h] || image[:height]
+				::Presto::Dimensions.new w, h
+			end
+		end
+
+		module Extension
+			def presto params={}
+				::Presto::MiniMagick::Processor.new(params).process(self)
+			end
+		end
+	end
+end
+
+::MiniMagick::Image.send(:include, ::Presto::MiniMagick::Extension)

data/lib/presto/transformation/validator.rb

@@ -0,0 +1,133 @@
+require 'presto'
+require 'presto/exceptions'
+require 'presto/errors'
+
+module Presto
+	class Transformation
+		class Validator
+			HEXDECIMAL_ALPHA_REGEX = /^#[a-fA-F0-9]{8}$/
+			HEXDECIMAL_LONG_REGEX = /^#[a-fA-F0-9]{6}$/
+			HEXDECIMAL_SHORT_REGEX = /^#[a-fA-F0-9]{3}$/
+
+			FIT_TYPES = %w(clip crop scale fill max).freeze
+			QUALITY_MAX = 100
+			QUALITY_MIN = 1
+
+			attr_reader :record, :errors
+
+			def initialize record
+				@record = record
+			end
+
+			def valid?
+				validate
+				errors.empty?
+			end
+
+			def validate!
+				raise(::Presto::InvalidTransformation, errors.full_messages.join(", ")) unless valid?
+				true
+			end
+
+			private
+
+			def validate
+				@errors = Errors.new
+				validate_width_max_size! unless record.w.nil?
+				validate_width_min_size! unless record.w.nil?
+				validate_height_max_size! unless record.h.nil?
+				validate_height_min_size! unless record.h.nil?
+				validate_fit_presence!
+				validate_fit_inclusion!
+				validate_bg_format! unless record.bg.nil?
+				validate_format_inclusion! unless record.fm.nil?
+				validate_quality_max_size! unless record.q.nil?
+				validate_quality_min_size! unless record.q.nil?
+			end
+
+			def validate_width_max_size!
+				if record.w > max_width
+					errors.add(:w, "must be equal to or less than #{max_width}")
+				end
+			end
+
+			def validate_width_min_size!
+				if record.w < min_width
+					errors.add(:w, "must be equal to or greater than #{min_width}")
+				end
+			end
+
+			def validate_height_max_size!
+				if record.h > max_height
+					errors.add(:h, "must be equal to or less than #{max_height}")
+				end
+			end
+
+			def validate_height_min_size!
+				if record.h < min_height
+					errors.add(:h, "must be equal to or greater than #{min_height}")
+				end
+			end
+		
+			def validate_fit_presence!
+				if record.fit.nil? || record.fit.empty?
+					errors.add(:fit, "can't be blank")
+				end
+			end
+
+			def validate_fit_inclusion!
+				unless FIT_TYPES.include?(record.fit)
+					errors.add(:fit, "is not valid")
+				end
+			end
+
+			def validate_bg_format!
+				unless record.bg =~ HEXDECIMAL_LONG_REGEX || record.bg =~ HEXDECIMAL_SHORT_REGEX || record.bg =~ HEXDECIMAL_ALPHA_REGEX 
+					errors.add(:bg, "is not valid")
+				end
+			end
+
+			def validate_format_inclusion!
+				unless extension_white_list.include?(record.fm)
+					errors.add(:fm, "is not valid")
+				end
+			end
+
+			def validate_quality_max_size!
+				if record.q > QUALITY_MAX
+					errors.add(:q, "must be equal to or less than #{QUALITY_MAX}")
+				end
+			end
+
+			def validate_quality_min_size!
+				if record.q < QUALITY_MIN
+					errors.add(:q, "must be equal to or greater than #{QUALITY_MIN}")
+				end
+			end
+
+			def min_width
+				config.min_width
+			end
+
+			def max_width
+				config.max_width
+			end
+
+			def min_height
+				config.min_height
+			end
+
+			def max_height
+				config.max_height
+			end
+
+			def extension_white_list
+				config.extension_white_list
+			end
+
+			def config
+				Presto.configuration
+			end
+		end
+	end
+end

data/lib/presto/transformation.rb

@@ -0,0 +1,33 @@
+require 'presto/transformation/validator'
+
+module Presto
+	class Transformation
+		extend Forwardable
+
+		def_delegators :validator, :validate!, :valid?
+
+		attr_reader :w, :h, :fit, :fm, :bg, :q
+
+		def initialize args={}
+			defaults = {:fit => 'clip', :bg => 'ffffff00'}
+			params = defaults.merge(args)
+
+			@bg = "##{params[:bg]}" if params.key?(:bg)
+			@fit = params[:fit]
+			@fm = params[:fm]
+			@h = params[:h].to_i if params.key?(:h)
+			@w = params[:w].to_i if params.key?(:w)
+			@q = params[:q].to_i if params.key?(:q)
+		end
+
+		def [] val
+			send(val)
+		end
+
+		private
+
+		def validator
+			::Presto::Transformation::Validator.new(self)
+		end
+	end
+end

data/lib/presto/version.rb

@@ -0,0 +1,3 @@
+module Presto
+  VERSION = "0.0.1"
+end

data/lib/presto.rb

@@ -0,0 +1,17 @@
+
+require 'presto/version'
+require 'presto/configuration'
+
+module Presto
+	class << self
+		attr_writer :configuration
+
+		def configure
+			yield(configuration)
+		end
+
+		def configuration
+			@configuration ||= ::Presto::Configuration.new
+		end
+	end
+end

data/presto.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'presto/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "presto"
+  spec.version       = Presto::VERSION
+  spec.authors       = ["Erik Lott"]
+  spec.email         = ["erik.lott@kodio.io"]
+  spec.description   = %q{Process images with one simple command}
+  spec.summary       = %q{Perform image transformations with one simple command}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "guard-minitest", "~> 1.0.1"
+  spec.add_development_dependency "mocha", "~> 0.14.0"
+  spec.add_development_dependency "mini_magick", "~> 3.6.0"
+end

data/spec/configuration_spec.rb

@@ -0,0 +1,26 @@
+require 'spec_helper'
+require 'presto/configuration'
+
+describe Presto::Configuration do
+	let(:configuration) { Presto::Configuration.new }
+
+	it "sets max_width default of 2000" do
+		configuration.max_width.must_equal 2000
+	end
+
+	it "sets min_width default of 1" do
+		configuration.min_width.must_equal 1
+	end
+
+	it "sets max_height default of 2000" do
+		configuration.max_height.must_equal 2000
+	end
+
+	it "sets min_height default of 1" do
+		configuration.min_height.must_equal 1
+	end
+
+	it "sets extension_white_list default of 1" do
+		configuration.extension_white_list.must_equal %w(jpg png)
+	end
+end

data/spec/dimensions_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+require 'presto/dimensions'
+
+describe Presto::Dimensions do
+	describe "::resize" do
+		describe "when target width and height assigned" do
+			it "returns target width and height" do
+				d = ::Presto::Dimensions.resize(123, 234, 345, 456)
+				d.width.must_equal 345
+				d.height.must_equal 456
+			end
+		end
+
+		describe "when only target width assigned" do
+			it "returns target width with proportional height" do
+				d = ::Presto::Dimensions.resize(100, 250, 300, nil)
+				d.width.must_equal 300
+				d.height.must_equal 750
+			end
+		end
+
+		describe "when only target height assigned" do
+			it "returns target height with proportional width" do
+				d = ::Presto::Dimensions.resize(100, 250, nil, 500)
+				d.width.must_equal 200
+				d.height.must_equal 500
+			end
+		end
+
+		describe "when target width and height not assigned" do			
+			it "return original width and height" do
+				d = ::Presto::Dimensions.resize(123, 234)
+				d.width.must_equal 123
+				d.height.must_equal 234
+			end
+		end
+	end
+end

data/spec/mini_magick/extension_spec.rb

@@ -0,0 +1,12 @@
+require 'spec_helper'
+require 'presto/mini_magick'
+
+describe Presto::MiniMagick::Extension do
+	it "extends MiniMagick with extension" do
+		klass = Class.new
+		klass.send(:include, Presto::MiniMagick::Extension)
+
+		inst = klass.new
+		inst.respond_to?(:presto).must_equal true
+	end
+end

data/spec/mini_magick/processor_spec.rb

@@ -0,0 +1,207 @@
+require 'spec_helper'
+require 'presto/mini_magick'
+
+describe Presto::MiniMagick::Processor do
+	let(:file) { ::File.open(File.expand_path('../../fixtures/images/test.gif', __FILE__)) }
+	let(:image) { ::MiniMagick::Image.open(file.path) }
+
+	describe "#initalize" do
+		describe "when params are not valid" do
+			it "raises error" do
+				e = proc{ Presto::MiniMagick::Processor.new(:fm => 'xml') }.must_raise(::Presto::InvalidTransformation)
+				e.message.must_equal 'fm is not valid'
+			end
+		end
+	end
+
+	describe "#process_crop_fit" do
+		describe "w and h assigned" do
+			it "resizes image to fill dimensions, and crops overlap" do
+				processor = Presto::MiniMagick::Processor.new(:w => 50, :h => 100)
+				processor.send(:process_crop_fit, image)
+				image[:width].must_equal 50
+				image[:height].must_equal 100
+
+				image.write File.expand_path("../../processed_images/process_crop_fit-w_and_h", __FILE__)
+			end
+		end
+	end
+
+	describe "#process_clip_fit" do
+		describe "w and h assigned" do
+			it "resizes image to fit within dimensions" do
+				processor = Presto::MiniMagick::Processor.new(:w => 50, :h => 50)
+				processor.send(:process_clip_fit, image)
+				image[:width].must_equal 50
+				image[:height].must_equal 20
+
+				image.write File.expand_path("../../processed_images/process_clip_fit-w_and_h", __FILE__)
+			end
+		end
+
+		describe "w assigned" do
+			it "resizes image to match width" do
+				processor = Presto::MiniMagick::Processor.new(:w => 100)
+				processor.send(:process_clip_fit, image)
+				image[:width].must_equal 100
+				image[:height].must_equal 40
+
+				image.write File.expand_path("../../processed_images/process_clip_fit-w", __FILE__)
+			end
+		end
+
+		describe "h assigned" do
+			it "resizes image to match height" do
+				processor = Presto::MiniMagick::Processor.new(:h => 100)
+				processor.send(:process_clip_fit, image)
+				image[:width].must_equal 250
+				image[:height].must_equal 100
+
+				image.write File.expand_path("../../processed_images/process_clip_fit-h", __FILE__)
+			end
+		end
+
+		describe "w and h unassigned" do
+			it "does nothing" do
+				processor = Presto::MiniMagick::Processor.new
+				processor.send(:process_clip_fit, image)
+				image[:width].must_equal 500
+				image[:height].must_equal 200
+
+				image.write File.expand_path("../../processed_images/process_clip_fit-no_dimensions", __FILE__)
+			end
+		end
+	end
+
+	describe "#process_scale_fit" do
+		describe "w and h assigned" do
+			it "scales image to match dimensions" do
+				processor = Presto::MiniMagick::Processor.new(:w => 50, :h => 100)
+				processor.send(:process_scale_fit, image)
+				image[:width].must_equal 50
+				image[:height].must_equal 100
+
+				image.write File.expand_path("../../processed_images/process_scale_fit-w_and_h", __FILE__)	
+			end
+		end
+
+		describe "w assigned" do
+			it "scales image to match width" do
+				processor = Presto::MiniMagick::Processor.new(:w => 50)
+				processor.send(:process_scale_fit, image)
+				image[:width].must_equal 50
+				image[:height].must_equal 200
+
+				image.write File.expand_path("../../processed_images/process_scale_fit-w", __FILE__)
+			end
+		end
+
+		describe "h assigned" do
+			it "scales image to match height" do
+				processor = Presto::MiniMagick::Processor.new(:h => 50)
+				processor.send(:process_scale_fit, image)
+				image[:width].must_equal 500
+				image[:height].must_equal 50
+
+				image.write File.expand_path("../../processed_images/process_scale_fit-h", __FILE__)
+			end
+		end
+	end
+
+	describe "#process_max_fit" do
+		describe "w and h assigned" do
+			it "resizes large image to fit within dimensions" do
+				processor = Presto::MiniMagick::Processor.new(:w => 250, :h => 500)
+				processor.send(:process_max_fit, image)
+				image[:width].must_equal 250
+				image[:height].must_equal 100
+
+				image.write File.expand_path("../../processed_images/process_max_fit-w_and_h_1", __FILE__)
+			end
+
+			it "does not resize if smaller than dimensions" do
+				processor = Presto::MiniMagick::Processor.new(:w => 1000, :h => 1200)
+				processor.send(:process_max_fit, image)
+				image[:width].must_equal 500
+				image[:height].must_equal 200
+
+				image.write File.expand_path("../../processed_images/process_max_fit-w_and_h_2", __FILE__)
+			end
+		end
+
+		describe "w assigned" do
+			it "resizes wide image to fit within width" do
+				processor = Presto::MiniMagick::Processor.new(:w => 250)
+				processor.send(:process_max_fit, image)
+				image[:width].must_equal 250
+				image[:height].must_equal 100
+
+				image.write File.expand_path("../../processed_images/process_max_fit-w_1", __FILE__)
+			end
+
+			it "does not adjust image if less wide than width" do
+				processor = Presto::MiniMagick::Processor.new(:w => 600)
+				processor.send(:process_max_fit, image)
+				image[:width].must_equal 500
+				image[:height].must_equal 200
+
+				image.write File.expand_path("../../processed_images/process_max_fit-w_2", __FILE__)
+			end
+		end
+
+		describe "h assigned" do
+			it "reduces tall image to fit within height" do
+				processor = Presto::MiniMagick::Processor.new(:h => 50)
+				processor.send(:process_max_fit, image)
+				image[:width].must_equal 125
+				image[:height].must_equal 50
+
+				image.write File.expand_path("../../processed_images/process_max_fit-h_1", __FILE__)
+			end
+
+			it "does not adjust image if less wide than width" do
+				processor = Presto::MiniMagick::Processor.new(:h => 300)
+				processor.send(:process_max_fit, image)
+				image[:width].must_equal 500
+				image[:height].must_equal 200
+
+				image.write File.expand_path("../../processed_images/process_max_fit-h_2", __FILE__)
+			end
+		end
+	end
+
+	describe "#process_fill_fit" do
+		describe "w and h assigned" do
+			it "resizes image to fit within dimensions, applies background to dimension" do
+				processor = Presto::MiniMagick::Processor.new(:w => 400, :h => 400, :bg => 'F00')
+				processor.send(:process_fill_fit, image)
+				image[:width].must_equal 400
+				image[:height].must_equal 400
+
+				image.write File.expand_path("../../processed_images/process_fill_fit-w_h", __FILE__)
+			end
+		end
+	end
+
+	describe "#process_format" do
+		it "sets image format" do
+			processor = Presto::MiniMagick::Processor.new(:fm => 'png')
+			processor.send(:process_format, image)
+			image[:format].must_equal 'PNG'
+		end
+	end
+
+	describe "#process_quality" do
+		it "sets image quality" do
+			img1 = ::MiniMagick::Image.open(file.path)
+			processor = Presto::MiniMagick::Processor.new(:q => 10, :fm => 'jpg', :w => 50)
+			processor.process img1
+			img1.write File.expand_path("../../processed_images/process_quality-10", __FILE__)
+
+			img2 = ::MiniMagick::Image.open(file.path)
+			processor = Presto::MiniMagick::Processor.new(:q => 100, :fm => 'jpg', :w => 50)
+			processor.process img2
+			img2.write File.expand_path("../../processed_images/process_quality-100", __FILE__)
+		end
+	end
+end

data/spec/presto_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+require 'presto'
+
+describe Presto do
+	describe "::configuration" do
+		it "returns configuration instance" do
+			Presto.configuration.must_be_instance_of Presto::Configuration
+		end
+
+		it "memoizes configuration instance" do
+			config_inst = Presto.configuration
+			config_inst_2 = Presto.configuration
+			config_inst.object_id.must_equal config_inst_2.object_id
+		end
+	end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+require 'minitest/autorun'
+require 'mocha/setup'

data/spec/transformation/validator_spec.rb

@@ -0,0 +1,135 @@
+require 'spec_helper'
+require 'presto/transformation/validator'
+
+describe Presto::Transformation::Validator do
+	let(:w) { 100 }
+	let(:h) { 200 }
+	let(:fit) { 'clip' }
+	let(:bg) { '#fffddd' }
+	let(:fm){ 'jpg' }
+	let(:q){ 92 }
+	let(:transformation) { stub(:w => w, :h => h, :fit => fit, :bg => bg, :fm => fm, :q => q) }
+	let(:validator){ Presto::Transformation::Validator.new(transformation) }
+
+	describe "#validate!" do
+		describe "when valid" do
+			it "returns true" do
+				validator.validate!.must_equal true
+			end
+		end
+
+		describe "when w is nil" do
+			let(:w) { nil }
+
+			it "does not raise error" do
+				validator.validate!.must_equal true
+			end
+		end
+
+		describe "when w is greater than max w" do
+			let(:w) { Presto.configuration.max_width + 1 }
+
+			it "raises error" do
+				e = proc { validator.validate! }.must_raise(Presto::InvalidTransformation)
+				e.message.must_match "w must be equal to or less than"
+			end
+		end
+
+		describe "when w is less than min w" do
+			let(:w) { Presto.configuration.min_width - 1 }
+
+			it "raises error" do
+				e = proc { validator.validate! }.must_raise(Presto::InvalidTransformation)
+				e.message.must_match "w must be equal to or greater than"
+			end
+		end
+
+		describe "when h is nil" do
+			let(:h) { nil }
+
+			it "does not raise error" do
+				validator.validate!.must_equal true
+			end
+		end
+
+		describe "when h is greater than max h" do
+			let(:h) { Presto.configuration.max_height + 1 }
+
+			it "raises error" do
+				e = proc { validator.validate! }.must_raise(Presto::InvalidTransformation)
+				e.message.must_match "h must be equal to or less than"
+			end
+		end
+
+		describe "when h is less than min h" do
+			let(:h) { Presto.configuration.min_height - 1 }
+
+			it "raises error" do
+				e = proc { validator.validate! }.must_raise(Presto::InvalidTransformation)
+				e.message.must_match "h must be equal to or greater than"
+			end
+		end
+
+		describe "when fit is nil" do
+			let(:fit) { nil }
+
+			it "raises error" do
+				e = proc { validator.validate! }.must_raise(Presto::InvalidTransformation)
+				e.message.must_match "fit can't be blank"
+			end
+		end
+
+		describe "when fit is invalid" do
+			let(:fit) { 'blah' }
+
+			it "raises error" do
+				e = proc { validator.validate! }.must_raise(Presto::InvalidTransformation)
+				e.message.must_match "fit is not valid"
+			end
+		end
+
+		describe "when bg is wrong formal" do
+			let(:bg) { 'fhff' }
+
+			it "raises error" do
+				e = proc { validator.validate! }.must_raise(Presto::InvalidTransformation)
+				e.message.must_match "bg is not valid"
+			end
+		end
+
+		describe "when fm is invalid" do
+			let(:fm) { 'tif' }
+
+			it "raises error" do
+				e = proc { validator.validate! }.must_raise(Presto::InvalidTransformation)
+				e.message.must_match "fm is not valid"
+			end
+		end
+
+		describe "when q is nil" do
+			let(:q) { nil }
+
+			it "does not raise error" do
+				validator.validate!.must_equal true
+			end
+		end
+
+		describe "when q is greater than max q" do
+			let(:q) { ::Presto::Transformation::Validator::QUALITY_MAX + 1 }
+
+			it "raises error" do
+				e = proc { validator.validate! }.must_raise(Presto::InvalidTransformation)
+				e.message.must_match "q must be equal to or less than #{::Presto::Transformation::Validator::QUALITY_MAX}"
+			end
+		end
+
+		describe "when q is less than min q" do
+			let(:q) { ::Presto::Transformation::Validator::QUALITY_MIN - 1 }
+
+			it "raises error" do
+				e = proc { validator.validate! }.must_raise(Presto::InvalidTransformation)
+				e.message.must_match "q must be equal to or greater than #{::Presto::Transformation::Validator::QUALITY_MIN}"
+			end
+		end
+	end
+end

data/spec/transformation_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+require 'presto/transformation'
+
+describe Presto::Transformation do
+	it "sets default fit" do
+		Presto::Transformation.new.fit.must_equal 'clip'
+	end
+
+	it "sets default bg" do
+		Presto::Transformation.new.bg.must_equal '#ffffff00'
+	end
+
+	it "coerses w to integer" do
+		Presto::Transformation.new(:w => '123').w.must_equal 123
+	end
+
+	it "coerses h to integer" do
+		Presto::Transformation.new(:h => '123').h.must_equal 123
+	end
+
+	it "coerses bg to hexdec format" do
+		Presto::Transformation.new(:bg => 'eee').bg.must_equal '#eee'
+	end
+
+	it "coerses q to integer" do
+		Presto::Transformation.new(:q => '50').q.must_equal 50
+	end
+
+	it "can access method via hash syntax" do
+		trans = Presto::Transformation.new(:h => 123)
+		trans[:h].must_equal 123
+		trans['h'].must_equal 123
+	end
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification
+name: presto
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Erik Lott
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: guard-minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.1
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+- !ruby/object:Gem::Dependency
+  name: mini_magick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.6.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 3.6.0
+description: Process images with one simple command
+email:
+- erik.lott@kodio.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/presto.rb
+- lib/presto/configuration.rb
+- lib/presto/dimensions.rb
+- lib/presto/errors.rb
+- lib/presto/exceptions.rb
+- lib/presto/mini_magick.rb
+- lib/presto/transformation.rb
+- lib/presto/transformation/validator.rb
+- lib/presto/version.rb
+- presto.gemspec
+- spec/configuration_spec.rb
+- spec/dimensions_spec.rb
+- spec/fixtures/images/test.gif
+- spec/mini_magick/extension_spec.rb
+- spec/mini_magick/processor_spec.rb
+- spec/presto_spec.rb
+- spec/spec_helper.rb
+- spec/transformation/validator_spec.rb
+- spec/transformation_spec.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.7
+signing_key: 
+specification_version: 4
+summary: Perform image transformations with one simple command
+test_files:
+- spec/configuration_spec.rb
+- spec/dimensions_spec.rb
+- spec/fixtures/images/test.gif
+- spec/mini_magick/extension_spec.rb
+- spec/mini_magick/processor_spec.rb
+- spec/presto_spec.rb
+- spec/spec_helper.rb
+- spec/transformation/validator_spec.rb
+- spec/transformation_spec.rb