httpthumbnailer 0.3.0 → 0.3.1

data/Gemfile

@@ -1,7 +1,7 @@
 source "http://rubygems.org"
 
 gem "sinatra", ">= 1.2.6"
-gem "mongrel", ">= 1.1.5"
+gem "mongrel", ">= 1.2.0.pre2"
 gem "rmagick", "~> 2"
 gem "haml", "~> 3"
 gem "ruby-ip", "~> 0.9"

data/Gemfile.lock

@@ -2,7 +2,6 @@ GEM
   remote: http://rubygems.org/
   specs:
     builder (3.0.0)
-    cgi_multipart_eof_fix (2.5.0)
     cli (1.1.0)
     cucumber (1.1.2)
       builder (>= 2.1.2)
@@ -11,9 +10,8 @@ GEM
       json (>= 1.4.6)
       term-ansicolor (>= 1.0.6)
     daemon (1.1.0)
-    daemons (1.1.4)
+    daemons (1.0.10)
     diff-lcs (1.1.3)
-    fastthread (1.0.7)
     gem_plugin (0.2.3)
     gherkin (2.6.5)
       json (>= 1.4.6)
@@ -25,11 +23,9 @@ GEM
       git (>= 1.2.5)
       rake
     json (1.6.1)
-    mongrel (1.1.5)
-      cgi_multipart_eof_fix (>= 2.4)
-      daemons (>= 1.0.3)
-      fastthread (>= 1.0.1)
-      gem_plugin (>= 0.2.3)
+    mongrel (1.2.0.pre2)
+      daemons (~> 1.0.10)
+      gem_plugin (~> 0.2.3)
     rack (1.3.5)
     rack-protection (1.1.4)
       rack
@@ -64,7 +60,7 @@ DEPENDENCIES
   haml (~> 3)
   httpclient (~> 2.2)
   jeweler (~> 1.6.4)
-  mongrel (>= 1.1.5)
+  mongrel (>= 1.2.0.pre2)
   rcov
   rdoc (~> 3.9)
   rmagick (~> 2)

data/README.md

