allthumbs 0.0.1

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2011 John Bresnik and The Barbarian Group, LLC
+
+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.rdoc

@@ -0,0 +1,32 @@
+=Allthumbs
+
+Gots tons of thumbnails clogging up your requests?  Why merge them all into a single image / single request?
+
+=Dependencies
+
+Library is whole dependent on Image Magick for processing files, the gem will let you know if it can't find the necessary binaries
+
+=Usage Examples
+
+* After Save callback in Rails 3, using paperclip to regenerate an image based on changes
+
+   after_save :generate_thumbnail_image
+   def generate_thumbnail_image
+      Allthumbs.generate (all.map {|x| x.image.path }), "#{RAILS_ROOT}/public/images/thumbnail-image.jpg", { :row => 3, :border => 2 }
+   end
+
+=Tests
+
+Comes with a complete rspec suite:
+
+   $ rake test
+
+=Todo
+
+Develop some kind of helper to assist in generation of supporting HTML, e.g. you would like have rollovers or popups for each thumbnail
+
+=Thanks
+
+* Thoughtbot (heavily influenced by paperclip)
+* Rick Webb (championing the open source cause)
+

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'bundler/setup'
+
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+$LOAD_PATH << File.join(File.dirname(__FILE__), 'lib')
+require 'allthumbs'
+
+desc 'Default: run unit tests.'
+task :default => [:clean, :all]
+
+desc 'Test the allthumbs plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib' << 'profile'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Start an IRB session with all necessary files required.'
+task :shell do |t|
+  chdir File.dirname(__FILE__)
+  exec 'irb -I lib/ -I lib/allthumbs -r rubygems -r tempfile -r init'
+end
+
+desc 'Clean up files.'
+task :clean do |t|
+  FileUtils.rm_rf "tmp"
+  FileUtils.rm "test/debug.log" rescue nil
+  Dir.glob("allthumbs-*.gem").each{|f| FileUtils.rm f }
+end
+
+desc 'Build the gemspec.'
+task :gemspec do |t|
+  exec 'gem build allthumbs.gemspec'
+end
+
+desc "Print a list of the files to be put into the gem"
+task :manifest => :clean do
+  spec.files.each do |file|
+    puts file
+  end
+end
+
+desc "Generate a gemspec file for GitHub"
+task :gemspec => :clean do
+  File.open("#{spec.name}.gemspec", 'w') do |f|
+    f.write spec.to_ruby
+  end
+end
+
+desc "Build the gem into the current directory"
+task :gem => :gemspec do
+  `gem build #{spec.name}.gemspec`
+end

data/init.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__), "lib", "allthumbs")

data/lib/allthumbs.rb

@@ -0,0 +1,26 @@
+require 'cocaine' 
+module Allthumbs
+  # Generates the montage image for a list of file paths 
+  # * options
+  #   :border - surrounding border for each thumbnail in pixels
+  #   :row    - number of thumbnails per row
+  #   :column - number of thumbnails per column
+  def self.generate files, out, options = {}
+    row    = options[:row]
+    column = options[:column]
+    border = options[:border]
+
+    raise "Incorrect number of files for specified row and column lengths" if files.size != (row * column) if row and column
+    files.split.map { |file| raise "Attempting to generate with one or more invalid files" unless File.exists? file }
+
+    begin
+      command = Cocaine::CommandLine.new(
+        "montage", "-geometry :geometry -tile :tile :files",
+        :geometry => "+#{border}+#{border}", :tile => "#{column}x#{row}", :files => (files += " #{out}")).command
+      `#{command.gsub(/'/, '')}`
+    rescue Cocaine::CommandNotFoundError => e
+      raise "Could not run the 'montage' command. Please install ImageMagick."
+    end
+
+  end
+end

data/lib/allthumbs/version.rb

@@ -0,0 +1,6 @@
+module Allthumbs
+  # We're doing this because we might write tests that deal
+  # with other versions of bundler and we are unsure how to
+  # handle this better.
+  VERSION = "0.0.1" unless defined?(::Bundler::VERSION)
+end

data/lib/tasks/allthumbs.rake

@@ -0,0 +1,2 @@
+namespace :allthumbs do
+end

data/test/allthumbs_test.rb

