anisoptera 0.0.2

data/.gitignore

@@ -0,0 +1,6 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+.DS_Store
+.rvmrc

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format documentation

data/Gemfile

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

data/README.md

@@ -0,0 +1,116 @@
+# Configurable Rack endpoint for Async image resizing.
+
+In progress.
+
+Borrows heavily from Dragonfly ([https://github.com/markevans/dragonfly](https://github.com/markevans/dragonfly)).
+
+Async mode relies on Thin's async.callback env variable and EventMachine, and ImageMagick for image processing.
+
+See [http_router](/ismasan/anisoptera/blob/master/examples/http_router.ru) example for an intro.
+
+## Usage
+
+You need a rack router of some sort.
+
+```ruby
+# image_resizer.ru
+
+require 'http_router'
+require 'anisoptera'
+
+Anisoptera[:media].configure do |config|
+  # This is where your original image files are
+  config.base_path = './'
+  # In case of error, resize and serve up this image
+  config.error_image = './Error.gif'
+  # Run this block in case of error
+  config.on_error do |exception, params|
+    Airbrake.notify(
+        :error_class   => exception.class.name,
+        :error_message => exception.message,
+        :parameters    => params
+      )
+  end
+end
+
+# Create an app with defined routes
+
+app = HttpRouter.new do
+
+  add('/media/:geometry/:color_mode/:filename').to Anisoptera[:media].endpoint {|image, params|
+    image.file(params[:filename]).thumb(params[:geometry])
+    image.greyscale if params[:color_mode] == 'grey'
+    image.encode('png')
+  }
+end
+
+# Run the app
+run app
+```
+  
+Run with Thin
+
+    $ thin start -R image_resizer.ru -e production -p 5000
+    
+Now you get on-the fly image resizes
+
+    http://some.host/media/100x100/grey/logo.png
+
+Anisoptera returns all the right HTTP headers so if you put this behind a caching proxy such as Varnish it should just work.
+
+## Custom headers
+
+You can pass optional headers, or override default ones
+
+```ruby
+Anisoptera[:media].configure do |config|
+  config.headers = {
+    'Cache-Control' => '1234567890',
+    'X-Custom'      => 'Hello there'
+  }
+end
+```
+
+## DoS protection
+
+Obviously it's a bad idea to allow people to freely resize images on the fly as it might bring your servers down. You can hash the parameters in the URL with a shared key and secret, something like:
+
+```ruby
+get('/media/:hash').to Anisoptera[:media].endpoint {|image, params|
+  verify_sha! params[:hash], params[:k]
+  
+  args = Anisoptera::Serializer.marshal_decode(params[:hash])
+  image_path = args[:file_name]
+  image.file(image_path).thumb(args[:geometry])
+  image.greyscale if args[:grey]
+  image.encode('jpg')
+}
+```
+
+Then you request images with passing a hash of parameters encoded with the shared secret, and a public key to decode it back.
+
+    http://some.host/media/BAh7CToGZiIVMjUzNjctaGVsbWV0LmpwZzoJZ3JleUY6DHNob3BfaWRpAeA6BmciDDIwMHgyMDA?k=6a58f9458425f73
+    
+Anisoptera::Serializer's encode and decode methods can help you Base64-encode a hash of parameters. This is also good because some ImageMagick geometry strings are not valid URL components.
+
+# LICENSE
+
+Copyright (C) 2011 Ismael Celis
+
+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/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new('spec')
+
+# If you want to make this the default task
+task :default => :spec

data/anisoptera.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "anisoptera/version"
+
+Gem::Specification.new do |s|
+  s.name        = "anisoptera"
+  s.version     = Anisoptera::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Ismael Celis"]
+  s.email       = ["ismaelct@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{Async Rack app for image thumbnailing}
+  s.description = %q{You'll need an Eventmachine server such as Thin to run this. See README.'}
+
+  s.rubyforge_project = "anisoptera"
+  
+  s.add_dependency 'eventmachine', ">= 0.12.10"
+  s.add_dependency 'thin'
+  s.add_dependency 'thin_async'
+  s.add_dependency 'rack', ">= 1.2.2"
+  
+  s.add_development_dependency "bundler", ">= 1.0.0"
+  s.add_development_dependency "rack-test"
+  s.add_development_dependency "rspec"
+  s.add_development_dependency "thin-async-test"
+  s.add_development_dependency "http_router"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/examples/http_router.ru

@@ -0,0 +1,36 @@
+# thin start -R http_router -p 3000
+#
+# http://localhost:3000/media/170x240+210+210/m/pic1.jpg
+# http://localhost:3000/media/170x240/m/pic1.jpg
+# http://localhost:3000/media/100x100-ne/m/pic1.jpg
+# http://localhost:3000/media/100x100-c/m/pic1.jpg
+# http://localhost:3000/media/100x100-c/greyscale/pic1.jpg
+
+require 'rubygems'
+# require 'bundler'
+# Bundler.setup
+
+require 'http_router'
+
+$:.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'anisoptera'
+
+Anisoptera[:media].configure do |config|
+  config.base_path = './'
+end
+
+# Anisoptera.prefer_async = false # uncomment this to test synchronous endpoint with any Rack server
+
+
+routes = HttpRouter.new do
+  
+  add('/media/:geometry/:color_mode/:filename').to Anisoptera[:media].endpoint {|image, params|
+    image.file(params[:filename]).thumb(params[:geometry])
+    image.greyscale if params[:color_mode] == 'grey'
+    image.encode('png')
+  }
+  
+end
+
+run routes

data/lib/anisoptera.rb

@@ -0,0 +1,32 @@
+require 'ostruct'
+require 'rack/mime'
+require 'anisoptera/commander'
+require 'anisoptera/serializer'
+require 'anisoptera/version'
+require 'anisoptera/app'
+require 'anisoptera/endpoint'
+
+module Anisoptera
+  
+  HEADERS = {
+    'Cache-Control'   => 'public, max-age=3153600'
+  }.freeze
+  
+  @apps = {}
+  @prefer_async = true
+  
+  def prefer_async=(bool)
+    @prefer_async = bool
+  end
+  
+  def prefer_async
+    !!@prefer_async
+  end
+  
+  def [](app_name)
+    @apps[app_name] ||= Anisoptera::App.new
+  end
+  
+  extend self
+  
+end

data/lib/anisoptera/app.rb

@@ -0,0 +1,29 @@
+module Anisoptera
+  
+  class Config < OpenStruct
+    
+    def on_error(&block)
+      @on_error = block if block_given?
+      @on_error
+    end
+    
+  end
+  
+  class App
+    
+    attr_reader :config
+    
+    def initialize
+      @config = Config.new
+    end
+
+    def configure(&block)
+      block.call @config
+    end
+
+    def endpoint(&block)
+      Anisoptera::Endpoint.factory(@config, block)
+    end
+
+  end
+end

data/lib/anisoptera/async_endpoint.rb

@@ -0,0 +1,73 @@
+require 'eventmachine'
+require 'thin/async'
+
+module Anisoptera
+
+  class AsyncEndpoint
+    
+    include Anisoptera::Endpoint
+    
+    # This is a template async response.
+    AsyncResponse = [-1, {}, []].freeze
+
+    STATUSES = {
+      0   => 200,
+      1   => 500,
+      255 => 200 # exit status represented differently when running tests in editor
+    }
+
+    def call(env)
+      response = Thin::AsyncResponse.new(env)
+      
+      params = routing_params(env)
+      
+      begin
+        job = Anisoptera::Commander.new( @config.base_path, @config.convert_command )
+        convert = @handler.call(job, params)
+        response.headers.update(update_headers(convert))
+        
+        if !job.check_file
+          response.headers['X-Error'] = 'Image not found'  
+          handle_error error_status(404), response, convert
+        else
+          handle_success response, convert
+        end
+      rescue => boom
+        response.headers['X-Error'] = boom.message
+        response.headers.update(update_headers)
+        @config.on_error.call(boom, params, env) if @config.on_error
+        handle_error(error_status(500), response)
+      end
+
+      response.finish
+    end
+    
+    protected
+    
+    def handle_success(response, convert)
+      EM.system( convert.command ){ |output, status| 
+        http_status = STATUSES[status.exitstatus]
+        response.status = http_status
+        r = http_status == 200 ? output : 'SERVER ERROR'
+        response << r
+        response.done
+      }
+    end
+    
+    def handle_error(status, response, convert = nil)
+      response.status = status
+      response.headers['Content-Type'] = Rack::Mime.mime_type(::File.extname(error_image))
+      if convert # pass error image through original IM command
+        EM.system( convert.command(error_image) ){ |output, status| 
+          response << output
+          response.done
+        }
+      else # just blocking read because user handler blew up
+        response << ::File.read(error_image)
+        response.done
+      end
+    end
+
+  end
+  
+end

data/lib/anisoptera/commander.rb

@@ -0,0 +1,148 @@
+module Anisoptera
+  
+  # Simple interface to ImageMagick main commands
+  # Most of it borrowed from DragonFly
+  # https://github.com/markevans/dragonfly/blob/master/lib/dragonfly/image_magick/processor.rb
+  #
+  class Commander
+    
+    GRAVITIES = {
+      'nw' => 'NorthWest',
+      'n'  => 'North',
+      'ne' => 'NorthEast',
+      'w'  => 'West',
+      'c'  => 'Center',
+      'e'  => 'East',
+      'sw' => 'SouthWest',
+      's'  => 'South',
+      'se' => 'SouthEast'
+    }
+    
+    # Geometry string patterns
+    RESIZE_GEOMETRY         = /^\d*x\d*[><%^!]?$|^\d+@$/ # e.g. '300x200!'
+    CROPPED_RESIZE_GEOMETRY = /^(\d+)x(\d+)[#|-](\w{1,2})?$/ # e.g. '20x50#ne'
+    CROP_GEOMETRY           = /^(\d+)x(\d+)([+-]\d+)?([+-]\d+)?(\w{1,2})?$/ # e.g. '30x30+10+10'
+    
+    def initialize(base_path, convert_command = nil)
+      @convert_command = convert_command || 'convert'
+      @base_path = base_path
+      @original = nil
+      @geometry = nil
+    end
+
+    def file(path)
+      @original = path
+      self
+    end
+    
+    def encode(format)
+      @encode = format
+      self
+    end
+    
+    def square(size)
+      size = size.to_i
+      d = size * 2
+      @square = "-thumbnail x#{d} -resize '#{d}x<' -resize 50% -gravity center -crop #{size}x#{size}+0+0"
+      self
+    end
+    
+    def greyscale
+      @greyscale = '-colorspace Gray'
+      self
+    end
+    
+    def thumb(geometry)
+      @geometry = case geometry
+      when RESIZE_GEOMETRY
+        resize(geometry)
+      when CROPPED_RESIZE_GEOMETRY
+        resize_and_crop(:width => $1, :height => $2, :gravity => $3)
+      when CROP_GEOMETRY
+        crop(
+          :width => $1,
+          :height => $2,
+          :x => $3,
+          :y => $4,
+          :gravity => $5
+        )
+      else raise ArgumentError, "Didn't recognise the geometry string #{geometry}."
+      end
+      self
+    end
+
+    def mime_type
+      ext = @encode ? ".#{@encode}" : File.extname(@original) 
+      Rack::Mime.mime_type ext
+    end
+    
+    # Utility method to test that all commands are working
+    #
+    def to_file(path)
+      File.open(path, 'w+') do |f|
+        f.write(`#{command}`)
+      end
+    end
+
+    def command(file_path = nil)
+      raise ArgumentError, "no original file provided. Do commander.file('some_file.jpg')" unless @original
+      file_path ||= full_file_path
+      cmd = []
+      cmd << @geometry if @geometry
+      cmd << @greyscale if @greyscale
+      cmd << @square if @square # should clear command
+      if @encode
+        cmd << "#{@encode}:-" # to stdout
+      else
+        cmd << '-'
+      end
+      
+      "#{@convert_command} #{file_path} " + cmd.join(' ')
+    end
+    
+    def check_file
+      ::File.exists?(full_file_path)
+    end
+    
+    private
+    
+    def full_file_path
+      File.join(@base_path, @original)
+    end
+    
+    def resize(geometry)
+      "-resize \"#{geometry}\""
+    end
+    
+    def crop(opts={})
+      width   = opts[:width]
+      height  = opts[:height]
+      gravity = GRAVITIES[opts[:gravity]]
+      x       = "#{opts[:x] || 0}"
+      x = '+' + x unless x[/^[+-]/]
+      y       = "#{opts[:y] || 0}"
+      y = '+' + y unless y[/^[+-]/]
+      repage  = opts[:repage] == false ? '' : '+repage'
+      resize  = opts[:resize]
+  
+      "#{"-resize #{resize} " if resize}#{"-gravity #{gravity} " if gravity}-crop #{width}x#{height}#{x}#{y} #{repage}"
+    end
+    
+    def resize_and_crop(opts={})
+      if !opts[:width] && !opts[:height]
+        return self
+      elsif !opts[:width] || !opts[:height]
+        attrs          = identify(temp_object)
+        opts[:width]   ||= attrs[:width]
+        opts[:height]  ||= attrs[:height]
+      end
+
+      opts[:gravity] ||= 'c'
+
+      opts[:resize]  = "#{opts[:width]}x#{opts[:height]}^^"
+      crop(opts)
+    end
+
+  end
+  
+end

data/lib/anisoptera/endpoint.rb

@@ -0,0 +1,60 @@
+module Anisoptera
+  
+  module Endpoint
+    
+    def self.factory(config, block)
+      if defined?(EventMachine) && Anisoptera.prefer_async
+        require 'anisoptera/async_endpoint'
+        AsyncEndpoint.new(config, &block)
+      else
+        require 'anisoptera/sync_endpoint'
+        SyncEndpoint.new(config, &block)
+      end
+      
+    end
+    
+    def initialize(config, &block)
+      @config = config
+      @handler = block
+    end
+
+    private
+
+    # Borrowed from Dragonfly
+    #
+    def routing_params(env)
+      pars = env['rack.routing_args'] ||
+        env['action_dispatch.request.path_parameters'] ||
+        env['router.params'] ||
+        env['usher.params'] ||
+        raise(ArgumentError, "couldn't find any routing parameters in env #{env.inspect}")
+      
+      # http_router doesn't parse querystring! Let's make sure we do
+      query = Rack::Utils.parse_nested_query(env["QUERY_STRING"]).inject({}) do |mem, (k,v)|
+        mem[k.to_sym] = v
+        mem
+      end
+      pars.update(query)
+    end
+    
+    def update_headers(commander = nil)
+      heads = Anisoptera::HEADERS.dup.update(
+        'X-Generator'  => self.class.name,
+        'Last-Modified' =>  Time.now.gmtime.strftime("%a, %d %b %Y %H:%M:%S GMT")
+      )
+      heads.update(@config.headers) if @config.headers && @config.headers.is_a?(Hash)
+      heads['Content-Type'] = commander.mime_type if commander
+      heads
+    end
+    
+    def error_image
+      @config.error_image || ::File.join(File.dirname(__FILE__), 'error.png')
+    end
+    
+    def error_status(status)
+      @config.error_status || status
+    end
+    
+  end
+  
+end

data/lib/anisoptera/serializer.rb

@@ -0,0 +1,35 @@
+# encoding: utf-8
+require 'base64'
+
+# Stolen fr... I mean 'borrowed' from DragonFly
+# https://github.com/markevans/dragonfly/blob/master/lib/dragonfly/serializer.rb
+#
+module Anisoptera
+  module Serializer
+    
+    # Exceptions
+    class BadString < RuntimeError; end
+    
+    extend self # So we can do Serializer.b64_encode, etc.
+    
+    def b64_encode(string)
+      Base64.encode64(string).tr("\n=",'')
+    end
+    
+    def b64_decode(string)
+      padding_length = string.length % 4
+      Base64.decode64(string + '=' * padding_length)
+    end
+    
+    def marshal_encode(object)
+      b64_encode(Marshal.dump(object))
+    end
+    
+    def marshal_decode(string)
+      Marshal.load(b64_decode(string))
+    rescue TypeError, ArgumentError => e
+      raise BadString, "couldn't decode #{string} - got #{e}"
+    end
+    
+  end
+end

data/lib/anisoptera/sync_endpoint.rb

@@ -0,0 +1,21 @@
+module Anisoptera
+  
+  class SyncEndpoint
+    
+    include Anisoptera::Endpoint
+    
+    def call(env)
+      params = routing_params(env)
+      job = Anisoptera::Commander.new( @config.base_path )
+      convert = @handler.call(job, params)
+      
+      result = `#{convert.command}`
+      
+      headers = update_headers(convert)
+      
+      [200, headers, [result]]
+    end
+    
+  end
+  
+end

data/lib/anisoptera/version.rb

@@ -0,0 +1,3 @@
+module Anisoptera
+  VERSION = "0.0.2"
+end

data/spec/anisoptera_spec.rb

@@ -0,0 +1,11 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+describe Anisoptera do
+
+  describe "defaults" do
+    it "must prefer async by default" do
+      Anisoptera.prefer_async.should be_true
+    end
+  end
+
+end

data/spec/async_endpoint_spec.rb

@@ -0,0 +1,258 @@
+# encoding: utf-8
+require File.dirname(__FILE__) + '/test_helper'
+
+require 'thin'
+require 'thin/async'
+require 'thin/async/test'
+require 'rack/test'
+require 'http_router'
+require "base64"
+
+$HERE = File.dirname(__FILE__)
+
+$CONVERT = "/usr/local/bin/convert"
+
+describe 'Anisoptera::AsyncEndpoint' do
+  include Rack::Test::Methods
+  
+  def app
+    Thin::Async::Test.new(@app)
+  end
+      
+  before do
+    # redefine config each time to reset app
+    Anisoptera[:media].configure do |config|
+      config.base_path = File.join($HERE, 'files')
+      config.error_status = nil
+      config.error_image = nil
+      config.convert_command = $CONVERT
+    end
+    
+    @app = HttpRouter.new do
+      add('/:g/:file').to Anisoptera[:media].endpoint {|image, params|
+        image_path = params[:file]
+        image.file(image_path).thumb(params[:g])
+        image.greyscale if params[:grey]
+        image.encode('jpg')
+      }
+    end
+  end
+  
+  shared_examples_for "a cached image" do |status, content_type|
+    
+    it 'should have status 200' do
+      last_response.status.should == status
+    end
+    
+    it 'should have long-lived headers' do
+      last_response.headers["Cache-Control"].should == "public, max-age=3153600"
+    end
+    
+    it 'should return Last-Modified header' do
+      last_response.headers['Last-Modified'].should == @the_time
+    end
+    
+    it 'should return encoded content-type' do
+      last_response.headers['Content-Type'].should == content_type
+    end
+  end
+  
+  shared_examples_for 'resized image data' do |test_image, geometry, content_type|
+    it 'should return resized image data' do
+      tempimg = File.join($HERE, 'files', "temp.#{content_type}")
+      Base64.encode64(`#{$CONVERT} #{test_image} -resize \"#{geometry}\" #{tempimg}`)
+      Base64.encode64(last_response.body).should == Base64.encode64(File.read(tempimg))
+      File.unlink(tempimg)
+    end
+  end
+  
+  describe 'success' do
+    before do
+      @the_time = mock_time("Sun, 20 Nov 2011 01:21:21 GMT") 
+      get '/20x20/test.gif'
+    end
+    
+    it_behaves_like 'a cached image', 200, 'image/jpeg'
+    
+    it_behaves_like 'resized image data', File.join($HERE,'files','test.gif'), '20x20', 'jpg'
+    
+  end
+  
+  describe 'with querystring' do
+    before do
+      @the_time = mock_time("Sun, 20 Nov 2011 01:21:21 GMT")
+      get '/20x20/missing.gif?file=test.gif'
+    end
+    
+    it_behaves_like 'a cached image', 200, 'image/jpeg'
+    
+  end
+  
+  describe 'with custom headers' do
+    before do
+      # redefine config each time to reset app
+      Anisoptera[:custom].configure do |config|
+        config.base_path = File.join($HERE, 'files')
+        config.headers = {
+          'Cache-Control' => '1234567890',
+          'X-Custom'      => 'custom-head'
+        }
+      end
+
+      @app = HttpRouter.new do
+        add('/:g/:file').to Anisoptera[:custom].endpoint {|image, params|
+          image_path = params[:file]
+          image.file(image_path).thumb(params[:g])
+          image.encode('jpg')
+        }
+      end
+      
+      it 'should return encoded content-type' do
+        last_response.headers['Content-Type'].should == 'image/jpg'
+      end
+      
+      it 'should overwrite passed headers' do
+        last_response.headers['Cache-Control'].should == '1234567890'
+      end
+      
+      it 'should add passed new headers' do
+        last_response.headers['X-Custom'].should == 'custom-head'
+      end
+      
+    end
+  end
+  
+  describe 'missing image' do
+    before do
+      @the_time = mock_time("Sun, 20 Nov 2011 01:21:21 GMT")
+      get '/20x20/testfoo.gif'
+    end
+    
+    it_behaves_like 'a cached image', 404, 'image/png'
+    
+    it_behaves_like 'resized image data', File.join($HERE,'..','lib','anisoptera', 'error.png'), '20x20', 'jpg'
+  end
+  
+  describe 'missing image with error image configured' do
+    before do
+      @the_time = mock_time("Sun, 20 Nov 2011 01:21:21 GMT")
+      Anisoptera[:media].config.error_image = File.join($HERE, 'files', 'Chile.gif')
+      get '/20x20/testfoo.gif'
+    end
+    
+    it_behaves_like 'a cached image', 404, 'image/gif'
+    
+    it_behaves_like 'resized image data', File.join($HERE,'files', 'Chile.gif'), '20x20', 'jpg'
+  end
+  
+  describe 'with malformed geometry' do
+    before do
+      @the_time = mock_time("Sun, 20 Nov 2011 01:21:21 GMT")
+      get '/20x20wtf/test.gif'
+    end
+    
+    it_behaves_like 'a cached image', 500, 'image/png'
+    
+    it 'should set X-Error header' do
+      last_response.headers['X-Error'].should == "Didn't recognise the geometry string 20x20wtf."
+    end
+  end
+  
+  describe 'with exceptions in custom block' do
+    
+    before do
+      @the_time = mock_time("Sun, 20 Nov 2011 01:21:21 GMT")
+      
+      @app = HttpRouter.new do
+        add('/:g/:file').to Anisoptera[:media].endpoint {|image, params|
+          raise 'Oops!'
+        }
+      end
+      
+      get '/20x20/test.gif'
+    end
+    
+    it_behaves_like 'a cached image', 500, 'image/png'
+    
+    it 'should set X-Error header' do
+      last_response.headers['X-Error'].should == 'Oops!'
+    end
+    
+  end
+  
+  describe 'with exceptions and custom config.error_status' do
+    before do
+      @the_time = mock_time("Sun, 20 Nov 2011 01:21:21 GMT")
+      Anisoptera[:media].config.error_status = 200
+      
+      get '/20x20/testfoo.gif'
+    end
+    
+    it_behaves_like 'a cached image', 200, 'image/png'
+    
+    it 'should set X-Error header' do
+      last_response.headers['X-Error'].should == 'Image not found'
+    end
+    
+  end
+  
+  describe 'with exceptions in custom block and custom error_status' do
+    
+    before do
+      Anisoptera[:media].config.error_status = 200
+      @the_time = mock_time("Sun, 20 Nov 2011 01:21:21 GMT")
+      
+      @app = HttpRouter.new do
+        add('/:g/:file').to Anisoptera[:media].endpoint {|image, params|
+          raise 'Oops!'
+        }
+      end
+      
+      get '/20x20/test.gif'
+    end
+    
+    it_behaves_like 'a cached image', 200, 'image/png'
+    
+    it 'should set X-Error header' do
+      last_response.headers['X-Error'].should == 'Oops!'
+    end
+    
+  end
+  
+  describe 'with exceptions and config.on_error block' do
+    
+    before do
+      @the_time = mock_time("Sun, 20 Nov 2011 01:21:21 GMT")
+      
+      @error_message = ''
+      @error_params = nil
+      @env = nil
+      Anisoptera[:media].config.on_error do |exception, params, env|
+        @error_message = 'Oops!'
+        @error_params = params
+        @env = env
+      end
+
+      @app = HttpRouter.new do
+        add('/:gg/:file').to Anisoptera[:media].endpoint {|image, params|
+          raise 'Oops!'
+        }
+      end
+      
+      get '/20x20/test.gif'
+    end
+    
+    it 'should have called error block' do
+      @error_message.should == 'Oops!'
+      @error_params.should == {:gg => '20x20', :file => 'test.gif'}
+      @env['SCRIPT_NAME'].should == '/20x20/test.gif'
+    end
+    
+    it_behaves_like 'a cached image', 500, 'image/png'
+    
+    it 'should set X-Error header' do
+      last_response.headers['X-Error'].should == 'Oops!'
+    end
+    
+  end
+end

data/spec/commander_spec.rb

@@ -0,0 +1,104 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+describe Anisoptera::Commander do
+  
+  describe 'building file path' do
+    
+    before do
+      @commander = Anisoptera::Commander.new('/data')
+    end
+    
+    it 'must raise error if no file name given' do
+      proc {
+        @commander.command
+      }.should raise_error(ArgumentError)
+    end
+    
+    it 'must correct missing slashes' do
+      @commander.file('foo.jpg').command.should match(/^convert \/data\/foo\.jpg/)
+      @commander.file('/foo.jpg').command.should match(/^convert \/data\/foo\.jpg/)
+    end
+  end
+  
+  describe 'commands' do
+    before do
+      @commander = Anisoptera::Commander.new('/data').file('foo.jpg')
+    end
+    
+    describe 'resize' do
+      it 'should add resize command' do
+        @commander.thumb('10x10').command.should == "convert /data/foo.jpg -resize \"10x10\" -"
+      end
+    end
+
+    describe 'crop' do
+      it 'should add resize command' do
+        @commander.thumb('120x120+10+5').command.should == "convert /data/foo.jpg -crop 120x120+10+5 +repage -"
+      end
+    end
+    
+    describe 'scale' do
+      it 'should add scale resize' do
+        @commander.thumb('50x50%').command.should == "convert /data/foo.jpg -resize \"50x50%\" -"
+      end
+    end
+    
+    describe 'bigger / smaller than' do
+      it 'should add < or >' do
+        @commander.thumb('400x300<').command.should == "convert /data/foo.jpg -resize \"400x300<\" -"
+        @commander.thumb('400x300>').command.should == "convert /data/foo.jpg -resize \"400x300>\" -"
+      end
+    end
+    
+    describe 'positioning (gravity)' do
+      it 'should resize with gravity' do
+        @commander.thumb('400x300#ne').command.should == "convert /data/foo.jpg -resize 400x300^^ -gravity NorthEast -crop 400x300+0+0 +repage -"
+      end
+    end
+    
+    describe 'encode' do
+      it 'should add format arguments' do
+        @commander.encode('gif').command.should == 'convert /data/foo.jpg gif:-'
+      end
+    end
+    
+    describe 'greyscale' do
+      it 'should add colorspace argument' do
+        @commander.greyscale.command.should == 'convert /data/foo.jpg -colorspace Gray -'
+      end
+    end
+    
+    describe 'combined' do
+      
+      it 'should combine commands' do
+        @commander.
+          thumb('100x100#ne').
+          encode('png').
+          command.should == "convert /data/foo.jpg -resize 100x100^^ -gravity NorthEast -crop 100x100+0+0 +repage png:-"
+      end
+      
+      it 'should accept - as gravity separator because the hash breaks browsers' do
+        @commander.
+          thumb('100x100-ne').
+          command.should == "convert /data/foo.jpg -resize 100x100^^ -gravity NorthEast -crop 100x100+0+0 +repage -"
+      end
+    end
+    
+  end
+  
+  describe 'mime_type' do
+    before do
+      @commander = Anisoptera::Commander.new('/data').file('foo.png')
+    end
+    
+    it 'should get default from filename' do
+      @commander.mime_type.should == 'image/png'
+    end
+    
+    it 'should use the one passed to #encode if provided' do
+      @commander.encode('gif').mime_type.should == 'image/gif'
+    end
+    
+  end
+
+end

data/spec/serializer_spec.rb

@@ -0,0 +1,22 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+describe Anisoptera::Serializer do
+  before do
+    @data = {:a => 'a', :b => 'b', :c => 11}
+    @encoded = Anisoptera::Serializer.marshal_encode(@data)
+  end
+
+  describe "encoding" do
+    it "must convert object into a string" do
+      @encoded.class.should == String
+    end
+  end
+  
+  describe 'decoding' do
+    it 'should recover original object' do
+      decoded = Anisoptera::Serializer.marshal_decode(@encoded)
+      decoded.should == @data
+    end
+  end
+
+end

data/spec/test_helper.rb

@@ -0,0 +1,19 @@
+require 'rubygems'
+require 'bundler'
+Bundler.setup
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+require 'anisoptera'
+
+
+require 'rspec'
+
+def mock_time(atime)
+  t = stub('Now')
+  Time.stub!(:now).and_return t
+  t.stub!(:gmtime).and_return t
+  t.should_receive(:strftime).with("%a, %d %b %Y %H:%M:%S GMT").and_return atime
+  atime
+end

metadata

@@ -0,0 +1,182 @@
+--- !ruby/object:Gem::Specification 
+name: anisoptera
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Ismael Celis
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-12-04 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: eventmachine
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.12.10
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: thin
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: thin_async
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rack
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.2
+  type: :runtime
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.0
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: rack-test
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: thin-async-test
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: http_router
+  prerelease: false
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id009
+description: You'll need an Eventmachine server such as Thin to run this. See README.'
+email: 
+- ismaelct@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- README.md
+- Rakefile
+- anisoptera.gemspec
+- examples/http_router.ru
+- examples/pic1.jpg
+- lib/anisoptera.rb
+- lib/anisoptera/app.rb
+- lib/anisoptera/async_endpoint.rb
+- lib/anisoptera/commander.rb
+- lib/anisoptera/endpoint.rb
+- lib/anisoptera/error.png
+- lib/anisoptera/serializer.rb
+- lib/anisoptera/sync_endpoint.rb
+- lib/anisoptera/version.rb
+- spec/anisoptera_spec.rb
+- spec/async_endpoint_spec.rb
+- spec/commander_spec.rb
+- spec/files/Chile.gif
+- spec/files/test.gif
+- spec/serializer_spec.rb
+- spec/test_helper.rb
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: anisoptera
+rubygems_version: 1.8.17
+signing_key: 
+specification_version: 3
+summary: Async Rack app for image thumbnailing
+test_files: 
+- spec/anisoptera_spec.rb
+- spec/async_endpoint_spec.rb
+- spec/commander_spec.rb
+- spec/files/Chile.gif
+- spec/files/test.gif
+- spec/serializer_spec.rb
+- spec/test_helper.rb