thumbo 0.6.0

data/CHANGES

@@ -0,0 +1,11 @@
+= thumbs changes history
+
+== thumbo 0.6 - 2010-05-31
+
+* stable undocumented release
+
+== thumbo 0.5 - 2008-10-22
+
+* 1 major enhancement
+  * Birthday!
+  * extracted from Ludy::HasManyThumbnails!

data/LICENSE

@@ -0,0 +1,201 @@
+                              Apache License
+                        Version 2.0, January 2004
+                     http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+   To apply the Apache License to your work, attach the following
+   boilerplate notice, with the fields enclosed by brackets "[]"
+   replaced with your own identifying information. (Don't include
+   the brackets!)  The text should be enclosed in the appropriate
+   comment syntax for the file format. We also recommend that a
+   file or class name and description of purpose be included on the
+   same "printed page" as the copyright notice for easier
+   identification within third-party archives.
+
+Copyright [yyyy] [name of copyright owner]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/NOTICE

@@ -0,0 +1,7 @@
+= notice for other stuffs
+
+* this project skeleton is built through Mr Bones 2.1.0:
+    gem install bones
+    http://codeforpeople.rubyforge.org/bones/
+
+* test cases were written in mini-test.

data/README.rdoc

@@ -0,0 +1,41 @@
+= thumbo 0.6
+by Lin Jen-Shin (aka godfat 真常)
+  godfat (XD) godfat.org
+
+== LINKS:
+
+* github[http://github.com/godfat/thumbo]
+
+== DESCRIPTION:
+
+ create thumbnails via RMagick
+
+== FEATURES:
+
+== SYNOPSIS:
+
+== REQUIREMENTS:
+
+* RMagick 2
+
+== INSTALL:
+
+* gem install thumbo
+
+== LICENSE:
+
+Apache License 2.0
+
+Copyright (c) 2008-2010, Lin Jen-Shin (aka godfat 真常)
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+   http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/Rakefile

@@ -0,0 +1,35 @@
+# encoding: utf-8
+
+begin
+  require 'bones'
+rescue LoadError
+  abort '### Please install the "bones" gem ###'
+end
+
+ensure_in_path 'lib'
+proj = 'thumbo'
+require "#{proj}/version"
+
+Bones{
+  version Thumbo::VERSION
+
+  # ruby_opts [''] # silence warning, too many in addressable and/or dm-core
+  depend_on 'rmagick', :version => '>=2.6.0'
+
+  name    proj
+  url     "http://github.com/godfat/#{proj}"
+  authors 'Lin Jen-Shin (aka godfat 真常)'
+  email   'godfat (XD) godfat.org'
+
+  history_file   'CHANGES'
+   readme_file   'README.rdoc'
+   ignore_file   '.gitignore'
+  rdoc.include   ['\w+']
+}
+
+CLEAN.include Dir['**/*.rbc']
+
+task :default do
+  Rake.application.options.show_task_pattern = /./
+  Rake.application.display_tasks_and_comments
+end

data/TODO

@@ -0,0 +1,3 @@
+
+* mogilefs storage test case
+* easier way to create a thumbnail from a line of code

data/lib/thumbo.rb

@@ -0,0 +1,99 @@
+
+require 'thumbo/proxy'
+require 'thumbo/exceptions/file_not_found'
+
+module Thumbo
+  def self.included model
+    model.extend(Thumbo::ClassMethod)
+  end
+
+  def self.calculate_dimension limit, width, height
+    long, short = width >= height ? [width, height] : [height, width]
+
+    if long <= limit # stay on
+      [width, height]
+
+    elsif width == height # square
+      [limit, limit]
+
+    else # detect which is longer
+
+      # assume width is longer
+      new_width, new_height = limit, short * (limit.to_f / long)
+
+      # swap if height is longer
+      new_width, new_height = new_height, new_width if long == height
+
+      [new_width, new_height]
+    end
+  end
+
+  module ClassMethod
+    def thumbo_storage
+      @thumbo_storage ||= begin
+        require 'thumbo/storages/filesystem'
+        Thumbo::Filesystem.new
+      end
+    end
+
+    def thumbo_common
+      {}
+    end
+
+    def thumbo_square
+      {}
+    end
+
+    def thumbo_labels
+      {}
+    end
+  end
+
+  def thumbos
+     @thumbos ||= init_thumbos
+  end
+
+  def thumbo_filename thumbo
+    "#{object_id}_#{thumbo.title}.#{thumbo.fileext}"
+  end
+
+  def thumbo_uri thumbo
+    paths = thumbo.paths
+    paths[rand(paths.size)]
+  end
+
+  def thumbo_mime_type
+    thumbos[:original].mime_type
+  end
+
+  def create_thumbos after_scale = lambda{}, &block
+    after_scale = block if block_given?
+
+    # scale thumbnails
+    self.class.thumbo_common.merge(self.class.thumbo_square).each_key{ |title|
+      after_scale[ thumbos[title].create ]
+    }
+
+    # the last one don't scale at all, but call hook too
+    after_scale[ thumbos[:original] ]
+
+    self
+  end
+
+  private
+  def init_thumbos
+    # just to make sure original is setup.
+    {:original => true}.merge(
+      self.class.thumbo_common.merge(
+        self.class.thumbo_square.merge(
+          self.class.thumbo_labels
+        )
+      )
+    ).inject({}){ |result, title_value|
+      title = title_value.first
+      result[title] = Thumbo::Proxy.new(self, title)
+      result
+    }
+  end
+
+end # of Thumbs

data/lib/thumbo/exceptions/file_not_found.rb

@@ -0,0 +1,8 @@
+
+module Thumbo
+  class FileNotFound < StandardError
+    def initialize filename
+      super("Thumbo: File `#{filename}' was not found.")
+    end
+  end
+end

data/lib/thumbo/proxy.rb

@@ -0,0 +1,185 @@
+
+require 'RMagick'
+
+module Thumbo
+  class Proxy
+    attr_reader :title
+    def initialize owner, title
+      @owner, @title = owner, title
+      @image = nil # please stop warning me @image is not defined
+    end
+
+    # image processing
+    def image
+      @image || (self.image = read_image)
+    end
+
+    # check if image exists in memory
+    def image?
+      @image
+    end
+
+    def image_with_timeout time_limit = 5
+      @image || (self.image = read_image_with_timeout(time_limit))
+    end
+
+    def image= new_image
+      release
+      @image = new_image
+    end
+
+    # is this helpful or not?
+    def release
+      @image = nil
+      GC.start
+      self
+    end
+
+    # e.g.,
+    # thumbnails[:original].from_blob uploaded_file.read
+    def from_blob blob, &block
+      self.image = Magick::ImageList.new.from_blob(blob, &block)
+      self
+    end
+
+    def to_blob &block
+      self.image.to_blob(&block)
+    end
+
+    # convert format to website displable image format
+    def convert_format_for_website
+      image.format = 'PNG' unless ['GIF', 'JPEG'].include?(image.format)
+    end
+
+    # create thumbnails in the image list (Magick::ImageList)
+    def create
+      return if title == :original
+      release
+      limit = owner.class.thumbo_common[title]
+
+      if limit
+        create_common(limit)
+
+      else
+        limit = owner.class.thumbo_square[title]
+        create_square(limit)
+
+      end
+
+      self
+    end
+
+    def write filename = nil, &block
+      storage.write(filename || self.filename, to_blob(&block))
+    end
+
+    # delegate all
+    def method_missing msg, *args, &block
+      raise 'fetch image first if you want to operate the image' unless @image
+
+      if image.__respond_to__?(msg) # operate ImageList, a dirty way because of RMagick...
+         [image.__send__(msg, *args, &block)]
+
+      elsif image.first.respond_to?(msg) # operate each Image in ImageList
+        image.to_a.map{ |layer| layer.__send__(msg, *args, &block) }
+
+      else # no such method...
+        super(msg, *args, &block)
+
+      end
+    end
+
+    # storage related
+    def storage
+      owner.class.thumbo_storage
+    end
+
+    def paths
+      storage.paths(filename)
+    end
+
+    def delete
+      storage.delete(filename)
+    end
+
+    # owner delegate
+    def filename
+      owner.thumbo_filename self
+    end
+
+    def uri
+      owner.thumbo_uri self
+    end
+
+    # attribute
+    def dimension img = image.first
+      [img.columns, img.rows]
+    end
+
+    def mime_type
+      image.first.mime_type
+    end
+
+    def fileext
+      if @image
+        case ext = image.first.format
+          when 'PNG8';   'png'
+          when 'PNG24';  'png'
+          when 'PNG32';  'png'
+          when 'GIF87';  'gif'
+          when 'JPEG';   'jpg'
+          when 'PJPEG';  'jpg'
+          when 'BMP2';   'bmp'
+          when 'BMP3';   'bmp'
+          when 'TIFF64'; 'tiff'
+          else; ext.downcase
+        end
+
+      elsif owner.respond_to?(:thumbo_default_fileext)
+        owner.thumbo_default_fileext
+
+      else
+        raise "please implement #{owner.class}\#thumbo_default_fileext or Thumbo can't guess the file extension"
+
+      end
+    end
+
+    protected
+    attr_reader :owner
+
+    def create_common limit
+      # can't use map since it have different meaning to collect here
+      self.image = owner.thumbos[:original].image.collect{ |layer|
+        # i hate column and row!! nerver remember which is width...
+        new_dimension = Thumbo.calculate_dimension(limit, layer.columns, layer.rows)
+
+        # no need to scale
+        if new_dimension == dimension(layer)
+          layer
+
+        # scale to new_dimension
+        else
+          layer.scale(*new_dimension)
+
+        end
+      }
+    end
+
+    def create_square limit
+      self.image = owner.thumbos[:original].image.collect{ |layer|
+        layer.crop_resized(limit, limit).enhance
+      }
+    end
+
+    private
+    # fetch image from storage to memory
+    # raises Magick::ImageMagickError
+    def read_image
+      Magick::ImageList.new.from_blob(storage.read(filename))
+    end
+
+    def read_image_with_timeout time_limit = 5
+      Timeout.timeout(time_limit){ fetch }
+    end
+  end
+end

data/lib/thumbo/storages/abstract.rb

@@ -0,0 +1,33 @@
+
+module Thumbo
+  class AbstractStorage
+    def read filename
+      raise NotImplementedError
+    end
+
+    def write filename, blob
+      raise NotImplementedError
+    end
+
+    def write_file filename, file
+      raise NotImplementedError
+    end
+
+    def delete filename
+      raise NotImplementedError
+    end
+
+    def paths filename
+      raise NotImplementedError
+    end
+
+    def exist? filename
+      raise NotImplementedError
+    end
+
+    protected
+    def raise_file_not_found filename
+      raise Thumbo::FileNotFound.new(filename)
+    end
+  end
+end

data/lib/thumbo/storages/filesystem.rb

@@ -0,0 +1,73 @@
+
+require 'thumbo/storages/abstract'
+require 'fileutils'
+require 'digest/md5'
+
+module Thumbo
+  class Filesystem < AbstractStorage
+    attr_accessor :path, :prefix_size
+    def initialize opts = {}
+      @path = opts[:path] || 'public/images/thumbo'
+      @prefix_size = opts[:prefix_size] || 1
+    end
+
+    def read filename
+      File.read(calculate_path(filename))
+
+    rescue Errno::ENOENT
+      raise_file_not_found(filename)
+
+    end
+
+    def write filename, blob
+      target = ensure_path(filename)
+      (File.open(target, 'w') << blob).close
+    end
+
+    def write_file filename, file
+      target = ensure_path(filename)
+      FileUtils.cp(file.path, target)
+    end
+
+    def delete filename
+      target = calculate_path(filename)
+      if File.exist?(target)
+        File.delete(target)
+
+      else
+        raise_file_not_found(filename)
+
+      end
+    end
+
+    def paths filename
+      if target = exist?(filename)
+        [target]
+
+      else
+        raise_file_not_found(filename)
+
+      end
+    end
+
+    def exist? filename
+      target = calculate_path(filename)
+      File.exist?(target) ? target : false
+    end
+
+    def prefix filename
+      Digest::MD5.hexdigest(filename)[0, prefix_size]
+    end
+
+    private
+    def calculate_path filename
+      File.join( path, prefix(filename), filename )
+    end
+
+    def ensure_path filename
+      target = calculate_path(filename)
+      FileUtils.mkdir_p(target.split('/')[0..-2].join('/'))
+      target
+    end
+  end
+end

data/lib/thumbo/storages/mogilefs.rb

@@ -0,0 +1,72 @@
+
+require 'thumbo/storages/abstract'
+
+begin
+  require 'mogilefs'
+rescue LoadError
+  raise LoadError.new("Please install gem mogilefs-client")
+end
+
+module Thumbo
+  class Mogilefs < AbstractStorage
+    attr_accessor :klass, :domain, :hosts, :timeout_time
+    attr_accessor :client
+    def initialize opts = {}
+      @klass  = opts[:klass]  || 'thumbo'
+      @domain = opts[:domain] || 'thumbo'
+      @hosts  = opts[:hosts]  || ['127.0.0.1:6001']
+      @timeout_time = opts[:timeout_time] || 2
+    end
+
+    def read filename
+      Timeout.timeout(timeout_time){
+        paths(filename).each{ |path|
+          begin
+            return client.get_file_data(filename)
+          rescue SystemCallError
+            next
+          end
+        }
+      }
+    end
+
+    def write filename, blob
+      client.store_content(filename, klass, blob)
+    end
+
+    def write_file filename, file
+      client.store_file(filename, klass, file)
+    end
+
+    def delete filename
+      client.delete(filename)
+
+    rescue MogileFS::Backend::UnknownKeyError
+      raise_file_not_found(filename)
+
+    end
+
+    def paths filename
+      client.get_paths(filename)
+
+    rescue MogileFS::Backend::UnknownKeyError
+      raise_file_not_found(filename)
+
+    end
+
+    def exist? filename
+      target = paths(filename)
+      target[ rand(target.size) ]
+
+    rescue Thumbo::FileNotFound
+      false
+    end
+
+    def client
+      @client ||=
+        MogileFS::MogileFS.new( :domain  => domain,
+                                :hosts   => hosts,
+                                :timeout => timeout_time )
+    end
+  end
+end

data/lib/thumbo/version.rb

@@ -0,0 +1,4 @@
+
+module Thumbo
+  VERSION = '0.6.0'
+end

data/test/helper.rb

@@ -0,0 +1,13 @@
+
+require 'rubygems'
+
+TestCase = begin
+             require 'minitest/unit'
+             MiniTest::Unit.autorun
+             MiniTest::Unit::TestCase
+           rescue LoadError
+             require 'test/unit'
+             Test::Unit::TestCase
+           end
+
+require 'thumbo'

data/test/test_storage.rb

@@ -0,0 +1,86 @@
+
+require 'test/helper'
+require 'digest/md5'
+
+class Photo
+  include Thumbo
+  def self.thumbo_storage
+    @thumbo_storage ||= Thumbo::Filesystem.new(:path => 'tmp', :prefix_size => 2)
+  end
+
+  def self.thumbo_common
+    {:common => 200}
+  end
+
+  def self.thumbo_square
+    {:square => 50}
+  end
+
+  def thumbo_filename thumbo
+    "#{self.object_id}_#{thumbo.title}.#{thumbo.fileext}"
+  end
+
+  def thumbo_uri thumbo
+    first, last = thumbo.filename.split('_')
+    "http://img.godfat.org/photos/#{first}_zzz_#{last}"
+  end
+
+  def thumbo_default_fileext
+    'png'
+  end
+
+end
+
+class ThumboDefault
+  include Thumbo
+
+  def self.thumbo_common
+    {:common => 200}
+  end
+
+  def self.thumbo_square
+    {:square => 50}
+  end
+
+  def thumbo_default_fileext
+    'png'
+  end
+end
+
+class StorageTest < TestCase
+  def test_uri
+    p = Photo.new
+    t = p.thumbos[:original]
+    t.from_blob(File.open('test/ruby.png').read)
+
+    assert_equal( "http://img.godfat.org/photos/#{p.object_id}_zzz_original.png",
+                  p.thumbos[:original].uri )
+  end
+
+  def test_default
+    p = ThumboDefault.new
+    t = p.thumbos[:original]
+    t.from_blob(File.open('test/ruby.png').read)
+    t.write
+
+    assert_equal( "public/images/thumbo/#{Digest::MD5.hexdigest(t.filename)[0,1]}" +
+                  "/#{p.object_id}_original.png",
+                  p.thumbos[:original].uri )
+  ensure
+    File.delete(t.uri)
+  end
+
+  def test_raises
+    assert_raises(Thumbo::FileNotFound) do
+      Photo.new.thumbos[:original].delete
+    end
+  end
+
+  def test_write_file
+    target = "public/images/thumbo/#{Digest::MD5.hexdigest('LICENSE')[0,1]}/LICENSE"
+    ThumboDefault.thumbo_storage.write_file('LICENSE', File.open('LICENSE'))
+    assert_equal(File.read('LICENSE'), File.read(target))
+  ensure
+    File.delete(target)
+  end
+end

data/test/test_thumbo.rb

@@ -0,0 +1,103 @@
+
+require 'test/helper'
+
+class RubyLogo
+  include Thumbo
+
+  self.thumbo_storage.path = './tmp'
+
+  def self.thumbo_common
+    { :small => 240, :thumb => 110 }
+  end
+
+  def self.thumbo_square
+    { :square_medium => 48, :square_small => 24 }
+  end
+
+  def self.thumbo_labels
+    { :original      => 'o',   :raw          => 'z',
+      :small         => 's',   :thumb        => 't',
+      :square_medium => 'msq', :square_small => 'ssq' }
+  end
+
+  attr_accessor :mime_type, :log
+  def initialize blob = nil
+    if blob
+      thumbos[:raw].from_blob(blob).write
+      thumbos[:original].image = thumbos[:raw].image
+      thumbos[:raw].release
+      self.mime_type = thumbos[:original].mime_type
+    end
+    self.log = []
+  end
+
+  def create
+    create_thumbos(lambda{ |thumbo|
+      log << thumbo.dimension
+      thumbo.write
+      thumbo.release
+    })
+  end
+
+  # same as thumbnail.filename
+  def thumbo_filename thumbo
+    "#{self.class}_#{checksum}_" +
+    "#{self.class.thumbo_labels[thumbo.title]}.#{thumbo.fileext}"
+  end
+
+  def thumbo_default_fileext
+    case ext = mime_type.sub(%r{^image/}, '').downcase
+      when 'jpeg'; 'jpg'
+      else; ext
+    end
+  end
+
+  def checksum; 'abcdefg'; end
+end
+
+class TestThumbo < TestCase
+  Dims00 = [[ 24, 24], [ 48, 48],
+            [109,110], [239,240], [995,996]]
+  Dims90 = Dims00.map(&:reverse)
+
+  def test_first
+    logo = RubyLogo.new File.open('test/ruby.png').read
+    assert_kind_of String, logo.thumbos[:original].to_blob
+
+    logo.create
+    assert_dimension Dims00, logo.log.sort
+    assert_dimension Dims00, read_dimension
+
+    logo2 = RubyLogo.new
+    logo2.mime_type = logo.mime_type
+
+    logo2.thumbos[:original].image
+    logo2.thumbos[:original].rotate! 90
+    logo2.create
+
+    assert_dimension Dims90[0..-2], logo2.log.sort
+    assert_dimension Dims90[0..-2] << Dims00[-1], read_dimension
+
+  ensure
+    cleanup
+  end
+
+  def assert_dimension should, real
+    should.zip(real).each{ |s, r|
+      assert_equal s, r
+    }
+  end
+
+  def read_dimension
+    Magick::ImageList.new.read(*Dir['tmp/**/*.png']).to_a.map{ |img|
+      [img.columns, img.rows]
+    }.sort
+  end
+
+  def cleanup
+    Dir['tmp/*'].each{ |prefix|
+      File.delete(*Dir["#{prefix}/*.png"])
+      Dir.rmdir(prefix)
+    }
+  end
+end

data/thumbo.gemspec

@@ -0,0 +1,37 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{thumbo}
+  s.version = "0.6.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Lin Jen-Shin (aka godfat 真常)"]
+  s.date = %q{2010-05-31}
+  s.description = %q{ create thumbnails via RMagick}
+  s.email = %q{godfat (XD) godfat.org}
+  s.extra_rdoc_files = ["CHANGES", "LICENSE", "NOTICE", "README.rdoc", "Rakefile", "TODO", "test/ruby.png", "thumbo.gemspec"]
+  s.files = ["CHANGES", "LICENSE", "NOTICE", "README.rdoc", "Rakefile", "TODO", "lib/thumbo.rb", "lib/thumbo/exceptions/file_not_found.rb", "lib/thumbo/proxy.rb", "lib/thumbo/storages/abstract.rb", "lib/thumbo/storages/filesystem.rb", "lib/thumbo/storages/mogilefs.rb", "lib/thumbo/version.rb", "test/helper.rb", "test/ruby.png", "test/test_storage.rb", "test/test_thumbo.rb", "thumbo.gemspec"]
+  s.homepage = %q{http://github.com/godfat/thumbo}
+  s.rdoc_options = ["--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{thumbo}
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{create thumbnails via RMagick}
+  s.test_files = ["test/test_storage.rb", "test/test_thumbo.rb"]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rmagick>, [">= 2.6.0"])
+      s.add_development_dependency(%q<bones>, [">= 3.4.3"])
+    else
+      s.add_dependency(%q<rmagick>, [">= 2.6.0"])
+      s.add_dependency(%q<bones>, [">= 3.4.3"])
+    end
+  else
+    s.add_dependency(%q<rmagick>, [">= 2.6.0"])
+    s.add_dependency(%q<bones>, [">= 3.4.3"])
+  end
+end

metadata

@@ -0,0 +1,124 @@
+--- !ruby/object:Gem::Specification 
+name: thumbo
+version: !ruby/object:Gem::Version 
+  hash: 7
+  prerelease: false
+  segments: 
+  - 0
+  - 6
+  - 0
+  version: 0.6.0
+platform: ruby
+authors: 
+- "Lin Jen-Shin (aka godfat \xE7\x9C\x9F\xE5\xB8\xB8)"
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-06-07 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rmagick
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 2
+        - 6
+        - 0
+        version: 2.6.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: bones
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 17
+        segments: 
+        - 3
+        - 4
+        - 3
+        version: 3.4.3
+  type: :development
+  version_requirements: *id002
+description: " create thumbnails via RMagick"
+email: godfat (XD) godfat.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGES
+- LICENSE
+- NOTICE
+- README.rdoc
+- Rakefile
+- TODO
+- test/ruby.png
+- thumbo.gemspec
+files: 
+- CHANGES
+- LICENSE
+- NOTICE
+- README.rdoc
+- Rakefile
+- TODO
+- lib/thumbo.rb
+- lib/thumbo/exceptions/file_not_found.rb
+- lib/thumbo/proxy.rb
+- lib/thumbo/storages/abstract.rb
+- lib/thumbo/storages/filesystem.rb
+- lib/thumbo/storages/mogilefs.rb
+- lib/thumbo/version.rb
+- test/helper.rb
+- test/ruby.png
+- test/test_storage.rb
+- test/test_thumbo.rb
+- thumbo.gemspec
+has_rdoc: true
+homepage: http://github.com/godfat/thumbo
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: thumbo
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: create thumbnails via RMagick
+test_files: 
+- test/test_storage.rb
+- test/test_thumbo.rb