@@ -0,0 +1,46 @@
+require './test/helper'
+
+class AllthumbsTest < Test::Unit::TestCase
+  context "Testing montage creation" do
+    setup do
+      assert IMAGES.size == 12
+    end
+  end
+  should "generate a single 4 column (104x78) montage from 12 22px images with 2 pixel borders" do
+    Allthumbs.generate(IMAGES, TESTMONTAGE, { :column => 4, :border => 2 })
+    assert File.exists? TESTMONTAGE
+    assert dimensions(TESTMONTAGE) == ["104", "78", nil]
+  end
+  should "generate a single 3 column (90x120) montage from 12 22px images with 4 pixel borders" do
+    Allthumbs.generate(IMAGES, TESTMONTAGE, { :column => 3, :border => 4 })
+    assert File.exists? TESTMONTAGE
+    assert dimensions(TESTMONTAGE) == ["90", "120", nil]
+  end
+  should "raise an exception when bad image files are passed" do
+    assert_raise RuntimeError do
+      Allthumbs.generate('some/nonexistent/file.jpg', TESTMONTAGE, { :column => 3, :border => 4 })
+    end
+  end
+  should "raise an exception when bad column row values are passed" do
+    assert_raise RuntimeError do
+      Allthumbs.generate(IMAGES, TESTMONTAGE, { :column => 3, :row => 20, :border => 4 })
+    end
+  end
+end
+
+def dimensions file
+  file = file.path if file.respond_to? "path"
+  geometry = begin
+               Cocaine::CommandLine.new("identify", "-format %wx%h :file", :file => "#{file}[0]").run
+             rescue Cocaine::CommandNotFoundError => e
+               raise "Could not run the 'identify' command. Please install ImageMagick."
+             end
+  parse(geometry) || (raise "#{file} is not recognized by the 'identify' command.")
+end
+
+def parse string
+  if match = (string && string.match(/\b(\d*)x?(\d*)\b([\>\<\#\@\%^!])?/i))
+    return match[1,3]
+  end
+end
+

data/test/helper.rb

@@ -0,0 +1,21 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+require 'cocaine'
+
+begin
+  require 'ruby-debug'
+rescue LoadError => e
+  puts "debugger disabled"
+end
+
+ROOT = File.join(File.dirname(__FILE__), '..')
+$LOAD_PATH << File.join(ROOT, 'lib')
+$LOAD_PATH << File.join(ROOT, 'lib', 'allthumbs')
+
+require File.join(ROOT, 'lib', 'allthumbs.rb')
+
+FIXTURES_DIR = File.join(File.dirname(__FILE__), "fixtures")
+
+IMAGES = Dir::glob('test/images/*jpg').map { |f| f }.join(' ')
+TESTMONTAGE = 'test/tmp-montage.jpg'

metadata

@@ -0,0 +1,100 @@
+--- !ruby/object:Gem::Specification 
+name: allthumbs
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- John Bresnik
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-06-20 00:00:00 Z
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Generate single image from tons of thumbails
+email: jbresnik@barbariangroup.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- README.rdoc
+- LICENSE
+- Rakefile
+- init.rb
+- lib/allthumbs/version.rb
+- lib/allthumbs.rb
+- lib/tasks/allthumbs.rake
+- test/allthumbs_test.rb
+- test/helper.rb
+- test/images/00_avatar_tiny.jpg
+- test/images/bnjmn_red_hotel_tiny.jpg
+- test/images/hunter2_tiny.jpg
+- test/images/hunter_tiny.jpg
+- test/images/image1_tiny.jpg
+- test/images/lexy1_tiny.jpg
+- test/images/mypictr_last.fm_tiny.jpg
+- test/images/Photo_1_tiny.jpg
+- test/images/Photo_26_tiny.jpg
+- test/images/Photo_61_tiny.jpg
+- test/images/shelby_tiny.jpg
+- test/images/tbgmixer_fedora_tiny.jpg
+- test/tmp-montage.jpg
+homepage: https://github.com/brez/allthumbs
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+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: 
+- ImageMagick
+rubyforge_project: 
+rubygems_version: 1.8.5
+signing_key: 
+specification_version: 3
+summary: Generate single image from tons of thumbails
+test_files: []
+