The serialization layer was making hardcoded assumptions about how
short strings were encoded (utf-8). Add 'encoding' parameters
to AMQPWriter.write_shortstr() and AMQPReader.read_shortstr()
so the encoding can be controlled at a higher level. By default
though those two methods act as before. Thanks to 'angrybaldguy'
for bringing this up. (Copied from main branch)

Minor tweak to ensure the Channel class is included in pydocs, no real change
in the client's behavior.

Sync up CHANGES file with version 0.6.1

Close TCP sockets when there's an error connecting, to keep file descriptors
from piling up. Thanks todmitriy.samovskiy@... for pointing this out.

Fix minor typo in docs

denis.bilenko@... pointed out a couple try/except blocks that catch too much,
potentially preventing stop operations like KeyboardInterrupt from working.

Make it so that the upper levels see the exceptions raised by the lower levels,
instead of nonsense exceptions like:
TypeError: 'NoneType' object is not iterable
when something like a socket closure happens.

Get rid of the __del__ methods in Connection and Channel classes, which
allows them to be garbage collectible if references to them are lost, because
they form a cycle, and Python won't GC cyclical references that have __del__
methods.

Users really should use the .close() methods or 'with' statements
to make sure things are cleaned up properly. But failing that, this
change will at least ensure there's not a big leak including a TCP socket.

Add unittests provided by majek04@... checking that objects from this
module are garbage-collectable if references to them are dropped.

Add some documentation about using 'with' statements.

Add support for using Connection and Channel objects in Python 'with'
statements.

Document the recent changes and change the version number so as not to be confused
with the original 0.6 version.

Fix problem with dangling reference loops after Connections close. Thanks
to majek04@... for pointing this out.

Make sure any while loops in the transport module raise IOError exceptions
if a socket can't be read from or written to. i Thanks majek04@... for
pointing this out.

Restore the thread-related code that was temporarily removed for 0.6.

Added tag 0.6 for changeset dbf98c6e962a

Temporarily remove the thread-related development code, so the rest of
the improvements can be packaged as a new release.

Polish up the docs a bit, including a warning to be sure to
close Connection or Channel objects otherwise you could
lose messages when the program ends.

Have the Connection initializer actually behave the way the docs
have implied for a long time - supplying default values for host
(localhost) userid and password (guest, guest).

Combine the two different SSL transports, turns out they're not that different.