thingfish-processor-image 0.1.0.pre20161114102625

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 94cec81297dc83ba31fc6dfcf4b258688c4b232c
+  data.tar.gz: 5906271b9d85a5bc5f7da0a55f553d8e4ede3310
+SHA512:
+  metadata.gz: 74ad63442c9b7cb228c955f172ded4091cf25a1267581d323f9ad8b9a526ce37eb546a81fb0c3d50c18ae03dfe4749dcc26ecfe85897734cdd7140da3f6ac6d5
+  data.tar.gz: 89fd3b8a06e6bce83d42238472dad1b503863f8676579e3d2561aa62c59b3e4937a889c5ebe79ae95180cc89598d0f249babb1b60e13e5219b2329962b7dcafc

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+README.md
+ChangeLog.md
+
+LICENSE.txt

data/.editorconfig

@@ -0,0 +1,14 @@
+# http://EditorConfig.org
+
+# top-most EditorConfig file
+root = true
+
+# Unix-style newlines with a newline ending every file
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+# Tab indentation
+[**.*]
+indent_style = tab
+

data/.rdoc_options

@@ -0,0 +1,16 @@
+--- !ruby/object:RDoc::Options
+encoding: UTF-8
+static_path: []
+rdoc_include:
+  - .
+charset: UTF-8
+exclude: 
+hyperlink_all: false
+line_numbers: false
+main_page: README.md
+markup: markdown
+show_hash: false
+tab_width: 8
+title: Thingfish-Processor-Image Documentation
+visibility: :protected
+webcvs:

data/.simplecov

@@ -0,0 +1,9 @@
+# Simplecov config
+
+SimpleCov.start do
+	add_filter 'spec'
+	add_filter 'integration'
+	add_group "Needing tests" do |file|
+		file.covered_percent < 90
+	end
+end

data/ChangeLog

@@ -0,0 +1,24 @@
+2016-11-14  Michael Granger  <ged@FaerieMUD.org>
+
+	* History.md, README.md, Rakefile, lib/thingfish/processor/image.rb,
+	thingfish-processor-image.gemspec:
+	Fix up the README, Rakefile.
+	[e04ece44aa56] [tip]
+
+2016-11-13  Michael Granger  <ged@FaerieMUD.org>
+
+	* thingfish-processor-image.gemspec:
+	Add the gemspec
+	[a43952fd8558] [github/master]
+
+	* .hgignore, Manifest.txt, Rakefile:
+	Update manifest, specify minimum version of Mongrel2
+	[8f7523aa9de2]
+
+	* .document, .editorconfig, .gems, .hgignore, .pryrc, .rdoc_options,
+	.ruby-gemset, .ruby-version, .simplecov, Gemfile, History.md,
+	LICENSE.txt, Manifest.txt, README.md, Rakefile, certs/ged.pem,
+	lib/thingfish/processor/image.rb, spec/data/skunks.jpg,
+	spec/spec_helper.rb, spec/thingfish/processor/image_spec.rb:
+	Exported from Angelfish
+	[3995d4e06f28]

data/History.md

@@ -0,0 +1,4 @@
+## v0.1.0 [YYYY-MM-DD] Michael Granger <ged@FaerieMUD.org>
+
+Initial release.
+

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2016 Michael Granger
+
+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/Manifest.txt

@@ -0,0 +1,14 @@
+.document
+.editorconfig
+.rdoc_options
+.simplecov
+ChangeLog
+History.md
+LICENSE.txt
+Manifest.txt
+README.md
+Rakefile
+lib/thingfish/processor/image.rb
+spec/data/skunks.jpg
+spec/spec_helper.rb
+spec/thingfish/processor/image_spec.rb

data/README.md

