httpthumbnailer-client 0.1.1 → 1.0.0

data/Gemfile

@@ -1,17 +1,20 @@
 source "http://rubygems.org"
+ruby "1.9.3"
 
-gem "httpclient", ">= 2.2"
+gem "httpclient", ">= 2.3"
+gem "cli", "~> 1.1.0"
+gem "multipart-parser", "~> 0.1.1"
 
 # Add dependencies to develop your gem here.
 # Include everything needed to run rake, tests, features, etc.
 group :development do
-  gem "rspec", "~> 2.3"
+  gem "rspec", "~> 2.13"
+  gem "rspec-mocks", "~> 2.13"
   gem "cucumber", ">= 0"
-  gem "bundler", "~> 1.1"
-  gem "jeweler", "~> 1.6"
-  gem "simplecov", ">= 0"
+  gem "jeweler", "~> 1.8.4"
   gem "rdoc", "~> 3.9"
   gem "daemon", "~> 1"
-  gem "httpthumbnailer", "~> 0.3"
+  gem "rmagick", "~> 2"
+  gem "httpthumbnailer", path: '../httpthumbnailer'
+  gem "unicorn-cuba-base", path: '../unicorn-cuba-base'
 end
-

data/Gemfile.lock

@@ -1,75 +1,82 @@
+PATH
+  remote: ../httpthumbnailer
+  specs:
+    httpthumbnailer (1.0.0)
+      rmagick (~> 2)
+      unicorn-cuba-base (~> 1.0)
+
+PATH
+  remote: ../unicorn-cuba-base
+  specs:
+    unicorn-cuba-base (1.0.0)
+      cli (~> 1.1.0)
+      cuba (~> 3.0)
+      facter (~> 1.6.11)
+      raindrops (~> 0.11)
+      ruby-ip (~> 0.9)
+      unicorn (>= 4.6.2)
+
 GEM
   remote: http://rubygems.org/
   specs:
     builder (3.0.0)
     cli (1.1.1)
-    cucumber (1.2.1)
+    cuba (3.1.0)
+      rack
+    cucumber (1.1.3)
       builder (>= 2.1.2)
-      diff-lcs (>= 1.1.3)
-      gherkin (~> 2.11.0)
+      diff-lcs (>= 1.1.2)
+      gherkin (~> 2.6.7)
       json (>= 1.4.6)
+      term-ansicolor (>= 1.0.6)
     daemon (1.1.0)
-    daemons (1.0.10)
     diff-lcs (1.1.3)
-    gem_plugin (0.2.3)
-    gherkin (2.11.2)
+    facter (1.6.18)
+    gherkin (2.6.7)
       json (>= 1.4.6)
     git (1.2.5)
-    haml (3.1.7)
-    httpclient (2.2.7)
-    httpthumbnailer (0.3.1)
-      cli (~> 1.1.0)
-      haml (~> 3)
-      mongrel (>= 1.2.0.pre2)
-      rmagick (~> 2)
-      ruby-ip (~> 0.9)
-      sinatra (>= 1.2.6)
+    httpclient (2.3.3)
     jeweler (1.8.4)
       bundler (~> 1.0)
       git (>= 1.2.5)
       rake
       rdoc
-    json (1.7.5)
-    mongrel (1.2.0.pre2)
-      daemons (~> 1.0.10)
-      gem_plugin (~> 0.2.3)
-    multi_json (1.3.6)
-    rack (1.4.1)
-    rack-protection (1.2.0)
-      rack
-    rake (0.9.2.2)
-    rdoc (3.12)
-      json (~> 1.4)
+    json (1.6.1)
+    kgio (2.8.0)
+    multipart-parser (0.1.1)
+    rack (1.5.2)
+    raindrops (0.11.0)
+    rake (10.0.4)
+    rdoc (3.9.4)
     rmagick (2.13.1)
-    rspec (2.11.0)
-      rspec-core (~> 2.11.0)
-      rspec-expectations (~> 2.11.0)
-      rspec-mocks (~> 2.11.0)
-    rspec-core (2.11.1)
-    rspec-expectations (2.11.3)
-      diff-lcs (~> 1.1.3)
-    rspec-mocks (2.11.2)
+    rspec (2.13.0)
+      rspec-core (~> 2.13.0)
+      rspec-expectations (~> 2.13.0)
+      rspec-mocks (~> 2.13.0)
+    rspec-core (2.13.1)
+    rspec-expectations (2.13.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.13.1)
     ruby-ip (0.9.1)
