Flipy, a new Python library for Flickr

Published:

In the past day or so I've written a new Python library for Flickr. It came from some frustration using other Python libraries. They're all great, but none of them work quite how I want.

My goal was to have a library that feels like Python and the Flickr API at the same time. I think it's worked out pretty well so far. You can make calls using the standard Flickr API calls as documented on the Flickr site, but the response objects feel like normal Python objects. For example you can do something like this:

from flipy import Flipy
flickr = Flipy(MY_API_KEY)
me = flickr.people.findByUsername(username='ianloic')
me_info = flickr.people.getInfo(user_id=me.nsid)
print 'My name is %s. I have %s photos at %s.' % (me_info.realname, me_info.photos.count, me_info.photosurl)
I've put more details about the mapping in the README.

Beyond simple mapping of methods to responses I'm working on decorating certain important response objects such as users and photos with more object oriented methods. For example right now if you have a user object you can call user.photos() and get a iterator for of a user's photos. My code takes care of all of the paging behind the scenes.

Since I haven't implemented authentication or uploading yet so right now it's mostly useful for simple mashup-style applications, but I'll get uploads and authentication complete when I get back from Jordan next week.

Check out the code on github and let me know what you think.