public
Fork of hanklords/flickraw
Description: Library to access flickr api ( http://www.flickr.com/services/api ) It follows closely the syntax described there.
Homepage: http://flickraw.rubyforge.org
Clone URL: git://github.com/benschwarz/flickraw.git
name age message
file README Thu Apr 24 05:21:07 -0700 2008 Version 0.4.1 [hanklords]
file Rakefile Sat Jul 04 19:51:06 -0700 2009 Readding rake file after some gem build issues [benschwarz]
file copying.txt Thu Apr 24 05:10:22 -0700 2008 Add MIT license [hanklords]
directory examples/ Thu Apr 24 05:21:07 -0700 2008 clean [hanklords]
file flickraw.gemspec Loading commit data...
file flickraw_rdoc.rb Thu Apr 24 05:21:07 -0700 2008 It uses now JSON output from flickr parsed with... [hanklords]
directory lib/
directory test/ Thu Apr 24 05:21:08 -0700 2008 Fix a bug with signing escaped strings. Thanks ... [hanklords]
README
= Flickraw

Flickraw is a library to access flickr[http://flickr.com] api in a simple way.
It maps exactly the methods described in {the official api documentation}[http://www.flickr.com/services/api].
It also try to present the data returned in a simple and intuitive way.
The methods are fetched from flickr when loading the library by using introspection capabilities. So it is always 
up-to-date with regards to new methods added by flickr.

You can read the class documentation here : FlickRaw.

The rubyforge project : http://rubyforge.org/projects/flickraw

= Installation
Type this in a console (you might need to be superuser)
 gem install flickraw

You can recreate this documentation by typing this in the source directory:
 rake rdoc

= Usage

 require 'flickraw'

 list   = flickr.photos.getRecent

 id     = list[0].id
 secret = list[0].secret
 info = flickr.photos.getInfo :photo_id => id, :secret => secret

 info.title           # => "PICT986"
 info.dates.taken     # => "2006-07-06 15:16:18"


 sizes = flickr.photos.getSizes :photo_id => id

 original = sizes.find {|s| s.label == 'Original' }
 original.width       # => "800"

See the _examples_ directory to find more examples.

= Notes
If you want to use the api authenticated with several user at the same time, you must pass the authentication token 
explicitely each time.
This is because it is keeping the authentication token internally.
As an alternative, you can create new Flickr objects besides Object.flickr which is created for you. Use Flickr.new to 
this effect.