Nelson's Weblog: tech / good / flickrClient

Simple web service invocation

FlickrClient.py is good software. It's a Python library for the 68 methods in the Flickr API in 48 lines of code. Such parsimony! Here's the nut of it:

def __getattr__(self, method):
  def method(_self=self, _method=method, **params):
    _method = _method.replace("_", ".")
    url = HOST + PATH + "?method=%s&%s&api_key=%s" %
          (_method, urlencode(params), self.api_key)
    try: rsp = xmltramp.load(url)
    except: return None
    return _self._parseResponse(rsp)

If you're not familiar with Python, what's going on here is a bit of metaprogramming genius. The __getattr__ makes it so that FlickrClient.foo() automatically means "invoke the Flickr API call foo", for any API call. The method() code builds a URL out of the Python method name foo and the parameters the method was invoked with, then does a GET to Flickr. Because of the consistent naming of the Flickr REST API this all works like you'd expect.

Parsing the response data is done by passing the Flickr XML to xmltramp, a quick and dirty Python XML binding that does what you want. The _parseResponse() method (not shown) does error handling in four lines.

I love how simple and Pythonic this is. Data is loosely typed. API calls are built dynamically. Everything is so abstract that the library code doesn't even have to be updated when new API methods or datatypes are added to Flickr. Clean, simple, perfect for scripting. It's about the exact opposite of SOAP and WSDL where you typically use thousands of lines of generated code to call the service. The WSDL approach gives you strong typing, which can be helpful, but can also be a dual edged sword.

tech • good
2005-05-15 19:59 Z


Mastodon @nelson@tech.lgbt Linkblog Fri 2024-04-19 Balatro Immolate Turning Point voting fraud Thu 2024-04-18 Bicycles of World War II AI-ese Mon 2024-04-15 Butterick’s Practical Typography Wicked Bible Sat 2024-04-13 Normalization of Jan 6 Followgraph for Mastodon South Yuba Canal Fri 2024-04-12 Waffle House order marking Wed 2024-04-10 Boy Meets Boy Meets Boys’ Love Termux Tue 2024-04-09 Netflitwitter Nigeria’s Scrabble King Internet eclipse traffic Electric rickshaws Mon 2024-04-08 Eclipse power dashboard Windows terminal latency Grass Valley pasties Django's left hand Search Archives 2023 12 11 10 09 08 07 06 05 04 03 02 01 2022 12 11 10 09 08 07 06 05 04 03 02 01 2021 12 11 10 09 08 07 06 05 04 03 02 01 2020 12 11 10 09 08 07 06 05 04 03 02 01 2019 12 11 10 09 08 07 06 05 04 03 02 01 2018 12 11 10 09 08 07 06 05 04 03 02 01 2017 12 11 10 09 08 07 06 05 04 03 02 01 2016 12 11 10 09 08 07 06 05 04 03 02 01 2015 12 11 10 09 08 07 06 05 04 03 02 01 2014 12 11 10 09 08 07 06 05 04 03 02 01 2013 12 11 10 09 08 07 06 05 04 03 02 01 2012 12 11 10 09 08 07 06 05 04 03 02 01 2011 12 11 10 09 08 07 06 05 04 03 02 01 2010 12 11 10 09 08 07 06 05 04 03 02 01 2009 12 11 10 09 08 07 06 05 04 03 02 01 2008 12 11 10 09 08 07 06 05 04 03 02 01 2007 12 11 10 09 08 07 06 05 04 03 02 01 2006 12 11 10 09 08 07 06 05 04 03 02 01 2005 12 11 10 09 08 07 06 05 04 03 02 01 2004 12 11 10 09 08 07 06 05 04 03 02 01 2003 12 11 10 09 08 07 06 05 04 03 02 01 2002 12 11 10 09 08 07 06 05 04 03 02 01 2001 12 11 10 09 08 07 One good site MDN Nelson Minar nelson@monkey.org Blog licensed under a Creative Commons License		Simple web service invocation FlickrClient.py is good software. It's a Python library for the 68 methods in the Flickr API in 48 lines of code. Such parsimony! Here's the nut of it: def __getattr__(self, method): def method(_self=self, _method=method, **params): _method = _method.replace("_", ".") url = HOST + PATH + "?method=%s&%s&api_key=%s" % (_method, urlencode(params), self.api_key) try: rsp = xmltramp.load(url) except: return None return _self._parseResponse(rsp) If you're not familiar with Python, what's going on here is a bit of metaprogramming genius. The `__getattr__` makes it so that `FlickrClient.foo()` automatically means "invoke the Flickr API call `foo`", for any API call. The `method()` code builds a URL out of the Python method name `foo` and the parameters the method was invoked with, then does a `GET` to Flickr. Because of the consistent naming of the Flickr REST API this all works like you'd expect. Parsing the response data is done by passing the Flickr XML to xmltramp, a quick and dirty Python XML binding that does what you want. The `_parseResponse()` method (not shown) does error handling in four lines. I love how simple and Pythonic this is. Data is loosely typed. API calls are built dynamically. Everything is so abstract that the library code doesn't even have to be updated when new API methods or datatypes are added to Flickr. Clean, simple, perfect for scripting. It's about the exact opposite of SOAP and WSDL where you typically use thousands of lines of generated code to call the service. The WSDL approach gives you strong typing, which can be helpful, but can also be a dual edged sword. tech • good 2005-05-15 19:59 Z Nelson's Weblog • tech • good