@@ -0,0 +1,110 @@
+# httpthumbnailer
+
+HTTP API server for image thumbnailing and format conversion.
+
+It is using **ImageMagick** as the image processing library.
+
+## Installing
+
+You will need the following system packages installed: `imagemagick`, `libpng`, `pkg-config`, `make`.
+Optionally you may want to install `fcgi` package and gem to be able to use it as **FastCGI** backend.
+
+For Arch Linux you can use this commands:
+
+    pacman -S imagemagick
+    pacman -S libpng
+    pacman -S pkg-config
+    pacman -S make
+
+Then you can install the gem as usual:
+
+    gem install httpthumbnailer
+
+## Usage
+
+It can be started as a stand alone server or as FastCGI backend.
+
+### Stand alone server
+
+This mode is useful for testing.
+By default **Mongrel** will be used as HTTP handling library (you can use --server option to specify different server that is supported by Sinatra).
+
+To start it in that mode run:
+
+    httpthumbnailer
+
+By default it will be listening on **localhost** port **3100**.
+
+### FastCGI
+
+In this mode you can run many **httpthumbnailer** instances so that requests will be load balanced between them equally.
+Since it is single threaded (some ImageMagick operations may be multithreaded) it will be able to max out only single CPU core.
+Therefore it is recommended to run as many instances as there are CPU cores available.
+
+Make sure you have FastCGI system library installed.
+
+For Arch Linux you can use this command:
+
+    pacman -S fcgi
+
+And you have `fcgi` gem installed with:
+
+    gem install fcgi
+
+Here is an example **Lighttpd** configuration:
+
+    $SERVER["socket"] == ":3100" {
+        server.reject-expect-100-with-417 = "disable" 
+    	fastcgi.debug = 1
+    	fastcgi.server    = ( "/" =>
+    		((
+    			"socket" => "/var/run/lighttpd/httpthumbniler.sock",
+    			"bin-path" => "/usr/bin/httpthumbnailer -s fastcgi --no-bind --no-logging",
+    			"max-procs" => 2,
+    			"check-local" => "disable",
+    			"fix-root-scriptname" => "enable",
+    		))
+    	)
+    }
+
+The `"max-procs" => 2` controls the number of instances started.
+In case that the `httpthumbnailer` process crashes (may happen since it is using native libraries) it will be restarted by Lighttpd.
+
+### API
+
+Basically it works like that:
+
+1. PUT your image data to the server with URI describing thumbnail format (one or more)
+2. the server will respond with **multi-part content** with parts containing data of your thumbnails in order with proper **Content-type** headers set
+
+For example the URI may look like this: 
+
+    /thumbnail/crop,16,16,PNG/crop,4,8,JPG/pad,16,32,JPEG
+
+It will generate 3 thumbnails: 
+
+1. 16x16 cropped PNG
+2. 4x8 cropped JPEG
+3. 16x32 colour padded JPEG
+
+For detailed information about the API see [cucumber features](http://github.com/jpastuszek/httpthumbnailer/blob/master/features/httpthumbnailer.feature).
+
+### API client
+
+To make it easy to use this server there is [httpthumbnailer-client](http://github.com/jpastuszek/httpthumbnailer-client) gem provided.
+
+## Contributing to httpthumbnailer
+ 
+* 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
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+## Copyright
+
+Copyright (c) 2012 Jakub Pastuszek. See LICENSE.txt for
+further details.
+

data/VERSION

@@ -1 +1 @@
-0.3.0
+0.3.1

data/httpthumbnailer.gemspec

@@ -5,17 +5,17 @@
 
 Gem::Specification.new do |s|
   s.name = "httpthumbnailer"
-  s.version = "0.3.0"
+  s.version = "0.3.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Jakub Pastuszek"]
-  s.date = "2012-01-16"
+  s.date = "2012-02-07"
   s.description = "Provides HTTP API for thumbnailing images"
   s.email = "jpastuszek@gmail.com"
   s.executables = ["httpthumbnailer"]
   s.extra_rdoc_files = [
     "LICENSE.txt",
-    "README.rdoc"
+    "README.md"
   ]
   s.files = [
     ".document",
@@ -23,7 +23,7 @@ Gem::Specification.new do |s|
     "Gemfile",
     "Gemfile.lock",
     "LICENSE.txt",
-    "README.rdoc",
+    "README.md",
     "Rakefile",
     "VERSION",
     "bin/httpthumbnailer",
@@ -58,7 +58,7 @@ Gem::Specification.new do |s|
   s.homepage = "http://github.com/jpastuszek/httpthumbnailer"
   s.licenses = ["MIT"]
   s.require_paths = ["lib"]
-  s.rubygems_version = "1.8.10"
+  s.rubygems_version = "1.8.15"
   s.summary = "HTTP thumbnailing server"
 
   if s.respond_to? :specification_version then
@@ -66,7 +66,7 @@ Gem::Specification.new do |s|
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<sinatra>, [">= 1.2.6"])
-      s.add_runtime_dependency(%q<mongrel>, [">= 1.1.5"])
+      s.add_runtime_dependency(%q<mongrel>, [">= 1.2.0.pre2"])
       s.add_runtime_dependency(%q<rmagick>, ["~> 2"])
       s.add_runtime_dependency(%q<haml>, ["~> 3"])
       s.add_runtime_dependency(%q<ruby-ip>, ["~> 0.9"])
@@ -81,7 +81,7 @@ Gem::Specification.new do |s|
       s.add_development_dependency(%q<rdoc>, ["~> 3.9"])
     else
       s.add_dependency(%q<sinatra>, [">= 1.2.6"])
-      s.add_dependency(%q<mongrel>, [">= 1.1.5"])
+      s.add_dependency(%q<mongrel>, [">= 1.2.0.pre2"])
       s.add_dependency(%q<rmagick>, ["~> 2"])
       s.add_dependency(%q<haml>, ["~> 3"])
       s.add_dependency(%q<ruby-ip>, ["~> 0.9"])
@@ -97,7 +97,7 @@ Gem::Specification.new do |s|
     end
   else
     s.add_dependency(%q<sinatra>, [">= 1.2.6"])
-    s.add_dependency(%q<mongrel>, [">= 1.1.5"])
+    s.add_dependency(%q<mongrel>, [">= 1.2.0.pre2"])
     s.add_dependency(%q<rmagick>, ["~> 2"])
     s.add_dependency(%q<haml>, ["~> 3"])
     s.add_dependency(%q<ruby-ip>, ["~> 0.9"])

metadata

@@ -1,249 +1,185 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: httpthumbnailer
-version: !ruby/object:Gem::Version 
-  hash: 19
+version: !ruby/object:Gem::Version
+  version: 0.3.1
   prerelease: 
-  segments: 
-  - 0
-  - 3
-  - 0
-  version: 0.3.0
 platform: ruby
-authors: 
+authors:
 - Jakub Pastuszek
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2012-01-16 00:00:00 Z
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  type: :runtime
-  requirement: &id001 !ruby/object:Gem::Requirement 
+date: 2012-02-07 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: &16915980 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 19
-        segments: 
-        - 1
-        - 2
-        - 6
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
         version: 1.2.6
-  prerelease: false
-  name: sinatra
-  version_requirements: *id001
-- !ruby/object:Gem::Dependency 
   type: :runtime
-  requirement: &id002 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 25
-        segments: 
-        - 1
-        - 1
-        - 5
-        version: 1.1.5
   prerelease: false
+  version_requirements: *16915980
+- !ruby/object:Gem::Dependency
   name: mongrel
-  version_requirements: *id002
-- !ruby/object:Gem::Dependency 
-  type: :runtime
-  requirement: &id003 !ruby/object:Gem::Requirement 
+  requirement: &16908960 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 7
-        segments: 
-        - 2
-        version: "2"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.2.0.pre2
+  type: :runtime
   prerelease: false
+  version_requirements: *16908960
+- !ruby/object:Gem::Dependency
   name: rmagick
-  version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  type: :runtime
-  requirement: &id004 !ruby/object:Gem::Requirement 
+  requirement: &16930760 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 5
-        segments: 
-        - 3
-        version: "3"
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
   prerelease: false
+  version_requirements: *16930760
+- !ruby/object:Gem::Dependency
   name: haml
-  version_requirements: *id004
-- !ruby/object:Gem::Dependency 
-  type: :runtime
-  requirement: &id005 !ruby/object:Gem::Requirement 
+  requirement: &16941920 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 25
-        segments: 
-        - 0
-        - 9
-        version: "0.9"
+      - !ruby/object:Gem::Version
+        version: '3'
+  type: :runtime
   prerelease: false
+  version_requirements: *16941920
+- !ruby/object:Gem::Dependency
   name: ruby-ip
-  version_requirements: *id005
-- !ruby/object:Gem::Dependency 
-  type: :runtime
-  requirement: &id006 !ruby/object:Gem::Requirement 
+  requirement: &16939780 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 19
-        segments: 
-        - 1
-        - 1
-        - 0
-        version: 1.1.0
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :runtime
   prerelease: false
+  version_requirements: *16939780
+- !ruby/object:Gem::Dependency
   name: cli
-  version_requirements: *id006
-- !ruby/object:Gem::Dependency 
-  type: :development
-  requirement: &id007 !ruby/object:Gem::Requirement 
+  requirement: &16938600 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 2
-        - 3
-        - 0
-        version: 2.3.0
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
   prerelease: false
+  version_requirements: *16938600
+- !ruby/object:Gem::Dependency
   name: rspec
-  version_requirements: *id007
-- !ruby/object:Gem::Dependency 
-  type: :development
-  requirement: &id008 !ruby/object:Gem::Requirement 
+  requirement: &16950140 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.3.0
+  type: :development
   prerelease: false
+  version_requirements: *16950140
+- !ruby/object:Gem::Dependency
   name: cucumber
-  version_requirements: *id008
-- !ruby/object:Gem::Dependency 
+  requirement: &16949100 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  requirement: &id009 !ruby/object:Gem::Requirement 
+  prerelease: false
+  version_requirements: *16949100
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &16947600 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 23
-        segments: 
-        - 1
-        - 0
-        - 0
+      - !ruby/object:Gem::Version
         version: 1.0.0
-  prerelease: false
-  name: bundler
-  version_requirements: *id009
-- !ruby/object:Gem::Dependency 
   type: :development
-  requirement: &id010 !ruby/object:Gem::Requirement 
+  prerelease: false
+  version_requirements: *16947600
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &16946620 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 7
-        segments: 
-        - 1
-        - 6
-        - 4
+      - !ruby/object:Gem::Version
         version: 1.6.4
-  prerelease: false
-  name: jeweler
-  version_requirements: *id010
-- !ruby/object:Gem::Dependency 
   type: :development
-  requirement: &id011 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        hash: 3
-        segments: 
-        - 0
-        version: "0"
   prerelease: false
+  version_requirements: *16946620
+- !ruby/object:Gem::Dependency
   name: rcov
-  version_requirements: *id011
-- !ruby/object:Gem::Dependency 
-  type: :development
-  requirement: &id012 !ruby/object:Gem::Requirement 
+  requirement: &16944680 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 1
-        segments: 
-        - 1
-        version: "1"
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
   prerelease: false
+  version_requirements: *16944680
+- !ruby/object:Gem::Dependency
   name: daemon
-  version_requirements: *id012
-- !ruby/object:Gem::Dependency 
-  type: :development
-  requirement: &id013 !ruby/object:Gem::Requirement 
+  requirement: &16969400 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 7
-        segments: 
-        - 2
-        - 2
-        version: "2.2"
+      - !ruby/object:Gem::Version
+        version: '1'
+  type: :development
   prerelease: false
+  version_requirements: *16969400
+- !ruby/object:Gem::Dependency
   name: httpclient
-  version_requirements: *id013
-- !ruby/object:Gem::Dependency 
-  type: :development
-  requirement: &id014 !ruby/object:Gem::Requirement 
+  requirement: &16966000 !ruby/object:Gem::Requirement
     none: false
-    requirements: 
+    requirements:
     - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 21
-        segments: 
-        - 3
-        - 9
-        version: "3.9"
+      - !ruby/object:Gem::Version
+        version: '2.2'
+  type: :development
   prerelease: false
+  version_requirements: *16966000
+- !ruby/object:Gem::Dependency
   name: rdoc
-  version_requirements: *id014
+  requirement: &16996480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.9'
+  type: :development
+  prerelease: false
+  version_requirements: *16996480
 description: Provides HTTP API for thumbnailing images
 email: jpastuszek@gmail.com
-executables: 
+executables:
 - httpthumbnailer
 extensions: []
-
-extra_rdoc_files: 
+extra_rdoc_files:
 - LICENSE.txt
-- README.rdoc
-files: 
+- README.md
+files:
 - .document
 - .rspec
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
-- README.rdoc
+- README.md
 - Rakefile
 - VERSION
 - bin/httpthumbnailer
@@ -275,37 +211,31 @@ files:
 - spec/thumbnail_specs_spec.rb
 - spec/thumbnailer_spec.rb
 homepage: http://github.com/jpastuszek/httpthumbnailer
-licenses: 
+licenses:
 - MIT
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
       - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+      hash: 1020802750918011065
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.8.10
+rubygems_version: 1.8.15
 signing_key: 
 specification_version: 3
 summary: HTTP thumbnailing server
 test_files: []
-

data/README.rdoc

@@ -1,19 +0,0 @@
-= httpthumbnailer
-
-Description goes here.
-
-== Contributing to httpthumbnailer
- 
-* 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
-* Fork the project
-* Start a feature/bugfix branch
-* Commit and push until you are happy with your contribution
-* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
-* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
-
-== Copyright
-
-Copyright (c) 2011 Jakub Pastuszek. See LICENSE.txt for
-further details.
-