flickrapi

view UPGRADING @ 260:c05c7cc319b1

Added signature for changeset 2a50a09d2e7e
author Sybren A. Stüvel <sybren@stuvel.eu>
date Thu Feb 18 11:57:46 2010 +0100 (5 months ago)
parents 5b3a355d3450
children
line source
1 Upgrading from previous versions
2 =================================
4 From 1.1
5 ---------------------------------
7 Some methods have been deprecated in version 1.1, which are now
8 removed. Those are the class methods:
10 - test_failure
11 - get_printable_error
12 - get_rsp_error_code
13 - get_rsp_error_msg
15 The default parser format has been changed from XMLNode to
16 ElementTree. Either convert your code to use the new ElementTree
17 parser, or pass the ``format='xmlnode'`` parameter to the FlickrAPI
18 constructor.
20 The upload and replace methods now use the format parameter, so if you
21 use ElementTree as the parser, you'll now also get an ElementTree
22 response from uploading and replacing photos. To keep the old
23 behaviour you can pass ``format='xmlnode'`` to those methods.
25 From 0.15
26 ---------------------------------
28 A lot of name changes have occurred in version 0.16 to follow PEP 8.
29 Some properties have also had their name shortened. For example, an
30 ``XMLNode`` now has a ``text`` property instead of ``elementText``.
31 After all, the nodes describe XML elements, so what other text would
32 there be?
34 Here is a complete list of the publicly visible changes, broken down
35 per class. Changes in the internals of the FlickrAPI aren't documented
36 here.
38 ``FlickrAPI``
39 The constructor has its parameter ``apiKey`` changed to
40 ``api_key``.
42 All methods names that were originally in "camelCase" are now
43 written in Python style. For example, ``getTokenPartOne`` has been
44 changed to ``get_token_part_one``. The same is true for the class
45 variables that point to the Flickr API URLs. For example,
46 ``flickrHost`` became ``flickr_host``.
48 ``send_multipart`` became a private method.
50 The ``main`` method was removed. It only served as a simple
51 example, which was obsoleted by the documentation.
53 ``XMLNode``
54 The method ``parseXML`` has become ``parse``, since it can't parse
55 anything but XML, so there is no need to state the obvious.
57 Properties ``elementName`` and ``elementText`` have been renamed
58 to ``name`` resp. ``text``.