Imapclient

================

Switch back to setuptools now that distribute and setuptools have
merged back. Some users were reporting problems with distribute and
the newer versions of setuptools.

================

================

Fixed regressions in several cases when binary data (i.e. normal
strings under Python 2) are used as arguments to some methods. Also
refactored input normalisation functions somewhat.

Fixed buggy method for extracting flags and Gmail labels from STORE
responses.

==============

==============

Python 3 support (22) [API CHANGE]
-----------------------------------
Python 3.2 and 3.3 are now officially supported. This release also
means that Python versions older than 2.6 are no longer supported.

A single source approach has been used, with no conversion step required.

A big thank you to Mathieu Agopian for his massive contribution to
getting the Python 3 port finished. His changes and ideas feature
heavily in this release.

**IMPORTANT**: Under Python 2, all strings returned by IMAPClient are now
returned as unicode objects. With the exception of folder names, these
unicode objects will only contain characters in the ASCII range so
this shouldn't break existing code, however there is always a chance
that there will be a problem. Please test your existing applications
thoroughly with this verison of IMAPClient before deploying to
production situations.

Minor Changes
-------------
* "python setup.py test" now runs the unit tests
* Mock library is now longer included (listed as external test dependency)
* live tests that aren't UID related are now only run once
* live tests now perform far less logins to the server under test
* Unit tests can now be run for all supported Python versions using ``tox``.
* Improved documentation regarding working on the project.
* Many documentation fixes and improvements.

Minor Bug Fixes
---------------
* HIGHESTMODSEQ in SELECT response is now parsed correctly
* Fixed daylight saving handling in FixedOffset class
* Fixed --port command line bug in imapclient.interact when SSL
connections are made.

===============

===============

THREAD support [NEW]
--------------------
The IMAP THREAD command is now supported. Thanks to Lukasz Mierzwa for
the patches.

Enhanced capability querying [NEW]
----------------------------------
Previously only the pre-authentication server capabilities were
returned by the capabilities() method. Now, if the connection is
authenticated, the post-authentication capabilities will be returned.
If the server sent an untagged CAPABILITY response after authentication,
that will be used, avoiding an unnecessary CAPABILITY command call.

All this ensures that the client sees all available server
capabilities.

Minor Features
--------------
* Better documentation for contributers (see HACKING file)
* Copyright date update for 2013.

===============

===============

Stream support [NEW]
--------------------
It is now possible to have IMAPClient run an external command to
establish a connection to the IMAP server via a new *stream* keyword
argument to the initialiser. This is useful for exotic connection or
authentication setups. The *host* argument is used as the command to
run.

Thanks to Dave Eckhardt for the original patch.

OAUTH2 Support [NEW]
--------------------
OAUTH2 authentication (as supported by Gmail's IMAP) is now available
via the new oauth2_login method. Thanks to Zac Witte for the original
patch.

livetest now handles Gmail's new message handling
-------------------------------------------------
Gmail's IMAP implementation recently started requiring a NOOP command
before new messages become visible after delivery or an APPEND. The
livetest suite has been updated to deal with this.

=============

=============

Gmail Label Support
-------------------
New methods have been added for interacting with Gmail's label API:
get_gmail_labels, add_gmail_labels, set_gmail_labels,
remove_gmail_labels. Thanks to Brian Neal for the patches.

Removed Code Duplication (9)
-----------------------------
A signficant amount of duplicated code has been removed by abstracting
out common command handling code. This will make the Python 3 port and
future maintenance easier.

livetest can now be run against non-dummy accounts (108)
---------------------------------------------------------
Up until this release the tests in imapclient.livetest could only be
run against a dummy IMAP account (all data in the account would be
lost during testing). The tests are now limited to a sub-folder
created by the tests so it is ok to run them against an account that
contains real messages. These messages will be left alone.

Minor Features
--------------
* Don't traceback when an IMAP server returns a all-digit folder name
without quotes. Thanks to Rhett Garber for the bug report. (107)
* More tests for ACL related methods (89)
* More tests for namespace()
* Added test for read-only select_folder()

Minor Bug Fixes
---------------
* Fixed rename live test so that it uses folder namespaces (100).
* Parse STATUS responses robustly - fixes folder_status() with MS
Exchange.
* Numerous livetest fixes to work around oddities with the MS
Exchange IMAP implementation.

===============