@@ -0,0 +1,101 @@
+# Thingfish-Processor-Image
+
+home
+: http://deveiate.org/projects/Thingfish-Processor-Image
+
+code
+: http://bitbucket.org/ged/Thingfish-Processor-Image
+
+github
+: https://github.com/ged/thingfish-processor-image
+
+docs
+: http://deveiate.org/code/thingfish-processor-image
+
+
+## Description
+
+This is a basic image-processor plugin for the Thingfish digital asset manager.
+It extracts image-related metadata from uploaded media files, and generates one
+or more thumbnail images as related resources.
+
+
+## Authors
+
+* Michael Granger <ged@FaerieMUD.org>
+
+
+## Installation
+
+This plugin relies on [ImageMagick](http://www.imagemagick.org/), so you'll
+need to have that installed as well as any `-dev` dependencies appropriate for
+your system.
+
+One you've done that:
+
+    $ gem install thingfish-processor-image
+
+
+##  Usage
+
+As with Thingfish itself, this plugin uses
+Configurability[https://rubygems.org/gems/configurability] to modify default
+behaviors.
+
+Here's an example configuration file that enables this plugin.
+
+    --
+    thingfish:
+      processors:
+        - image
+    
+    images:
+      thumbnail_dimensions: 150x150
+
+
+
+## Contributing
+
+You can check out the current development source with Mercurial via its
+{project page}[http://bitbucket.org/ged/thingfish-processor-image]. Or if you prefer Git, via 
+{its Github mirror}[https://github.com/ged/thingfish-processor-image].
+
+After checking out the source, run:
+
+    $ rake newb
+
+This task will install any missing dependencies, run the tests/specs,
+and generate the API documentation.
+
+
+## License
+
+Copyright (c) 2016, Michael Granger
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice,
+  this list of conditions and the following disclaimer.
+
+* Redistributions in binary form must reproduce the above copyright notice,
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+* Neither the name of the author/s, nor the names of the project's
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+

data/Rakefile

@@ -0,0 +1,101 @@
+#!/usr/bin/env rake
+
+begin
+	require 'hoe'
+rescue LoadError
+	abort "This Rakefile requires hoe (gem install hoe)"
+end
+
+GEMSPEC = 'thingfish-processor-image.gemspec'
+
+
+Hoe.plugin :mercurial
+Hoe.plugin :signing
+Hoe.plugin :deveiate
+
+Hoe.plugins.delete :rubyforge
+Hoe.plugins.delete :gemcutter # Remove for public gems
+
+hoespec = Hoe.spec 'thingfish-processor-image' do |spec|
+	spec.readme_file = 'README.md'
+	spec.history_file = 'History.md'
+	spec.extra_rdoc_files = FileList[ '*.rdoc', '*.md' ]
+	spec.urls = {
+		home:   'https://bitbucket.org/ged/thingfish-processor-image',
+		code:   'https://bitbucket.org/ged/thingfish-processor-image',
+		docs:   'https://deveiate.org/code/thingfish-processor-image',
+		github: 'https://github.com/ged/thingfish-processor-image',
+	}
+
+	spec.extra_rdoc_files = FileList[ '*.rdoc', '*.md' ]
+	spec.license 'BSD-3-Clause'
+
+	spec.developer 'Michael Granger', 'ged@FaerieMUD.org'
+
+	spec.dependency 'mongrel2',    '>= 0.46'
+	spec.dependency 'thingfish',   '~> 0.5'
+	spec.dependency 'loggability', '~> 0.11'
+	spec.dependency 'rmagick',     '~> 2.16'
+
+	spec.dependency 'hoe-deveiate',            '~> 0.3', :developer
+	spec.dependency 'simplecov',               '~> 0.7', :developer
+	spec.dependency 'rdoc-generator-fivefish', '~> 0.1', :developer
+
+	spec.require_ruby_version( '>=2.3.1' )
+	spec.hg_sign_tags = true if spec.respond_to?( :hg_sign_tags= )
+	spec.check_history_on_release = true if spec.respond_to?( :check_history_on_release= )
+
+	self.rdoc_locations << "deveiate:/usr/local/www/public/code/#{remote_rdoc_dir}"
+end
+
+
+ENV['VERSION'] ||= hoespec.spec.version.to_s
+
+# Run the tests before checking in
+task 'hg:precheckin' => [ :check_history, :check_manifest, :gemspec, :spec ]
+
+task :test => :spec
+
+# Rebuild the ChangeLog immediately before release
+task :prerelease => 'ChangeLog'
+CLOBBER.include( 'ChangeLog' )
+
+desc "Build a coverage report"
+task :coverage do
+	ENV["COVERAGE"] = 'yes'
+	Rake::Task[:spec].invoke
+end
+CLOBBER.include( 'coverage' )
+
+
+# Use the fivefish formatter for docs generated from development checkout
+if File.directory?( '.hg' )
+	require 'rdoc/task'
+
+	Rake::Task[ 'docs' ].clear
+	RDoc::Task.new( 'docs' ) do |rdoc|
+	    rdoc.main = "README.rdoc"
+		rdoc.markup = 'markdown'
+	    rdoc.rdoc_files.include( "*.rdoc", "ChangeLog", "lib/**/*.rb" )
+	    rdoc.generator = :fivefish
+		rdoc.title = 'Thingfish-Processor-Image'
+	    rdoc.rdoc_dir = 'doc'
+	end
+end
+
+task :gemspec => GEMSPEC
+file GEMSPEC => __FILE__
+task GEMSPEC do |task|
+	spec = $hoespec.spec
+	spec.files.delete( '.gemtest' )
+	spec.signing_key = nil
+	spec.cert_chain = Dir.glob( 'certs/*.pem' )
+	spec.version = "#{spec.version.bump}.0.pre#{Time.now.strftime("%Y%m%d%H%M%S")}"
+	File.open( task.name, 'w' ) do |fh|
+		fh.write( spec.to_ruby )
+	end
+end
+CLOBBER.include( GEMSPEC.to_s )
+
+task :default => :gemspec
+

data/lib/thingfish/processor/image.rb

@@ -0,0 +1,322 @@
+# -*- ruby -*-
+#encoding: utf-8
+
+require 'rmagick'
+
+require 'strelka'
+require 'strelka/httprequest/acceptparams'
+
+require 'thingfish'
+require 'thingfish/processor'
+
+
+# Image processor plugin for Thingfish
+class Thingfish::Processor::Image < Thingfish::Processor
+	extend Loggability,
+	       Configurability,
+	       Strelka::MethodUtilities
+
+
+	# Package version
+	VERSION = '0.1.0'
+
+	# Version control revision
+	REVISION = %q$Revision: e04ece44aa56 $
+
+
+	# Loggability API -- log to the :angelfish logger
+	log_to :thingfish
+
+	# Configurability API -- use the 'image_processor' section of the config
+	config_key :image_processor
+
+
+	# The default dimensions of thumbnails
+	CONFIG_DEFAULTS = {
+		thumbnail_dimensions: '100x100',
+	}
+
+	# An array of mediatypes to ignore, even though ImageMagick claims it groks them
+	IGNORED_MIMETYPES = %w[
+		application/octet-stream
+		text/html
+		text/plain
+		text/x-server-parsed-html
+	]
+
+
+	##
+	# The (maximum) dimensions of generated thumbnails
+	singleton_attr_accessor :thumbnail_dimensions
+	@thumbnail_dimensions = [ 100, 100 ]
+
+
+	### Configurability API -- configure the processor with the :images section of
+	### the config.
+	def self::configure( config=nil )
+		config = self.defaults.merge( config || {} )
+
+		self.thumbnail_dimensions = config[:thumbnail_dimensions].split('x', 2).map( &:to_i )
+	end
+
+
+
+	#################################################################
+	###	I N S T A N C E   M E T H O D S
+	#################################################################
+
+	### Set up a new Filter object
+	def initialize( * ) # :notnew:
+		super
+
+		@supported_formats = find_supported_formats()
+		@handled_types     = find_handled_types( @supported_formats )
+		@generated_types   = find_generated_types( @supported_formats )
+	end
+
+
+	######
+	public
+	######
+
+	# The Hash of formats and the operations they support.
+	attr_reader :supported_formats
+
+	# The mediatypes the plugin accepts in a request, as ThingFish::AcceptParam
+	# objects
+	attr_reader :handled_types
+
+	# The mediatypes the plugin can generated in a response, as
+	# ThingFish::AcceptParam objects
+	attr_reader :generated_types
+
+
+	### Returns +true+ if the given media +type+ is one the processor handles. Overridden so
+	### the types can be used by the instance.
+	def handled_type?( type )
+		self.log.debug "Looking for handled type for: %p" % [ type ]
+		result = self.handled_types.find {|handled_type| type =~ handled_type }
+		self.log.debug "  found: %p" % [ result ]
+		return result
+	end
+	alias_method :is_handled_type?, :handled_type?
+
+
+	### Synchronous processor API -- extract metadata from uploaded images.
+	def on_request( request )
+		self.log.debug "Image-processing %p" % [ request ]
+		image = case request.body
+				when StringIO
+					self.log.debug "  making a single image from a StringIO"
+					Magick::Image.from_blob( request.body.read )
+				else
+					self.log.debug "  making a flattened image out of %p" % [ request.body.path ]
+					list = Magick::ImageList.new( request.body.path )
+					list.flatten_images
+				end
+
+		image = image.first if image.respond_to?( :first )
+		self.log.debug "  image is: %p" % [ image ]
+		metadata = self.extract_image_metadata( image )
+		self.log.debug "  extracted image metadata: %p" % [ metadata ]
+		request.add_metadata( metadata )
+
+		self.log.debug "  going to generate a thumbnail..."
+		self.generate_thumbnail( image, metadata['title'] ) do |thumbio, thumb_metadata|
+			self.log.debug "  generated: %p (%p)" % [ thumbio, thumb_metadata ]
+			request.add_related_resource( thumbio, thumb_metadata )
+		end
+
+		self.log.debug "  destroying the image to free up memory"
+		image.destroy!
+	end
+
+
+	### Return a human-readable representation of the receiving object suitable for
+	### debugging.
+	def inspect
+		return "#<%p:%#x %d supported image formats, %d readable, %d writable>" % [
+			self.class,
+			self.object_id * 2,
+			self.supported_formats.size,
+			self.handled_types.size,
+			self.generated_types.size,
+		]
+	end
+
+
+	#########
+	protected
+	#########
+
+	### Extract metadata from the given +image+ (a Magick::Image object) and return it in
+	### a Hash.
+	def extract_image_metadata( image )
+		metadata = {}
+
+		metadata.merge!( self.get_regular_metadata(image) )
+		metadata.merge!( self.get_exif_metadata(image) )
+
+		return metadata
+	end
+
+
+	### Fetch regular image metadata as a Hash.
+	def get_regular_metadata( image )
+		return {
+			'image:height'       => image.rows,
+			'image:width'        => image.columns,
+			'image:depth'        => image.depth,
+			'image:density'      => image.density,
+			'image:gamma'        => image.gamma,
+			'image:bounding_box' => image.bounding_box.to_s,
+		}
+	end
+
+
+	### Fetch exif metadata and return it as a Hash.
+	def get_exif_metadata( image )
+		exif_pairs = image.get_exif_by_entry
+		exif_pairs.reject! {|name, val| name == 'unknown' || val.nil? }
+		exif_pairs.collect! do |name, val|
+			newname = name.gsub(/\B([A-Z])(?=[a-z])/) { '_' + $1 }.downcase
+			[ "exif:#{newname}", val ]
+		end
+		return Hash[ exif_pairs ]
+	end
+
+
+	### Create a thumbnail from the given +image+ and return it in a string along with any
+	### associated metadata.
+	def generate_thumbnail( image, title )
+		dimensions = self.class.thumbnail_dimensions
+		self.log.debug "Making thumbnail of max dimensions: [%d X %d]" % dimensions
+		thumb = image.resize_to_fit( *dimensions )
+		imgdata = StringIO.new
+		imgdata << thumb.to_blob {|img| img.format = 'JPG' }
+		imgdata.rewind
+
+		metadata = self.extract_image_metadata( thumb )
+		metadata.merge!({
+			format:       thumb.mime_type,
+			relationship: 'thumbnail',
+			title:        "Thumbnail of %s" % [ title || image.inspect ],
+			extent:       imgdata.size,
+		})
+
+		self.log.debug "  made thumbnail for %p" % [ image ]
+		yield( imgdata, metadata )
+
+		thumb.destroy!
+	end
+
+
+	# A struct that can represent the support in the installed ImageMagick for
+	# common operations. See Magick.formats for details.
+	class MagickOperations
+
+		### Create a new MagickOperations for the given +ext+, reading the
+		### supported features of the format from +support_string+.
+		def initialize( ext, support_string )
+			@ext = ext
+			@blob, @read, @write, @multi = support_string.split('')
+		end
+
+		##
+		# Supported features
+		attr_reader :ext, :blob, :read, :write, :multi
+
+
+		### Return a human-readable description of the operations spec
+		def to_s
+			return [
+				self.has_native_blob?	? "Blob" : nil,
+				self.can_read?			? "Readable" : nil,
+				self.can_write?			? "Writable" : nil,
+				self.supports_multi?	? "Multi" : nil,
+			].compact.join(',')
+		end
+
+
+		### Returns +true+ if the operation string indicates that ImageMagick has native blob
+		### support for the associated type
+		def has_native_blob?
+			return (@blob == '*')
+		end
+
+
+		### Returns +true+ if the operation string indicates that ImageMagick has native blob
+		### support for the associated type
+		def can_read?
+			return (@read == 'r')
+		end
+
+
+		### Returns +true+ if the operation string indicates that ImageMagick has native blob
+		### support for the associated type
+		def can_write?
+			return (@write == 'w')
+		end
+
+
+		### Returns +true+ if the operation string indicates that ImageMagick has native blob
+		### support for the associated type
+		def supports_multi?
+			return (@multi == '+')
+		end
+
+	end # class MagickOperations
+
+
+	### Transform the installed ImageMagick's list of formats into AcceptParams
+	### for easy comparison later.
+	def find_supported_formats
+		formats = {}
+		raise "Config database doesn't have any mimetypes" if
+			Mongrel2::Config.mimetypes.empty?
+
+		# A hash of image formats and their properties. Each key in the returned
+		# hash is the name of a supported image format. Each value is a string in
+		# the form "BRWA". The details are in this table:
+		#   B   is "*" if the format has native blob support, and "-" otherwise.
+		#   R   is "r" if ×Magick can read the format, and "-" otherwise.
+		#   W   is "w" if ×Magick can write the format, and "-" otherwise.
+		#   A   is "+" if the format supports multi-image files, and "-" otherwise.
+		Magick.formats.each do |ext,support|
+			ext = ".#{ext.downcase}"
+			self.log.debug "Looking for mediatype for ext: %s (%p)" % [ ext, support ]
+
+			mimetype = Mongrel2::Config.mimetypes[ ext ] or next
+			self.log.debug "  mimetype is: %p" % [ mimetype ]
+			next if IGNORED_MIMETYPES.include?( mimetype )
+
+			operations = MagickOperations.new( ext, support )
+			self.log.debug "  registering image format %s (%s)" % [ mimetype, operations ]
+			formats[ mimetype ] = operations
+		end
+
+		self.log.debug "Registered mimetype mapping for %d of %d supported image types" %
+			[ formats.keys.length, Magick.formats.length ]
+		return formats
+	end
+
+
+	### Return Strelka::HTTPRequest::MediaType objects for the formats that the
+	### processor is capable of reading.
+	def find_handled_types( supported_formats )
+		return supported_formats.
+			select {|type, op| op.can_read? }.
+			collect {|type, op| Strelka::HTTPRequest::MediaType.parse(type) }
+	end
+
+
+	### Return an Array of Strelka::HTTPRequest::MediaType objects for the
+	### formats that the processor is capable of writing.
+	def find_generated_types( supported_formats )
+		return supported_formats.
+			select {|type, op| op.can_write? }.
+			collect {|type, op| Strelka::HTTPRequest::MediaType.parse(type) }
+	end
+
+end # class ThingFish::Processor::Image
+

data/spec/spec_helper.rb

@@ -0,0 +1,50 @@
+# -*- ruby -*-
+#encoding: utf-8
+
+require 'simplecov' if ENV['COVERAGE']
+
+require 'rspec'
+
+require 'mongrel2'
+require 'mongrel2/testing'
+
+require 'thingfish'
+require 'thingfish/spechelpers'
+
+require 'loggability/spechelpers'
+
+require 'thingfish/processor/image'
+
+
+module Thingfish::Processor::Image::SpecHelpers
+
+	FIXTURE_DIR = Pathname( __FILE__ ).dirname + 'data'
+
+
+	### Load and return the data from the fixture with the specified +filename+.
+	def fixture_data( filename )
+		fixture = FIXTURE_DIR + filename
+		return fixture.open( 'r', encoding: 'binary' )
+	end
+
+end
+
+
+
+### Mock with RSpec
+RSpec.configure do |config|
+	config.run_all_when_everything_filtered = true
+	config.filter_run :focus
+	config.order = 'random'
+	config.mock_with( :rspec ) do |mock|
+		mock.syntax = :expect
+	end
+
+	config.include( Mongrel2::SpecHelpers )
+	config.include( Thingfish::SpecHelpers )
+	config.include( Loggability::SpecHelpers )
+	config.include( Thingfish::Processor::Image::SpecHelpers )
+end
+
+
+

data/spec/thingfish/processor/image_spec.rb

@@ -0,0 +1,61 @@
+#!/usr/bin/env ruby
+
+require_relative '../../spec_helper'
+
+require 'rspec'
+require 'strelka'
+require 'strelka/httprequest/metadata'
+require 'thingfish/processor/image'
+
+
+
+describe Thingfish::Processor::Image, :db do
+
+	before( :all ) do
+		Strelka::HTTPRequest.class_eval { include Strelka::HTTPRequest::Metadata }
+	end
+
+
+	let( :processor ) { Thingfish::Processor.create(:image) }
+	let( :factory ) do
+		Mongrel2::RequestFactory.new(
+			:route => '/',
+			:headers => {:accept => '*/*'})
+	end
+
+
+	it "extracts image metadata from uploaded images" do
+		req = factory.post( '/tf', fixture_data('skunks.jpg'), 'Content-type' => 'image/jpeg' )
+
+		processor.process_request( req )
+
+		expect( req.metadata ).to include( "image:bounding_box" => "width=640, height=480, x=0, y=0" )
+	end
+
+
+	it "extracts exif metadata from uploaded images" do
+		req = factory.post( '/tf', fixture_data('skunks.jpg'), 'Content-type' => 'image/jpeg' )
+
+		processor.process_request( req )
+
+		expect( req.metadata ).to include( "exif:software" => "Pixelmator 3.1" )
+	end
+
+
+	it "creates a thumbnail of uploaded images" do
+		req = factory.post( '/tf', fixture_data('skunks.jpg'), 'Content-type' => 'image/jpeg' )
+
+		processor.process_request( req )
+
+		expect( req.related_resources.size ).to eq( 1 )
+		expect( req.related_resources.keys.first ).to be_a( StringIO )
+		expect( req.related_resources.values.first ).
+			to include( 'image:height' => 75, 'image:width' => 100 )
+	end
+
+
+	it "extracts IPTC metadata from uploaded images"
+
+end
+
+# vim: set nosta noet ts=4 sw=4 ft=rspec:

metadata

@@ -0,0 +1,248 @@
+--- !ruby/object:Gem::Specification
+name: thingfish-processor-image
+version: !ruby/object:Gem::Version
+  version: 0.1.0.pre20161114102625
+platform: ruby
+authors:
+- Michael Granger
+autorequire: 
+bindir: bin
+cert_chain:
+- |
+  -----BEGIN CERTIFICATE-----
+  MIIEbDCCAtSgAwIBAgIBATANBgkqhkiG9w0BAQsFADA+MQwwCgYDVQQDDANnZWQx
+  GTAXBgoJkiaJk/IsZAEZFglGYWVyaWVNVUQxEzARBgoJkiaJk/IsZAEZFgNvcmcw
+  HhcNMTYwODIwMTgxNzQyWhcNMTcwODIwMTgxNzQyWjA+MQwwCgYDVQQDDANnZWQx
+  GTAXBgoJkiaJk/IsZAEZFglGYWVyaWVNVUQxEzARBgoJkiaJk/IsZAEZFgNvcmcw
+  ggGiMA0GCSqGSIb3DQEBAQUAA4IBjwAwggGKAoIBgQC/JWGRHO+USzR97vXjkFgt
+  83qeNf2KHkcvrRTSnR64i6um/ziin0I0oX23H7VYrDJC9A/uoUa5nGRJS5Zw/+wW
+  ENcvWVZS4iUzi4dsYJGY6yEOsXh2CcF46+QevV8iE+UmbkU75V7Dy1JCaUOyizEt
+  TH5UHsOtUU7k9TYARt/TgYZKuaoAMZZd5qyVqhF1vV+7/Qzmp89NGflXf2xYP26a
+  4MAX2qqKX/FKXqmFO+AGsbwYTEds1mksBF3fGsFgsQWxftG8GfZQ9+Cyu2+l1eOw
+  cZ+lPcg834G9DrqW2zhqUoLr1MTly4pqxYGb7XoDhoR7dd1kFE2a067+DzWC/ADt
+  +QkcqWUm5oh1fN0eqr7NsZlVJDulFgdiiYPQiIN7UNsii4Wc9aZqBoGcYfBeQNPZ
+  soo/6za/bWajOKUmDhpqvaiRv9EDpVLzuj53uDoukMMwxCMfgb04+ckQ0t2G7wqc
+  /D+K9JW9DDs3Yjgv9k4h7YMhW5gftosd+NkNC/+Y2CkCAwEAAaN1MHMwCQYDVR0T
+  BAIwADALBgNVHQ8EBAMCBLAwHQYDVR0OBBYEFHKN/nkRusdqCJEuq3lgB3fJvyTg
+  MBwGA1UdEQQVMBOBEWdlZEBGYWVyaWVNVUQub3JnMBwGA1UdEgQVMBOBEWdlZEBG
+  YWVyaWVNVUQub3JnMA0GCSqGSIb3DQEBCwUAA4IBgQAPJzKiT0zBU7kpqe0aS2qb
+  FI0PJ4y5I8buU4IZGUD5NEt/N7pZNfOyBxkrZkXhS44Fp+xwBH5ebLbq/WY78Bqd
+  db0z6ZgW4LMYMpWFfbXsRbd9TU2f52L8oMAhxOvF7Of5qJMVWuFQ8FPagk2iHrdH
+  inYLQagqAF6goWTXgAJCdPd6SNeeSNqA6vlY7CV1Jh5kfNJJ6xu/CVij1GzCLu/5
+  DMOr26DBv+qLJRRC/2h34uX71q5QgeOyxvMg+7V3u/Q06DXyQ2VgeeqiwDFFpEH0
+  PFkdPO6ZqbTRcLfNH7mFgCBJjsfSjJrn0sPBlYyOXgCoByfZnZyrIMH/UY+lgQqS
+  6Von1VDsfQm0eJh5zYZD64ZF86phSR7mUX3mXItwH04HrZwkWpvgd871DZVR3i1n
+  w8aNA5re5+Rt/Vvjxj5AcEnZnZiz5x959NaddQocX32Z1unHw44pzRNUur1GInfW
+  p4vpx2kUSFSAGjtCbDGTNV2AH8w9OU4xEmNz8c5lyoA=
+  -----END CERTIFICATE-----
+date: 2016-11-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mongrel2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.46'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.46'
+- !ruby/object:Gem::Dependency
+  name: thingfish
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.5'
+- !ruby/object:Gem::Dependency
+  name: loggability
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.11'
+- !ruby/object:Gem::Dependency
+  name: rmagick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.16'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.16'
+- !ruby/object:Gem::Dependency
+  name: hoe-mercurial
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+- !ruby/object:Gem::Dependency
+  name: hoe-deveiate
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: hoe-highline
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: rdoc-generator-fivefish
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.1'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '4.0'
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.15'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.15'
+description: |-
+  This is a basic image-processor plugin for the Thingfish digital asset manager.
+  It extracts image-related metadata from uploaded media files, and generates one
+  or more thumbnail images as related resources.
+email:
+- ged@FaerieMUD.org
+executables: []
+extensions: []
+extra_rdoc_files:
+- History.md
+- LICENSE.txt
+- Manifest.txt
+- README.md
+files:
+- ".document"
+- ".editorconfig"
+- ".rdoc_options"
+- ".simplecov"
+- ChangeLog
+- History.md
+- LICENSE.txt
+- Manifest.txt
+- README.md
+- Rakefile
+- lib/thingfish/processor/image.rb
+- spec/data/skunks.jpg
+- spec/spec_helper.rb
+- spec/thingfish/processor/image_spec.rb
+homepage: https://bitbucket.org/ged/thingfish-processor-image
+licenses:
+- BSD-3-Clause
+metadata: {}
+post_install_message: 
+rdoc_options:
+- "--main"
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.3.1
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">"
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: This is a basic image-processor plugin for the Thingfish digital asset manager
+test_files: []