Picothumbs

== Description
Picothumbs is a ruby gem to allow easy access the web thumbnail generation service at http://www.picothumbs.com

== Installation
sudo gem install arndtjenssen-picothumbs -s http://gems.github.com

== Usage
You need to register (for free) at www.picothumbs.com and retrieve your api-key and storage-key from the profile page.

Then in your (rails) application you can do:

# create a service request class
thumbs = Picothumbs.new("your-api-key", "your-storage-key")

# request to create the thumbnail from google.com
thumb.simple_request("www.google.com")
> request-key

# poll if the thumbnail has been created
thumbs.poll
> one of: "ok" or "queued"

# download the thumbnail to a local path with a specific size
thumbs.download("/tmp", Picothumbs::MEDIUM)
> stores a thumbnail in tmp

For other possible sizes see http://www.picothumbs.com/features

== Gem Home
* Github Home: http://github.com/arndtjenssen/picothumbs
* Gem Home: http://www.picothumbs.com/ruby_gem


== Limitations
Very first version does cover only simple api requests.

== Todos
* Create specs
* Add rdoc
* Make request fault tolerant
* Add REST API requests