-    simplecov (0.6.4)
-      multi_json (~> 1.0)
-      simplecov-html (~> 0.5.3)
-    simplecov-html (0.5.3)
-    sinatra (1.3.3)
-      rack (~> 1.3, >= 1.3.6)
-      rack-protection (~> 1.2)
-      tilt (~> 1.3, >= 1.3.3)
-    tilt (1.3.3)
+    term-ansicolor (1.0.7)
+    unicorn (4.6.3)
+      kgio (~> 2.6)
+      rack
+      raindrops (~> 0.7)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.1)
+  cli (~> 1.1.0)
   cucumber
   daemon (~> 1)
-  httpclient (>= 2.2)
-  httpthumbnailer (~> 0.3)
-  jeweler (~> 1.6)
+  httpclient (>= 2.3)
+  httpthumbnailer!
+  jeweler (~> 1.8.4)
+  multipart-parser (~> 0.1.1)
   rdoc (~> 3.9)
-  rspec (~> 2.3)
-  simplecov
+  rmagick (~> 2)
+  rspec (~> 2.13)
+  rspec-mocks (~> 2.13)
+  unicorn-cuba-base!

data/README.md

@@ -1,44 +1,68 @@
-# httpthumbnailer-client
+# HTTP Thubnailer Client
 
 Ruby client to [httpthumbnailer](http://github.com/jpastuszek/httpthumbnailer) image scaling and conversion HTTP API server.
 
 ## Installing
 
-    gem install httpthumbnailer-client
+```bash
+gem install httpthumbnailer-client
+```
 
 ## Usage
 
-Basic usage:
+### Ruby API
 
 ```ruby
 require 'httpthumbnailer-client'
 
-# read orginal image data (may be any format supported by ImageMagick installation on the server)
+# read original image data (may be any format supported by ImageMagick/GraphicsMagick installation on the server)
 data = File.read('image_file.jpg')
 
-# thumbnail image with API server listening on localhost port 3100
+# with API server listening on localhost port 3100
+# see the API server documentation for available operations, formats and options
+
+# generate single thumbnail from image data (single thumbnail API)
+thumbnail = HTTPThumbnailerClient.new('http://localhost:3100').thumbnail(data, 'crop', 60, 30, 'jpeg')
+thumbnail.mime_type 	# => 'image/jpeg'
+thumbnail.data 			# => 60x30 thumbnail JPEG data String
+
+# generate set of thumbnails from image data (multipart API)
 thumbnails = HTTPThumbnailerClient.new('http://localhost:3100').thumbnail(data) do
-	# definition of thumbnail formats - see the API server documentation for available operations, formats and options
-	thumbnail 'crop', 6, 3, 'JPEG' 
-	thumbnail 'crop', 8, 8, 'PNG'
-	thumbnail 'pad', 4, 4, 'PNG'
+	thumbnail 'crop', 60, 30, 'jpeg' 
+	thumbnail 'crop', 80, 80, 'png'
+	thumbnail 'pad', 40, 40, 'png'
 end
 
 thumbnails[0].mime_type 	# => 'image/jpeg'
-thumbnails[0].data 			# => 6x3 thumbnail JPEG data Strine
+thumbnails[0].data 			# => 60x30 thumbnail JPEG data String
 
 thumbnails[1].mime_type 	# => 'image/png'
-thumbnails[1].data 			# => 8x8 thumbnail PNG data String
+thumbnails[1].data 			# => 80x80 thumbnail PNG data String
 
 thumbnails[2].mime_type		# => 'image/png'
-thumbnails[2].data			# => 4x4 thumbnail PNG data String
+thumbnails[2].data			# => 40x40 thumbnail PNG data String
 
 thumbnails.input_mime_type	# => 'image/jpeg' - detected input image format by API server (content based)
 ```
 
-For more details see [RSpec tests](http://github.com/jpastuszek/httpthumbnailer-client/blob/master/spec/httpthumbnailer-client_spec.rb)
+For more details see RSpec for [single thumbnail API](http://github.com/jpastuszek/httpthumbnailer-client/blob/master/spec/thumbnail_spec.rb) and [multipart API](http://github.com/jpastuszek/httpthumbnailer-client/blob/master/spec/thumbnails_spec.rb).
+
+### CLI tool
+
+This gem provides `httpthumbnailer-client` command line tool that can be used to thumbnail images via [httpthumbnailer](http://github.com/jpastuszek/httpthumbnailer).
+
+```bash
+# start thumbnailing server (to stop: kill `cat httpthumbnailer.pid`)
+httpthumbnailer
+
+# thumbnail to standard output
+cat ~/Pictures/compute.jpg | httpthumbnailer-client -t crop,100,200,png > thumbnail.png
+
+# generate multiple thumbnails
+cat ~/Pictures/compute.jpg | httpthumbnailer-client -t crop,100,200,jpeg,quality:100 -t pad,200,200,png thumbnail1.jpg thumbnail2.png
+```
 
-## Contributing to httpthumbnailer-client
+## Contributing to HTTP Thubnailer Client
  
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
 * Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
@@ -50,6 +74,6 @@ For more details see [RSpec tests](http://github.com/jpastuszek/httpthumbnailer-
 
 ## Copyright
 
-Copyright (c) 2012 Jakub Pastuszek. See LICENSE.txt for
+Copyright (c) 2013 Jakub Pastuszek. See LICENSE.txt for
 further details.
 

data/VERSION

@@ -1 +1 @@
-0.1.1
+1.0.0

data/bin/httpthumbnailer-client

@@ -0,0 +1,73 @@
+#!/usr/bin/env ruby
+require 'cli'
+require 'pathname'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'httpthumbnailer-client'
+
+def parse_spec(spec)
+	method, width, height, format, *options = *spec.split(',')
+	fail "missing thumbnail specification argument in: #{spec}" unless method and width and height and format
+
+	opts = {}
+	options.each do |option|
+	key, value = option.split(':')
+		fail "missing option key or value in specifiaction: #{spec}" unless key and value
+	opts[key] = value
+	end
+
+	[method, width, height, format, opts]
+end
+
+settings = CLI.new do
+	description 'Client to httpthumbnailer image scaling and conversion HTTP API server'
+	stdin :image_data,
+		description: 'image to be thumbnailed'
+	option :host,
+		short: :H,
+		description: 'host on which the httpthumbnailer is running',
+		default: 'localhost'
+	option :port,
+		short: :p,
+		description: 'TCP port on which the httpthumbnailer is listening',
+		cast: Integer,
+		default: 3100
+	options :thumbnail,
+		short: :t,
+		description: 'thumbnail specification in format <operation type>,<width>,<height>,<format>[,<option key>:<option value>]* - see httpthumbnailer documenation for more information',
+		required: true
+	arguments :output_file_name,
+		short: :f,
+		description: 'file name to store resulting thumbnail; when multiple --thumbail options are used the same number of output file names should be specified; use "-" to write to STDOUT',
+		default: '-'
+	version (Pathname.new(__FILE__).dirname + '..' + 'VERSION').read
+end.parse! do |settings|
+	STDERR.puts "Warning: there is more thumbnail specifications given than output file names; some thumbnails will not be saved" if settings.thumbnail.length > settings.output_file_name.length
+	fail 'only one thumbnail can be written to STDOUT' if settings.output_file_name.count('-') > 1
+	settings.thumbnail = settings.thumbnail.map{|spec| parse_spec(spec)}
+end
+
+thumbnailer = HTTPThumbnailerClient.new("http://#{settings.host}:#{settings.port}")
+
+thumbnails = if settings.thumbnail.length == 1
+	[thumbnailer.thumbnail(settings.stdin.read, *settings.thumbnail.first)]
+else
+	thumbnailer.thumbnail(settings.stdin.read) do
+		settings.thumbnail.each do |spec|
+			thumbnail *spec
+		end
+	end
+end
+
+thumbnails.zip(settings.output_file_name).select do |thumbnail, out_file| 
+	out_file 
+end.each do |thumbnail, out_file|
+	if out_file == '-'
+		STDOUT.write thumbnail.data
+	else
+		File.open(out_file, 'w') do |file|
+			file.write thumbnail.data
+		end
+	end
+end
+

data/httpthumbnailer-client.gemspec

@@ -5,13 +5,14 @@
 
 Gem::Specification.new do |s|
   s.name = "httpthumbnailer-client"
-  s.version = "0.1.1"
+  s.version = "1.0.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Jakub Pastuszek"]
-  s.date = "2012-09-05"
+  s.date = "2013-07-16"
   s.description = "Thumbnails images using httpthumbniler server"
   s.email = "jpastuszek@gmail.com"
+  s.executables = ["httpthumbnailer-client"]
   s.extra_rdoc_files = [
     "LICENSE.txt",
     "README.md"
@@ -25,58 +26,69 @@ Gem::Specification.new do |s|
     "README.md",
     "Rakefile",
     "VERSION",
+    "bin/httpthumbnailer-client",
     "features/step_definitions/httpthumbnailer-client_steps.rb",
     "features/support/env.rb",
     "httpthumbnailer-client.gemspec",
     "lib/httpthumbnailer-client.rb",
-    "lib/httpthumbnailer-client/multipart_response.rb",
     "spec/httpthumbnailer-client_spec.rb",
-    "spec/multipart_response_spec.rb",
     "spec/spec_helper.rb",
-    "spec/test-large.jpg",
-    "spec/test.jpg",
-    "spec/test.txt"
+    "spec/support/test-large.jpg",
+    "spec/support/test.jpg",
+    "spec/support/test.txt",
+    "spec/thumbnail_spec.rb",
+    "spec/thumbnails_spec.rb",
+    "spec/uri_builder_spec.rb"
   ]
   s.homepage = "http://github.com/jpastuszek/httpthumbnailer-client"
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.23"
+  s.rubygems_version = "1.8.25"
   s.summary = "API client for httpthumbniler server"
 
   if s.respond_to? :specification_version then
     s.specification_version = 3
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<httpclient>, [">= 2.2"])
-      s.add_development_dependency(%q<rspec>, ["~> 2.3"])
+      s.add_runtime_dependency(%q<httpclient>, [">= 2.3"])
+      s.add_runtime_dependency(%q<cli>, ["~> 1.1.0"])
+      s.add_runtime_dependency(%q<multipart-parser>, ["~> 0.1.1"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.13"])
+      s.add_development_dependency(%q<rspec-mocks>, ["~> 2.13"])
       s.add_development_dependency(%q<cucumber>, [">= 0"])
-      s.add_development_dependency(%q<bundler>, ["~> 1.1"])
-      s.add_development_dependency(%q<jeweler>, ["~> 1.6"])
-      s.add_development_dependency(%q<simplecov>, [">= 0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
       s.add_development_dependency(%q<rdoc>, ["~> 3.9"])
       s.add_development_dependency(%q<daemon>, ["~> 1"])
-      s.add_development_dependency(%q<httpthumbnailer>, ["~> 0.3"])
+      s.add_development_dependency(%q<rmagick>, ["~> 2"])
+      s.add_development_dependency(%q<httpthumbnailer>, [">= 0"])
+      s.add_development_dependency(%q<unicorn-cuba-base>, [">= 0"])
     else
-      s.add_dependency(%q<httpclient>, [">= 2.2"])
-      s.add_dependency(%q<rspec>, ["~> 2.3"])
+      s.add_dependency(%q<httpclient>, [">= 2.3"])
+      s.add_dependency(%q<cli>, ["~> 1.1.0"])
+      s.add_dependency(%q<multipart-parser>, ["~> 0.1.1"])
+      s.add_dependency(%q<rspec>, ["~> 2.13"])
+      s.add_dependency(%q<rspec-mocks>, ["~> 2.13"])
       s.add_dependency(%q<cucumber>, [">= 0"])
-      s.add_dependency(%q<bundler>, ["~> 1.1"])
-      s.add_dependency(%q<jeweler>, ["~> 1.6"])
-      s.add_dependency(%q<simplecov>, [">= 0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
       s.add_dependency(%q<rdoc>, ["~> 3.9"])
       s.add_dependency(%q<daemon>, ["~> 1"])
-      s.add_dependency(%q<httpthumbnailer>, ["~> 0.3"])
+      s.add_dependency(%q<rmagick>, ["~> 2"])
+      s.add_dependency(%q<httpthumbnailer>, [">= 0"])
+      s.add_dependency(%q<unicorn-cuba-base>, [">= 0"])
     end
   else
-    s.add_dependency(%q<httpclient>, [">= 2.2"])
-    s.add_dependency(%q<rspec>, ["~> 2.3"])
+    s.add_dependency(%q<httpclient>, [">= 2.3"])
+    s.add_dependency(%q<cli>, ["~> 1.1.0"])
+    s.add_dependency(%q<multipart-parser>, ["~> 0.1.1"])
+    s.add_dependency(%q<rspec>, ["~> 2.13"])
+    s.add_dependency(%q<rspec-mocks>, ["~> 2.13"])
     s.add_dependency(%q<cucumber>, [">= 0"])
-    s.add_dependency(%q<bundler>, ["~> 1.1"])
-    s.add_dependency(%q<jeweler>, ["~> 1.6"])
-    s.add_dependency(%q<simplecov>, [">= 0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
     s.add_dependency(%q<rdoc>, ["~> 3.9"])
     s.add_dependency(%q<daemon>, ["~> 1"])
-    s.add_dependency(%q<httpthumbnailer>, ["~> 0.3"])
+    s.add_dependency(%q<rmagick>, ["~> 2"])
+    s.add_dependency(%q<httpthumbnailer>, [">= 0"])
+    s.add_dependency(%q<unicorn-cuba-base>, [">= 0"])
   end
 end
 

data/lib/httpthumbnailer-client.rb

@@ -1,47 +1,98 @@
-$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 require 'httpclient'
-require 'httpthumbnailer-client/multipart_response'
+require 'multipart_parser/reader'
 
 class HTTPThumbnailerClient
-	class UnsupportedMediaTypeError < ArgumentError
-	end
+	HTTPThumbnailerClientError = Class.new(ArgumentError)
+
+	InvalidThumbnailSpecificationError = Class.new(HTTPThumbnailerClientError)
+	ServerResourceNotFoundError = Class.new(HTTPThumbnailerClientError)
+	UnsupportedMediaTypeError = Class.new(HTTPThumbnailerClientError)
+	ImageTooLargeError = Class.new(HTTPThumbnailerClientError)
+	RemoteServerError = Class.new(HTTPThumbnailerClientError)
+
+	@@errors = {}
+
+	module Status
+		def status=(st)
+			@status = st
+		end
 
-	class ImageTooLargeError < ArgumentError
+		def status
+			@status
+		end
+
+		module Instance
+			def status
+				defined?(self.class.status) ? self.class.status : 500
+			end
+		end
+
+		def self.extended(klass)
+			klass.instance_eval do
+				include Instance
+			end
+		end
 	end
 
-	class UnknownResponseType < ArgumentError
+	def self.assign_status_code(error, status)
+		error.extend Status
+		error.status = status
+		@@errors[status] = error
+		@@errors[error] = status
 	end
 
-	class RemoteServerError < ArgumentError
+	assign_status_code(InvalidThumbnailSpecificationError, 400)
+	assign_status_code(ServerResourceNotFoundError, 404)
+	assign_status_code(UnsupportedMediaTypeError, 415)
+	assign_status_code(ImageTooLargeError, 413)
+	assign_status_code(RemoteServerError, 500)
+
+	def error_for_status(status, body)
+		@@errors.fetch(status){|err| RemoteServerError}.new(body)
 	end
 
+	UnknownResponseType = Class.new HTTPThumbnailerClientError
+	InvalidMultipartResponseError = Class.new HTTPThumbnailerClientError
+
 	class URIBuilder
 		def initialize(service_uri, &block)
 			@specs = []
 			@service_uri = service_uri
-			instance_eval &block
+			instance_eval &block if block
 		end
 
 		def get
 			"#{@service_uri}/#{@specs.join('/')}"
 		end
 
-		def self.thumbnail(&block)
-			self.new('/thumbnail', &block).get
+		def self.thumbnail(*spec)
+			self.new('/thumbnail').thumbnail(*spec).get
+		end
+
+		def self.thumbnails(&block)
+			self.new('/thumbnails', &block).get
 		end
 
-		def thumbnail(method, width, height, format = 'JPEG', options = {})
+		def thumbnail(method, width, height, format = 'jpeg', options = {})
+			width = width.to_s
+			height = height.to_s
+
 			args = []
 			args << method.to_s
-			args << width.to_s
-			args << height.to_s
+			width !~ /^([0-9]+|input)$/ and raise InvalidThumbnailSpecificationError.new("bad dimension value: #{width}")
+			args << width
+			height !~ /^([0-9]+|input)$/ and raise InvalidThumbnailSpecificationError.new("bad dimension value: #{height}")
+			args << height
 			args << format.to_s
 
 			options.keys.sort{|a, b| a.to_s <=> b.to_s}.each do |key|
+				raise InvalidThumbnailSpecificationError.new("empty option key for value '#{options[key]}'") if key.nil? || key.to_s.empty? 
+				raise InvalidThumbnailSpecificationError.new("missing option value for key '#{key}'") if options[key].nil? || options[key].to_s.empty? 
 				args << "#{key}:#{options[key]}"
 			end
 
 			@specs << args.join(',')
+			self
 		end
 	end
 
@@ -58,64 +109,87 @@ class HTTPThumbnailerClient
 		attr_accessor :input_mime_type
 	end
 
-	class ThumbnailingError
-		def initialize(msg)
-			@message = msg
-			@type = msg.match(/Error: (.*?): /)[1] rescue NoMethodError
-		end
-
-		attr_reader :type, :message
-	end
-
 	def initialize(server_url, options = {})
 		@server_url = server_url
 		@client = HTTPClient.new
+
+		# long timeouts for big image data
+		@client.send_timeout = options[:send_timeout] || 300
+		@client.receive_timeout = options[:receive_timeout] || 300
+
+		# don't use keep alive by default since backend won't support it any way unless fronted with nginx or similar
 		@keep_alive = options[:keep_alive] || false
 	end
 
-	def thumbnail(data, &block)
-		uri = URIBuilder.thumbnail(&block)
+	attr_reader :server_url
+	attr_reader :keep_alive
+
+	def thumbnail(data, *spec, &block)
+		uri = if block
+			URIBuilder.thumbnails(&block)
+		else
+			URIBuilder.thumbnail(*spec)
+		end
 
 		response = @client.request('PUT', "#{@server_url}#{uri}", nil, data, {'Content-Type' => 'image/autodetect'})
 		@client.reset_all unless @keep_alive
 
 		content_type = response.header['Content-Type'].last
 
-		case content_type
+		thumbnails = case content_type
 		when 'text/plain'
-			case response.status
-			when 415
-				raise UnsupportedMediaTypeError, response.body.delete("\r")
-			when 413
-				raise ImageTooLargeError, response.body.delete("\r")
-			else
-				raise RemoteServerError, response.body.delete("\r")
-			end
+			raise error_for_status(response.status, response.body)
+		when /^image\//
+			Thumbnail.new(content_type, response.body)
 		when /^multipart\/mixed/
-			thumbnails = MultipartResponse.new(content_type, response.body).parts.map do |part|
-				part_content_type = part.header['Content-Type']
-
-				case part_content_type
-				when 'text/plain'
-					ThumbnailingError.new(part.body.delete("\r"))
-				when /^image\//
-					Thumbnail.new(part_content_type, part.body)
-				else
-					raise UnknownResponseType, part_content_type
+			parts = []
+			parser = MultipartParser::Reader.new(MultipartParser::Reader.extract_boundary_value(content_type))
+			parser.on_part do |part|
+				part_content_type = part.headers['content-type'] or raise InvalidMultipartResponseError, 'missing Content-Type header in multipart part'
+				part_status = part.headers['status']
+				data = ''
+
+				part.on_data do |partial_data|
+					data << partial_data
 				end
-			end
 
-			unless response.header['X-Input-Image-Content-Type'].empty?
-				thumbnails.extend(ThumbnailsInputMimeTypeMeta)
-				thumbnails.input_mime_type = response.header['X-Input-Image-Content-Type'].first
+				part.on_end do
+					case part_content_type
+					when 'text/plain'
+						part_status or raise InvalidMultipartResponseError, 'missing Status header in error part (text/plain)'
+
+						begin
+							raise error_for_status(part_status.to_i, data.strip)
+						rescue HTTPThumbnailerClientError => error # raise for stack trace
+							parts << error
+						end
+					when /^image\//
+						parts << Thumbnail.new(part_content_type, data)
+					else
+						raise UnknownResponseType, part_content_type
+					end
+				end
 			end
 
-			return thumbnails
+			parser.write response.body
+			parser.ended? or raise InvalidMultipartResponseError, 'truncated multipart message'
+			parts
 		else
 			raise UnknownResponseType, content_type
 		end
+
+		unless response.header['X-Input-Image-Content-Type'].empty?
+			thumbnails.extend(ThumbnailsInputMimeTypeMeta)
+			thumbnails.input_mime_type = response.header['X-Input-Image-Content-Type'].first
+		end
+
+		return thumbnails
 	rescue HTTPClient::KeepAliveDisconnected
 		raise RemoteServerError, 'empty response'
 	end
+
+	def inspect
+		"#<#{self.class.name} server_url=#{server_url.inspect} keep_alive=#{keep_alive.inspect}>"
+	end
 end