= imgur

A simple ruby interface to the imgur image hosting service (http://imgur.com). This is a nice alternative to uploading images and not having to deal with RMagick bs.

== Requirements

* Grab a imgur api key : http://imgur.com/register/api/

== Examples 

  # Uploading an image to imgur from the filesystem
  
  img = Imgur::API.new 'YOURAPIKEY'
  uploaded_img = img.upload_file '/path/to/your/test.jpg'
  # should return a hash like:
  # => {"small_thumbnail"=>"http://imgur.com/NfuKFs.png", 
        "original_image"=>"http://imgur.com/NfuKF.png", 
        "large_thumbnail"=>"http://imgur.com/NfuKFl.png", 
        "delete_hash"=>"VAiPkk5NoQ", "imgur_page"=>"http://imgur.com/NfuKF", 
        "delete_page"=>"http://imgur.com/delete/VAiPkk5NoQ", 
        "image_hash"=>"NfuKF"}
  # now you can do something like (if you're using rails):
  <%= image_tag uploaded_img["small_thumbnail"] %>
  
  # Here's an example using Sinatra and Sequel, requires sinatra-more
  
  # Everything's included into one action for brevity, although you can probably extract the file functions to a helper for organizational purposes
  
  post '/upload_photo' do 
    # let's assume we have this is in our form
    # <%= file_field_tag :photo %>
    file_name = params[:photo][:filename].split(".").first.gsub!(/[^a-z0-9]+/i, '_')
    file_type = params[:photo][:filename].split(".").last
    tmp_file_path = File.join(APP_ROOT,"public/images/tmp/#{file_name}.#{file_type}")
    FileUtils.mv params[:photo][:tempfile].path, tmp_file_path
    
    unless params["photo"].blank? || params["photo"].nil?
      @uploaded_img = IMGUR.upload_file tmp_file_path
    end
    
    @photo = Photo.new(:photo => @uploaded_img)
    @photo.save
    
    redirect '/results'
  end
  
    
== Note on Patches/Pull Requests
 
* Fork the project.
* Make your feature addition or bug fix.
* Add tests for it. This is important so I don't break it in a
  future version unintentionally.
* Commit, do not mess with rakefile, version, or history.
  (if you want to have your own version, that is fine but
  bump version in a commit by itself I can ignore when I pull)
* Send me a pull request. Bonus points for topic branches.

== Copyright

Copyright (c) 2009 jdp. See LICENSE for details.