azure-uamqp-python

API is now stable!
No breaking changes in this release but a few behavioural changes:

• When a SendClient or SendClientAsync is shutdown, any remaining pending messages (that is messages in the states WaitingToBeSent and WaitingForSendAck) will no longer be cleared, but can be retrieved from a new attribute SendClient.pending_messages in order to be re-processed as needed.

• The function SendClient.queue_message now allows for queueing multiple messages at once by simply passing in additional message instances:

  • send_client.queue_message(my_message)
  • send_client.queue_message(message_1, message_2, message_3)
  • send_client.queue_message(*my_message_list)

• An authentication object will now raise a ValueError if one attempts to use it for more than one connection.

• Renamed internal _async module to non-private async_ops to allow for docs generation.

• Reformatted logging for better performance.

• Added additional logging.

Some stability improvements in the bindings.

• Fixed potential crashing in bindings for amqpvalue.
• Fixed bindings fault in cbs PUT token complete callback.
• Added additional auth and connection locking for thread/async safety.
• Increased INFO level logging.
• Added handling for a connection reaching a client-caused error state.

Some internal breaking changes to the MessageSender/MessageReceiver classes and their async equivalents.
New features:

• Optional keep-alive background process for keep unused connections active.
• Added ability to supply an ErrorPolicy to a client to determine how the client should handle a vendor specific error occurring in either a message disposition, link detach or connection close event.
• Now parsing standard AMQP errors for retryability - and surfacing error details to the user.
• Added support for HTTP proxy configuration.

For all changes, please see the release notes.

Bug fix release:

• Removed circular dependency in Python 3.4 with types.py/utils.py
• When a header properties is not set, returns None rather than raising ValueError.
• Fixed bug in receiving messages with application properties.

First stable release!
No breaking changes - only bug fixes.

For all changes, please see the release notes.

Breaking changes

• This release includes a restructure to support Python 3.7. The async submodule has been renamed and all classes within it can now be imported directly from uamqp or uamqp.authentication.
• Anything returned by a callback supplied to receive messages will now be ignored.
• Changed message state enum values:
  • Complete -> SendComplete
  • Failed -> SendFailed
  • WaitingForAck -> WaitingForSendAck
• Changes to message settlement exceptions:
  • Combined the AbandonMessage and DeferMessage exceptions as MessageModified to be in keeping with the AMQP specification.
  • Renamed AcceptMessage to MessageAccepted.
  • Renamed RejectMessage to MessageRejected which now takes condition and description arguments rather than message.

For additional non-breaking changes, please see the release notes.

• Fixed import error in async receiver.
• Exposed sender/receiver destroy function.
• Moved receiver.open on_message_received argument to constructor.
• Removed sasl module and moved internal classes into authentication module.
• Added encoding parameter everywhere where strings are encoded.
• Started documentation.
• Updated uAMQP-C to 1.2.4 and C Shared Utility to 1.1.4 (includes fix for issue #12).
• Fixed return type of MgmtOperation.execute - now returns ~uamqp.Message.
• Made AMQP connection/session/sender/receiver types in a client overridable.
• Added debug trace to management operations.
• Fixed error in management callback on failed operation.
• Default AMQP encoding of bytes is now a String type and a bytearray is a Binary type.
• Added AMQP Array type and fixed Long type range validation.
• Added header argument to Message and BatchMessage for setting a MessageHeader.
• Fixed MessageHeader attribute setters.

• Fixed dynamic cert reference for OpenSSL. Now install ca-certificates on Linux is no longer required.

• Fixed memory leak in async receive.
• Removed close_on_done argument from client receive functions.
• Added receive iterator to synchronous client.
• Made async iter receive compatible with Python 3.5.

• Fixed SSL errors in manylinux wheels.
• Fixed message annoations attribute.
• Fixed bugs in batched messages and sending batched messages.
• Fixed conflicting receiver link ID.
• Fixed hanging receiver by removing queue max size in sync clients.
• Added support for sending messages with None and empty bodies.

Installation notes

• When installing on Linux, the CA certificate bundle must also be installed.
• Only High Sierra is supported when installing from source on MacOSX

• Added management request support.
• Fixed message-less C operation ValueError.
• Store message metadata in Python rather than C.
• Refactored Send and Receive clients to create a generic parent AMQPClient.
• Fixed None receive timestamp bug.
• Removed async iterator queue due to instabilities - all callbacks are now synchronous.

Installation notes:

• Source install (i.e. using --no-binary) is currently only available for Linux.
• If you are running Mac OSX < 10.13 (High Sierra), please let us know if you encounter any compatibility issues.

Release includes some bug fixes as well as new features.

• Added support for asynchronous message receive by iterator or batch.
• Removed synchronous receive iterator, and replaced with synchronous batch receive.
• Added sync and async context managers for Send and Receive Clients.
• Fixed token instability and added put token retry policy.
• Exposed Link ATTACH properties.
• A connection now has a single $cbs session that can be reused between clients.
• Added C debug trace logging to the Python logger (‘uamqp.c_uamqp’)

Installation notes:

• Source install (i.e. using --no-binary) is currently only available for Linux.
• If you are running Mac OSX < 10.13 (High Sierra), please let us know if you encounter any compatibility issues.

Preview release.

Installation notes:

• Source install (i.e. using --no-binary) is currently only available for Linux.
• If you are running Mac OSX < 10.13 (High Sierra), please let us know if you encounter any compatibility issues.