thumbkit 0.0.2

data/.gitignore

@@ -0,0 +1,12 @@
+.DS_Store
+*.gem
+*.rbc
+.bundle
+.config
+Gemfile.lock
+coverage
+doc/
+pkg
+rdoc
+spec/reports
+tmp

data/Gemfile

@@ -0,0 +1,16 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in thumbkit.gemspec
+gemspec
+
+
+# Development tools
+gem 'rspec'
+
+gem 'guard'
+gem 'guard-rspec'
+gem 'guard-bundler'
+
+gem 'mini_magick'
+gem 'waveform', git: 'https://github.com/amiel/waveform', branch: 'thumbkit'
+gem 'oily_png'

data/Guardfile

@@ -0,0 +1,16 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+notification :off
+
+guard 'bundler' do
+  watch('Gemfile')
+  watch(/^.+\.gemspec/)
+end
+
+guard 'rspec', version: 2, cli: '--color -f doc', keep_failed: false do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/#{ m[1] }_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Amiel Martin
+
+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,246 @@
+# Thumbkit
+
+> it's like quicklook for carrierwave :)
+>
+> -- <cite>[Emmanuel Gomez][1]</cite>
+
+ [1]:https://github.com/emmanuel
+
+Thumbkit makes thumbnails from a variety of media types.
+Thumbkit is designed to work with carrierwave but does not require it.
+
+## Synopsis
+
+```ruby
+Thumbkit.new('path/to/audio.mp3').write_thumbnail # => 'path/to/audio.png'
+Thumbkit.new('path/to/text.txt').write_thumbnail  # => 'path/to/text.png'
+Thumbkit.new('path/to/image.jpg').write_thumbnail # => 'path/to/image.jpg'
+```
+
+See [Usage](#usage) below for more examples
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'thumbkit'
+    gem 'mini_magick' # For text or image thumbnails
+    gem 'waveform' # For audio thumbnails
+    gem 'oily_png' # Optional, for presumably faster audio thumbnails
+
+And then execute:
+
+    $ bundle
+
+Please see [Requirements](#requirements) for more information about each
+thumbnail type.
+
+
+## Requirements
+
+### Image thumbnails
+
+Thumbkit uses [MiniMagick](https://github.com/probablycorey/mini_magick) to
+resize and crop images.
+
+On OS X:
+
+    $ brew install imagemagick
+    $ gem install mini_magick
+
+### Text thumbnails
+
+Thumbkit uses [MiniMagick](https://github.com/probablycorey/mini_magick) to
+render text files.
+
+On OS X:
+
+    $ brew install imagemagick
+    $ gem install mini_magick
+
+### HTML thumbnails
+
+HTML thumbnails are not yet supported, but the plan is to use phantomjs to
+render html files.
+
+### Audio thumbnails
+
+Thumbkit uses the [waveform](https://github.com/benalavi/waveform) gem to render
+audio files. [waveform](https://github.com/benalavi/waveform) depends on
+libsndfile. **ffmpeg** is required in order to generate thumbnails from anything
+other than .wav files.
+
+See https://github.com/benalavi/waveform for more on requirements.
+
+NOTE: As of 0.0.3 waveform fails on mono files (benalavi/waveform#4,
+benalavi/waveform#5. I've forked and fixed (see benalavi/waveform#6). Until my
+fix gets merged in you can use https://github.com/amiel/waveform/tree/thumbkit.
+Like so:
+
+```ruby
+gem 'thumbkit'
+gem 'waveform', git: 'https://github.com/amiel/waveform', branch: 'thumbkit'
+gem 'oily_png' # Optional, for presumably faster audio thumbnails
+```
+
+## Usage
+
+Thumbkit takes a path to a file, and saves a thumbnail for that file regardless
+of type. Certain types require different gems, but none are dependencies so
+you'll have to install them yourself.
+
+All settings can be set globally. These are the defaults:
+
+### Configuration
+
+```ruby
+  Thumbkit.defaults = {
+    width: 200, height: 200,
+    gravity: 'Center',
+    colors: { foreground: '#888888', background: '#eeeeee' },
+    font: {
+      family: 'Arial-Regular',
+      pointsize: '18',
+      direction: :auto,
+    },
+  }
+```
+
+Setting `Thumbkit.defaults=` will deep merge. So setting one option is possible
+with:
+
+```ruby
+  Thumbkit.defaults = { colors: { foreground: '#FF69B4' } } # HOT PINK
+```
+
+#### Font options
+
+The list of fonts available to imagemagick can be found with
+`identify -list Font`
+
+#### Gravity Options
+
+A list of gravity options can be found with `identify -list Gravity`
+
+See http://www.imagemagick.org/script/command-line-options.php#gravity for more
+information.
+
+### Image thumbnails
+
+```ruby
+  Thumbkit.new('path/to/image.jpg').write_thumbnail # => 'path/to/image.jpg'
+```
+
+Will write a 60x60 cropped image to `path/to/image.jpg`.
+
+The format of the output file will depend on the extension of the output path
+and defaults to the same as the input file.
+
+### Text thumbnails
+
+```ruby
+  text = Thumbkit.new('path/to/text_file.txt')
+
+  text.write_thumbnail(nil, {
+    width: 200, height: 200,
+    colors: { foreground: '#663854' },
+    font: { pointsize: '18' },
+  }) # => 'path/to/text_file.png'
+```
+
+Will write a 200x200 cropped image to `path/to/text_file.png`.
+
+The format of output will depend on the extension of the output path provided
+but defaults to .png.
+
+#### RTL support
+
+```ruby
+  text = Thumbkit.new('path/to/text_file.txt')
+  text.write_thumbnail(nil, font: { direction: 'right-to-left' }) # Force RTL
+```
+
+`direction` options:
+
+* `nil`: don't specify the option to imagemagick (OS default)
+* `:auto`: try to detect. Currently, this switches to `'right-to-left'` if there
+  are *any* RTL characters in the input. This is the default.
+* `'right-to-left'`, `'left-to-right'`: force LTR or RTL
+
+### Audio thumbnails
+
+```ruby
+  audio = Thumbkit.new('path/to/audio.mp3')
+  audio.write_thumbnail('path/to/ouput.png', {
+    colors: { foreground: '#ffffff', background: '#000000' },
+  }) # => 'path/to/output.png'
+```
+
+Will write a 60x60 cropped image to `path/to/output.png`.
+
+Note that while imagemagick supports most color specification formats, waveform
+only takes 6 digit hex values. However, there is one special case for the symbol
+:transparent.
+
+Audio thumbnails only support PNG output. A png file will be created regardless
+of the extension of the output file provided.
+
+### Composite thumbnails
+
+NOT YET IMPLEMENTED
+
+```ruby
+  composite = Thumbkit.new(['path/to/audio.mp3', 'path/to/text_file.txt'])
+  composite.write_thumbnail('path/to/collection.png')
+```
+
+### CarrierWave usage
+
+NOT YET IMPLEMENTED
+
+```ruby
+  class MyUploader < CarrierWave::Uploader::Base
+    include CarrierWave::Thumbkit
+
+    version :thumbnail do
+      process :thumbkit => [200, 200, { colors: { foreground: '#cccccc' } }]
+    end
+  end
+```
+
+## Other plans
+
+* Accept a StringIO instead of a pathname
+* Maybe use filemagic if available
+* Processors:
+  * Composite
+  * HTML
+  * PDF
+  * Video
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Run the test suite to make sure all tests pass before you start (`guard`)
+4. Make your changes
+5. Run the test suite again to make sure you didn't break anything existing (`guard`)
+6. Commit your changes (`git commit -am 'Added some feature'`)
+7. Push to the branch (`git push origin my-new-feature`)
+8. Create new Pull Request
+
+## Testing
+
+Tests run in guard. If you don't like guard, a pull request on `Rakefile` would
+be welcome.
+
+Output files are placed in `spec/tmp` which is created automatically before each
+test run and deleted automatically afterward unless `spec/tmp/.keep` exists. If
+you would like to inspect the generated output files, create a file at
+`spec/tmp/.keep`:
+
+    $ mkdir spec/tmp; touch spec/tmp/.keep
+
+Many of the tests just verify that an image was created of the right type and
+size, but do not actually verify that they have the correct content so it is
+good to inspect the generated files.

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/thumbkit/options.rb

@@ -0,0 +1,15 @@
+require 'delegate'
+
+class Thumbkit::Options < DelegateClass(Hash)
+  @@merge_proc = proc { |key, left, right|
+    Hash === left && Hash === right ? left.merge(right, &@@merge_proc) : right
+  }
+
+  def merge(other)
+    Thumbkit::Options::new(__getobj__.merge(other, &@@merge_proc))
+  end
+
+  def +(other)
+    merge(other)
+  end
+end

data/lib/thumbkit/processor/audio.rb

@@ -0,0 +1,28 @@
+require 'waveform'
+
+class Thumbkit::Processor::Audio < Thumbkit::Processor
+
+  def determine_outfile
+    self.class.force_extension(path, 'png')
+  end
+
+  def write
+    Waveform.new(path).generate(outfile, build_options)
+
+    outfile
+  end
+
+  private
+
+  def build_options
+    {
+      force: true,
+      method: :rms, # Hard-coded for now.
+      width: options[:width],
+      height: options[:height],
+      color: options[:colors][:foreground],
+      background_color: options[:colors][:background],
+    }
+  end
+
+end

data/lib/thumbkit/processor/image.rb

@@ -0,0 +1,47 @@
+require 'mini_magick'
+
+class Thumbkit::Processor::Image < Thumbkit::Processor
+
+  def determine_outfile
+    @path
+  end
+
+  def write
+    resize_to_fill
+
+    outfile
+  end
+
+
+
+  private
+
+  def type
+    File.extname(outfile)[1..-1]
+  end
+
+
+  # Copied and adjusted from CarrierWave
+  def resize_to_fill
+    image = ::MiniMagick::Image.open(path)
+
+    cols, rows = image[:dimensions]
+    image.format type
+    image.combine_options do |cmd|
+      if options[:width] != cols || options[:height] != rows
+        scale = [options[:width]/cols.to_f, options[:height]/rows.to_f].max
+        cols = (scale * (cols + 0.5)).round
+        rows = (scale * (rows + 0.5)).round
+        cmd.resize "#{ cols }x#{ rows }"
+      end
+      cmd.gravity options[:gravity].to_s
+      cmd.background options[:colors][:background].to_s
+
+      if cols != options[:width] || rows != options[:height]
+        cmd.extent "#{ options[:width] }x#{ options[:height] }"
+      end
+    end
+
+    image.write(outfile)
+  end
+end

data/lib/thumbkit/processor/text.rb

@@ -0,0 +1,99 @@
+require 'mini_magick'
+
+# NOTES: For now, use reverse markdown for html
+#   https://github.com/xijo/reverse_markdown
+#   https://github.com/cousine/downmark_it
+class Thumbkit::Processor::Text < Thumbkit::Processor
+
+  def determine_outfile
+    self.class.force_extension(path, 'png')
+  end
+
+  def write
+    command = build_command
+    run(command)
+
+    outfile
+  end
+
+  private
+
+
+  def command_builder
+    MiniMagick::CommandBuilder.new('mogrify')
+  end
+
+  # Regexes copies from www.frequency-decoder.com/demo/detect-text-direction/
+  # and https://github.com/geeksoflondon/grid4rails/issues/120
+  #
+  # Currently, this detects the direction by checking if *any* character in the
+  # input is an RTL character.
+  # TODO: Maybe check for a percentage of RTL characters?
+  def direction
+    # For future reference
+    # Hebrew - U+05D0 to U+05EA, U+05F0 to U+05F2, U+05BE, U+05C0, U+05C3, U+05F3, U+05F4, U+05B0 to U+05C4, U+0591 to U+05AF.
+    # Arabic - U+0600 to U+06FF, U+0750 to U+077F, U+FB50 to U+FDFF, U+FE70 to U+FEFF, U+10E60 to U+10E7F.
+    # ltrChars            = 'A-Za-z\u00C0-\u00D6\u00D8-\u00F6\u00F8-\u02B8\u0300-\u0590\u0800-\u1FFF'+'\u2C00-\uFB1C\uFDFE-\uFE6F\uFEFD-\uFFFF',
+    # rtlChars            = '\u0591-\u07FF\uFB1D-\uFDFD\uFE70-\uFEFC',
+
+    dir = options[:font][:direction]
+    if dir == :auto
+      if /[\u0591-\u07FF\uFB1D-\uFDFD\uFE70-\uFEFC]/.match(IO.read(path))
+        'right-to-left'
+      else
+        'left-to-right'
+      end
+    else
+      dir
+    end
+  end
+
+  # Example generated command
+  # mogrify -density "288" -background "#ccc" -fill "#333" -pointsize "18" -antialias -font "Helvetica" -format png -trim -resize "%25" +repage -crop "200x200+10+10" +repage -write test.png test.txt
+  def build_command
+    command_builder.tap do |mogrify|
+      mogrify.density((72 * 4).to_s)
+      mogrify.background options[:colors][:background].to_s
+      mogrify.fill options[:colors][:foreground].to_s
+      mogrify.pointsize options[:font][:size].to_s
+      mogrify.antialias
+      mogrify.font options[:font][:family]
+      mogrify.direction direction if direction
+      mogrify.gravity options[:gravity].to_s
+      # While we convert to png, imagemagick will still output the format given
+      # by the extension. This allows users to costumize the output with the
+      # outfile extension.
+      mogrify << '-format png'
+      mogrify.trim
+      mogrify.resize '25%'
+      mogrify << '+repage'
+      mogrify.crop "#{ options[:width] }x#{ options[:height] }+0+0"
+      mogrify.extent "#{ options[:width] }x#{ options[:height] }"
+      mogrify << '+repage'
+      mogrify.write outfile
+      mogrify << "label:@#{path}"
+    end
+  end
+
+  # Mostly copied from MiniMagick
+  def run(command_builder)
+    command = command_builder.command
+
+    sub = Subexec.run(command, timeout: MiniMagick.timeout)
+
+    if sub.exitstatus != 0
+
+      # Raise the appropriate error
+      if sub.output =~ /no decode delegate/i || sub.output =~ /did not return an image/i
+        raise MiniMagick::Invalid, sub.output
+      else
+        # TODO: should we do something different if the command times out ...?
+        # its definitely better for logging.. otherwise we dont really know
+        raise MiniMagick::Error, "Command (#{command.inspect.gsub("\\", "")}) failed: #{{:status_code => sub.exitstatus, :output => sub.output}.inspect}"
+      end
+    else
+      sub.output
+    end
+  end
+
+end

data/lib/thumbkit/processor.rb

@@ -0,0 +1,45 @@
+class Thumbkit::Processor
+  autoload :Text, 'thumbkit/processor/text'
+  autoload :Audio, 'thumbkit/processor/audio'
+  autoload :Image, 'thumbkit/processor/image'
+
+  def self.processors
+    @processors ||= {
+      'png' => 'Image',
+      'jpg' => 'Image',
+      'txt' => 'Text',
+      'md'  => 'Text',
+      'mp3' => 'Audio',
+      'wav' => 'Audio',
+      'm4a' => 'Audio',
+    }
+  end
+
+  def self.processor_for(extension)
+    if (class_name = self.processors[extension])
+      self.const_get(class_name)
+    end
+  end
+
+
+  def self.force_extension(filename, extension)
+    dir, fname = File.split(filename)
+    File.join(dir, "#{ File.basename(fname, '.*') }.#{ extension }")
+  end
+
+  attr_accessor :path, :outfile, :options
+  def initialize(path, outfile, options)
+    @path = path
+    @outfile = outfile || determine_outfile
+    @options = Thumbkit.defaults + options
+  end
+
+  def determine_outfile
+    raise NotImplementedError, 'Cannot determine an output file'
+  end
+
+  def write
+    raise NotImplementedError
+  end
+
+end

data/lib/thumbkit/version.rb

@@ -0,0 +1,3 @@
+class Thumbkit
+  VERSION = "0.0.2"
+end

data/lib/thumbkit.rb

@@ -0,0 +1,42 @@
+require "thumbkit/version"
+
+class Thumbkit
+  autoload :Processor, 'thumbkit/processor'
+  autoload :Options, 'thumbkit/options'
+
+  attr_accessor :path, :filename, :type
+
+  def self.defaults
+    @defaults ||= Thumbkit::Options.new({
+      width: 200,
+      height: 200,
+      # Try `identify -list Gravity` for a list of available options
+      gravity: 'Center',
+      colors: {
+        # Colors must be 6-digit hex
+        background: '#eeeeee',
+        foreground: '#888888',
+      },
+      font: {
+        # Try `identify -list Font` for available font options
+        family: 'Arial-Regular',
+        size: '18', # In points
+        direction: :auto, # nil, :auto, 'right-to-left', or 'left-to-right'
+      },
+    })
+  end
+
+  def initialize(path)
+    @path = File.expand_path(path)
+    @filename = File.basename(@path)
+    @type = File.extname(filename)[1..-1]
+  end
+
+  def processor
+    @processor ||= Thumbkit::Processor.processor_for(type)
+  end
+
+  def write_thumbnail(outfile = nil, options = {})
+    processor.new(path, outfile, options).write
+  end
+end

data/spec/fixtures/arabic.txt

@@ -0,0 +1,7 @@
+أَبْجَدِيَّة عَرَبِيَّة‎
+
+ا    ب    ت    ث    ج    ح
+خ    د    ذ    ر    ز    س
+ش    ص    ض    ط    ظ    ع
+غ    ف    ق    ك    ل
+م    ن    ه    و    ي

data/spec/fixtures/greek.txt

@@ -0,0 +1,14 @@
+Capital letters
+Α Β Γ Δ Ε Ζ Η Θ Ι Κ Λ Μ Ν Ξ Ο Π Ρ Σ Τ Υ Φ Χ Ψ Ω
+Capital letters with tonos
+Ά   Έ   Ή   Ί   Ό   Ύ   Ώ
+Capital letters with dialytika
+Ϊ   Ϋ
+Small letters
+α β γ δ ε ζ η θ ι κ λ μ ν ξ ο π ρ σς τ υ φ χ ψ ω
+Small letters with tonos
+ά   έ   ή   ί   ό   ύ   ώ
+Small letters with dialytika
+ϊ   ϋ
+Small letters with dialytika and tonos
+ΐ   ΰ

data/spec/fixtures/hebrew.txt

@@ -0,0 +1,17 @@
+Hebrew
+
+Hebrew alphabet
+’ b g d h w z H T y kk l mm nn s ‘ pp cc q r š ś t
+  א ב ג ד ה ו ז ח ט י כך ל מם נן ס ע פף צץ ק ר שׁ שׂ ת
+Letters with dagesh or mapiq
+’ b g d h w z   T y kk l m  n  s   pp c  q r š ś t
+  אּ בּ גּ דּ הּ וּ זּ   טּ יּ כּךּ לּ מּ  נּ  סּ   פּףּ צּ  קּ רּ שּׁ שּׂ תּ
+Yiddish digraphs
+ww   wy   yy
+  װ   ױ   ײ
+Letters with rafeh
+v   x   f
+  בֿ   כֿ   פֿ
+Vowels with points
+a   å   o   u   i   ai
+  אַ   אָ   וֹ   וּ   יִ   ײַ

data/spec/fixtures/text_file.txt

@@ -0,0 +1,15 @@
+An Example Text File
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod
+tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,
+quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo
+consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse
+cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
+proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
+
+Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod
+tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,
+quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo
+consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse
+cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
+proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

data/spec/spec_helper.rb

@@ -0,0 +1,51 @@
+require 'thumbkit'
+require 'fileutils'
+
+module Helpers
+
+  def path_to_fixture(fixture_name)
+    Pathname.new("spec/fixtures").join(fixture_name).expand_path
+  end
+
+  def tmp_path
+    Pathname.new("spec/tmp")
+  end
+
+  def path_for_output(outfile = '')
+    tmp_path.join(outfile).expand_path
+  end
+end
+
+module ImageMacros
+  def its_size_should_be(size)
+    it "its size should be #{ size }" do
+      r = `identify -ping -quiet -format "%wx%h" "#{subject}"`.chomp
+      r.should == size
+    end
+  end
+
+  def its_mimetype_should_be(mime)
+    it "its mime type should be #{ mime }" do
+      m = `file --mime-type -n -N "#{ subject }"|cut -d' ' -f2`.chomp
+      m.should == mime
+    end
+  end
+end
+
+RSpec.configure do |config|
+  config.extend ImageMacros
+  config.include Helpers
+
+  def mkdir_safe(dir)
+    Dir.mkdir(dir)
+  rescue Errno::EEXIST
+    # Great, it's already there.
+  end
+
+  config.around(:each) do |example|
+    mkdir_safe tmp_path.to_s
+    example.run
+    FileUtils.rm_rf(tmp_path.to_s) unless File.exist?(tmp_path.join('.keep').to_s)
+  end
+end
+

data/spec/thumbkit/options_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+describe Thumbkit::Options do
+  describe '#merge' do
+    it "does a deep merge" do
+      h1 = { x: { y: [4, 5, 6], z: [7, 8, 9], a: 'abar' } }
+      h2 = { x: { y: [1, 2, 3], z: 'xyz', b: { c: 'd' } } }
+      defaults = Thumbkit::Options.new(h1)
+      defaults.merge(h2).should == {
+        x: {
+          y: [1, 2, 3],
+          z: 'xyz',
+          a: 'abar',
+          b: { c: 'd' },
+        }
+      }
+    end
+
+    it "does an even deeper merge" do
+      # NOTE: These options resemble, but don't actually reflect the available
+      #   options for Thumbkit.
+      h1 = { colors: { background: 'blue' }, font: { family: { name: 'Helvetica', weight: 'bold' } } }
+      h2 = { colors: { foreground: 'black' }, font: { family: { weight: 'light', transform: 'small-caps' } } }
+      defaults = Thumbkit::Options.new(h1)
+      defaults.merge(h2).should == {
+        colors: {
+          background: 'blue',
+          foreground: 'black',
+        },
+        font: {
+          family: {
+            name: 'Helvetica',
+            weight: 'light',
+            transform: 'small-caps',
+          }
+        }
+      }
+    end
+  end
+end

data/spec/thumbkit/processor/audio_spec.rb

@@ -0,0 +1,57 @@
+require 'spec_helper'
+
+describe Thumbkit::Processor::Audio do
+
+  let(:fixture) { '16Hz-20kHz-Exp-1f-5sec.mp3' }
+  let(:path) { File.expand_path(path_to_fixture(fixture)) }
+  let(:outfile) { nil }
+  let(:options) { {} }
+  let(:processor) { Thumbkit::Processor::Audio.new(path, outfile, options) }
+  subject { processor }
+
+  its(:path) { should == path }
+
+  describe '#auto_outflie' do
+    subject { processor.outfile }
+    context 'when nothing specified' do
+      it { should == File.expand_path(path_to_fixture('16Hz-20kHz-Exp-1f-5sec.png')) }
+    end
+
+    # context 'with an extensionless outfile' do
+    #   let(:outfile) { 'foo.' }
+    #   it { should == 'foo.png' }
+    # end
+
+    # Not sure what to do in this case. Waveform just outputs a png file no
+    # matter what...
+    #
+    # context 'with a jpg specified' do
+    #   let(:outfile) { path_for_output('audio-test.jpg').to_s }
+    #   before { processor.write }
+    #   it { should == path_for_output('audio_test.jpg').to_s }
+    # end
+  end
+
+  describe '#write' do
+    let(:outfile) { path_for_output('audio-test.png').to_s }
+    subject { processor.write }
+
+    it 'returns the path of the outfile' do
+      subject.should == outfile
+    end
+
+    it 'writes a file' do
+      File.should exist(subject)
+    end
+
+    its_size_should_be('200x200')
+
+    context 'with size settings' do
+      let(:outfile) { path_for_output('audio-test-300x250.png').to_s }
+      # Let's change a few settings for manual inspection
+      let(:options) { { width: 300, height: 250, colors: { background: :transparent, foreground: '#ffeecc' } } }
+
+      its_size_should_be('300x250')
+    end
+  end
+end

data/spec/thumbkit/processor/image_spec.rb

@@ -0,0 +1,81 @@
+require 'spec_helper'
+
+describe Thumbkit::Processor::Image do
+
+  let(:fixture) { 'png_file.png' }
+  let(:path) { File.expand_path(path_to_fixture(fixture)) }
+  let(:outfile) { nil }
+  let(:options) { {} }
+  let(:processor) { Thumbkit::Processor::Image.new(path, outfile, options) }
+  subject { processor }
+
+  its(:path) { should == path }
+
+  describe '#auto_outflie' do
+    subject { processor.outfile }
+    context 'when nothing specified' do
+      it { should == File.expand_path(path_to_fixture('png_file.png')) }
+
+      context 'when the fixture is a jpeg' do
+        let(:fixture) { 'jpg_file.jpg' }
+        it { should == File.expand_path(path_to_fixture('jpg_file.jpg')) }
+      end
+    end
+
+    # context 'with an extensionless outfile' do
+    #   let(:outfile) { 'foo.' }
+    #   it { should == 'foo.png' }
+    # end
+  end
+
+  describe '#write' do
+    let(:outfile) { path_for_output('png_file.png').to_s }
+    subject { processor.write }
+
+    it 'returns the path of the outfile' do
+      subject.should == outfile
+    end
+
+    it 'writes a file' do
+      File.should exist(subject)
+    end
+
+    its_size_should_be('200x200')
+    its_mimetype_should_be('image/png')
+
+    context 'with size settings' do
+      let(:outfile) { path_for_output('resize_test_300x250.png').to_s }
+      # Let's change a few settings for manual inspection
+      let(:options) { { width: 300, height: 250 } }
+
+      its_size_should_be('300x250')
+      its_mimetype_should_be('image/png')
+    end
+
+    context 'with size and gravity settings' do
+      let(:outfile) { path_for_output('resize_test_southwest_300x100.png').to_s }
+      # Let's change a few settings for manual inspection
+      let(:options) { { width: 300, height: 100, gravity: 'SouthWest' } }
+
+      its_size_should_be('300x100')
+      its_mimetype_should_be('image/png')
+    end
+
+
+   context 'with size settings larger than the image' do
+      let(:outfile) { path_for_output('resize_test_600x600.png').to_s }
+      # Let's change a few settings for manual inspection
+      let(:options) { { width: 600, height: 600 } }
+
+      its_size_should_be('600x600')
+      its_mimetype_should_be('image/png')
+    end
+
+    context 'with a jpg file' do
+      let(:outfile) { path_for_output('jpg_file.jpg').to_s }
+      it { should == path_for_output('jpg_file.jpg').to_s }
+      its_size_should_be('200x200')
+      its_mimetype_should_be('image/jpeg')
+    end
+  end
+end

data/spec/thumbkit/processor/text_spec.rb

@@ -0,0 +1,114 @@
+require 'spec_helper'
+
+describe Thumbkit::Processor::Text do
+
+  let(:fixture) { 'text_file.txt' }
+  let(:path) { File.expand_path(path_to_fixture(fixture)) }
+  let(:outfile) { nil }
+  let(:options) { {} }
+  let(:processor) { Thumbkit::Processor::Text.new(path, outfile, options) }
+  subject { processor }
+
+  its(:path) { should == path }
+
+
+  describe '#auto_outflie' do
+    subject { processor.outfile }
+    context 'when nothing specified' do
+      it { should == File.expand_path(path_to_fixture('text_file.png')) }
+    end
+
+    # context 'with an extensionless outfile' do
+    #   let(:outfile) { 'foo.' }
+    #   it { should == 'foo.png' }
+    # end
+  end
+
+  describe '#write' do
+    let(:outfile) { path_for_output('text-test.png').to_s }
+    subject { processor.write }
+
+    it 'returns the path of the outfile' do
+      subject.should == outfile
+    end
+
+    it 'returns the name of the outfile' do
+      File.basename(subject).should == 'text-test.png'
+    end
+
+    it 'writes a file' do
+      File.should exist(subject)
+    end
+
+    its_size_should_be('200x200')
+    its_mimetype_should_be('image/png')
+
+    context 'with size settings' do
+      let(:outfile) { path_for_output('text-test-300x250.png').to_s }
+      # Let's change a few settings for manual inspection
+      let(:options) { { width: 300, height: 250, colors: { background: :transparent, foreground: '#334455' } } }
+
+      its_size_should_be('300x250')
+      its_mimetype_should_be('image/png')
+      # Manually check the file to verify colors
+    end
+
+    context 'with gravity settings' do
+      let(:outfile) { path_for_output('text-test-northeast-150x250.png').to_s }
+      # Let's change a few settings for manual inspection
+      let(:options) { {
+        width: 150, height: 250, gravity: 'NorthEast',
+        colors: { background: :transparent, foreground: '#334455' }
+      } }
+
+      its_size_should_be('150x250')
+      its_mimetype_should_be('image/png')
+      # Manually check the file to verify colors and gravity
+    end
+
+    context 'with some greek letters' do
+      let(:fixture) { 'greek.txt' }
+      let(:outfile) { path_for_output('greek.png').to_s }
+      it('writes a file') { File.should exist(subject) }
+      it('autodetects left-to-right') { processor.__send__(:direction).should == 'left-to-right' }
+      its_size_should_be('200x200')
+      its_mimetype_should_be('image/png')
+      # Manually check the file to verify unicode stuff worked
+    end
+
+    context 'with an arabic file' do
+      let(:options) { { font: { direction: :auto } } }
+      let(:fixture) { 'arabic.txt' }
+      let(:outfile) { path_for_output('arabic.png').to_s }
+      it('writes a file') { File.should exist(subject) }
+      it('autodetects right-to-left') { processor.__send__(:direction).should == 'right-to-left' }
+      its_size_should_be('200x200')
+      its_mimetype_should_be('image/png')
+      # Manually check the file to verify unicode stuff and right-to-left worked
+    end
+
+    context 'with an hebrew file' do
+      let(:options) { { font: { direction: 'right-to-left', size: '12' }, width: 400 } }
+      let(:fixture) { 'hebrew.txt' }
+      let(:outfile) { path_for_output('hebrew.png').to_s }
+      it('writes a file') { File.should exist(subject) }
+      it('is right-to-left') { processor.__send__(:direction).should == 'right-to-left' }
+      its_size_should_be('400x200')
+      its_mimetype_should_be('image/png')
+      # Manually check the file to verify unicode stuff and right-to-left worked
+    end
+
+
+    context 'with an arabic file to output to jpg' do
+      let(:options) { { width: 600, height: 400 } }
+      let(:fixture) { 'arabic.txt' }
+      let(:outfile) { path_for_output('arabic.jpg').to_s }
+      it('writes a file') { File.should exist(subject) }
+      it('autodetects right-to-left') { processor.__send__(:direction).should == 'right-to-left' }
+      its_size_should_be('600x400')
+      its_mimetype_should_be('image/jpeg')
+      # Manually check the file to verify unicode stuff and right-to-left worked
+    end
+
+  end
+end

data/spec/thumbkit/processor_spec.rb

@@ -0,0 +1,47 @@
+require 'spec_helper'
+
+describe Thumbkit::Processor do
+  describe '.processor_for' do
+    subject { Thumbkit::Processor.processor_for(extension) }
+    context 'for a .txt' do
+      let(:extension) { 'txt' }
+      it { should == Thumbkit::Processor::Text }
+    end
+
+    context 'for a .mp3' do
+      let(:extension) { 'mp3' }
+      it { should == Thumbkit::Processor::Audio }
+    end
+  end
+
+  describe '.force_extension' do
+    let(:extension) { 'png' }
+    subject { Thumbkit::Processor.force_extension path, extension }
+    context 'given an mp3 file' do
+      let(:path) { 'foo/bar/blah.mp3' }
+      it { should == 'foo/bar/blah.png' }
+    end
+  end
+
+  describe '#initialize' do
+    let(:options) { {} }
+    subject { Thumbkit::Processor.new('infile.png', 'outfile.png', options) }
+
+    context 'with no options' do
+      its(:options) { should == Thumbkit.defaults }
+    end
+
+    context 'with some overrides' do
+      let(:options) { { width: 250, height: 250 } }
+
+      it 'overrides the options' do
+        subject.options[:width].should == 250
+        subject.options[:height].should == 250
+      end
+
+      it 'but leaves others' do
+        subject.options[:colors].should == Thumbkit.defaults[:colors]
+      end
+    end
+  end
+end

data/spec/thumbkit_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe Thumbkit do
+  context 'a .txt file' do
+    subject { Thumbkit.new path_to_fixture('text_file.txt') }
+
+    its(:filename) { should == 'text_file.txt' }
+    its(:path) { should == File.expand_path(path_to_fixture('text_file.txt')) }
+    its(:processor) { should == Thumbkit::Processor::Text }
+    its(:type) { should == 'txt' }
+  end
+
+  context 'with a .mp3 file' do
+    subject { Thumbkit.new path_to_fixture('16Hz-20kHz-Exp-1f-5sec.mp3') }
+
+    its(:filename) { should == '16Hz-20kHz-Exp-1f-5sec.mp3' }
+    its(:path) { should == File.expand_path(path_to_fixture('16Hz-20kHz-Exp-1f-5sec.mp3')) }
+    its(:processor) { should == Thumbkit::Processor::Audio }
+    its(:type) { should == 'mp3' }
+  end
+end
+
+
+describe Thumbkit, '.defaults' do
+  subject { Thumbkit.defaults }
+
+  it 'returns defaults for colors' do
+    subject.should have_key(:colors)
+  end
+
+  it 'returns defaults for font' do
+    subject.should have_key(:font)
+  end
+end

data/thumbkit.gemspec

@@ -0,0 +1,18 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/thumbkit/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Amiel Martin"]
+  gem.email         = ["amiel@carnesmedia.com"]
+  gem.description   = %q{Thumbkit makes thumbnails!}
+  gem.summary       = %q{Thumbkit makes thumbnails from a variety of media types. Planned: Audio, Text, Image, and Video.}
+  gem.homepage      = "http://github.com/carnesmedia/thumbkit"
+
+  # TODO: Remove dependency on git
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "thumbkit"
+  gem.require_paths = ["lib"]
+  gem.version       = Thumbkit::VERSION
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification
+name: thumbkit
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+  prerelease: 
+platform: ruby
+authors:
+- Amiel Martin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-01 00:00:00.000000000 Z
+dependencies: []
+description: Thumbkit makes thumbnails!
+email:
+- amiel@carnesmedia.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Guardfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/thumbkit.rb
+- lib/thumbkit/options.rb
+- lib/thumbkit/processor.rb
+- lib/thumbkit/processor/audio.rb
+- lib/thumbkit/processor/image.rb
+- lib/thumbkit/processor/text.rb
+- lib/thumbkit/version.rb
+- spec/fixtures/16Hz-20kHz-Exp-1f-5sec.mp3
+- spec/fixtures/arabic.txt
+- spec/fixtures/greek.txt
+- spec/fixtures/hebrew.txt
+- spec/fixtures/jpg_file.jpg
+- spec/fixtures/png_file.png
+- spec/fixtures/text_file.txt
+- spec/spec_helper.rb
+- spec/thumbkit/options_spec.rb
+- spec/thumbkit/processor/audio_spec.rb
+- spec/thumbkit/processor/image_spec.rb
+- spec/thumbkit/processor/text_spec.rb
+- spec/thumbkit/processor_spec.rb
+- spec/thumbkit_spec.rb
+- thumbkit.gemspec
+homepage: http://github.com/carnesmedia/thumbkit
+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: 
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: ! 'Thumbkit makes thumbnails from a variety of media types. Planned: Audio,
+  Text, Image, and Video.'
+test_files:
+- spec/fixtures/16Hz-20kHz-Exp-1f-5sec.mp3
+- spec/fixtures/arabic.txt
+- spec/fixtures/greek.txt
+- spec/fixtures/hebrew.txt
+- spec/fixtures/jpg_file.jpg
+- spec/fixtures/png_file.png
+- spec/fixtures/text_file.txt
+- spec/spec_helper.rb
+- spec/thumbkit/options_spec.rb
+- spec/thumbkit/processor/audio_spec.rb
+- spec/thumbkit/processor/image_spec.rb
+- spec/thumbkit/processor/text_spec.rb
+- spec/thumbkit/processor_spec.rb
+- spec/thumbkit_spec.rb
+has_rdoc: