Flickrapi

--------------------------------

- Added ElementTree support for Python 2.4.
[[ Patch 2007996 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=2007996&group_id=203043&atid=984008)
- Made ElementTree the default response parser.
- The upload and replace methods now take a `format` parameter.
[[ Feature request 1912606 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1912606&group_id=203043&atid=984009)
- Removed deprecated methods.
- `upload` and `replace` methods no longer report progress on their callback
regarding the HTTP headers.

--------------------------------

- Tab completion of all Flickr API functions in IPython.
- Fix for a bug where a crash occurred when XML containing
a `<name />` element was parsed with XMLNode.
- Deprecated a number of methods for old-style error handling, including the
`fail_on_error` constructor parameter. Just handle the `FlickrError` exceptions
instead of explicitly testing all method calls. The deprecated methods will be
completely removed in release 1.2.
- Implemented a response parser system, which still parses to XMLNode objects by
default. It now also includes parsing to the Python standard ElementTree, which will
soon replace XMLNode as the default response parser. See the
[documentation](http://flickrapi.sf.net/flickrapi.html) on how to use the new parsers.
- Added `format` constructor parameter to set the default response format for all
method calls. Overriding per call is still possible.
- Added `store_token` constructor parameter that's `True` by
default. Set to `False` to ensure the on-disk token cache isn't
used. [[ Feature request 1923728 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1923728&group_id=203043&atid=984009)
- Added caching framework. Pass `cache=True` to the constructor to
use it. [[ Feature request 1911450 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1911450&group_id=203043&atid=984009)

--------------------------------

- Added [API documentation](http://flickrapi.sf.net/apidoc/). [[ Feature request 1834460 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1834460&group_id=203043&atid=984009)

- Lot of code improvements, most of them renaming of the public
interface to the Python coding standard described in PEP 8. The
exact publicly visible changes are described in the UPGRADING file.
[[ Feature request 1773473 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1773473&group_id=203043&atid=984009)
- Added multi-user support to the authentication token cache.
[[ Feature request 1874067 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1874067&group_id=203043&atid=984009)
- Support for web applications.
[[ Feature request 1896701 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1896701&group_id=203043&atid=984009)
- Passing `format='rest'` results in unparsed XML from the REST
request. [[ Feature request 1834459 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1834459&group_id=203043&atid=984009)
- Removed `uuid` module and replaced it with our own random MIME boundary generator.
- Improved code and package documentation.

--------------------------------

- Support for unauthenticated, read-only access to the Flickr API.
[[ Feature request 1802210 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1802210&group_id=203043&atid=984009)
- Deprecated the `getToken(...)` method. Use
`getTokenPartOne(...)` and `getTokenPartTwo(...)` instead.
- Better Windows compatibility by opening JPEG files in binary mode.

--------------------------------

- `upload` method allows for the application to receive progress
information regarding running uploads.
[[ Feature request 1793276 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1793276&group_id=203043&atid=984009)

- Preliminary support for different response formats. If a format
other than the default REST is chosen, the raw response will be
returned to the caller without parsing.
- Python 2.4 compatibility.
- Uses the `webbrowser` Python module to start a webbrowser, instead
of doing it ourselves. This will greatly improve the platform
independence of applications.
[[ Feature request 1793350 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1793350&group_id=203043&atid=984009)

Please note that this changes the API itself - you can no longer
pass the 'browser' and 'fork' parameters to the `getTokenPartOne(...)`
method call. The `webbrowser` module figures out what to do by
itself.

--------------------------------

- No longer allow passing `jpegData` to the `upload` or
`replace` methods. The code handling it was buggy. If you're
actually using the `jpegData` parameter of those functions, let us
know and we might restore the functionality in a proper way.
- Full Unicode compatibility. Pass strings as `unicode` objects, and
they'll be automatically encoded as UTF-8 before sending to Flickr.
[[ Bug report 1779463 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1779463&group_id=203043&atid=984006)
- Introduced unittests. Not everything is covered yet, but we've got a
good start.
[[ Feature request 1773475 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1773475&group_id=203043&atid=984009)
- Refactored the upload/replace methods.
[[ Feature request 1778905 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1778905&group_id=203043&atid=984009)
- Gracefully handle corrupt or otherwise invalid data in the token
cache.
[[ Feature request 1781236 ]](http://sourceforge.net/tracker/index.php?func=detail&aid=1781236&group_id=203043&atid=984009)