azure-eventhub 0.2.0rc1

Microsoft Azure Event Hubs Client Library for Python

Microsoft Azure SDK for Event Hubs

A Python AMQP client for Azure Event Hubs the provides:

• A sender to publish events to the Event Hubs service.

• A receiver to read events from the Event Hubs service.

On Python 3.5 and above, it also includes:

• An async sender and receiver that supports async/await methods.

• An Event Processor Host module that manages the distribution of partition readers.

Installation

Wheels are provided for all major operating systems, so you can install directly with pip:

$ pip install azure-eventhub

Python 2.7 support

The uAMQP library currently only supports Python 3.4 and above. Python 2.7 support is planned for a future release.

Examples

• ./examples/send.py - use sender to publish events

• ./examples/recv.py - use receiver to read events

• ./examples/send_async.py - async/await support of a sender

• ./examples/recv_async.py - async/await support of a receiver

• ./examples/eph.py - event processor host

Logging

• enable ‘azure.eventhub’ logger to collect traces from the library

• enable ‘uamqp’ logger to collect traces from the underlying uAMQP library

• enable AMQP frame level trace by setting debug=True when creating the Client

Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the Issues section of the project.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [e-mail] with any additional questions or comments.

Release History

0.2.0rc1 (2018-07-06)

• Breaking change Restructured library to support Python 3.7. Submodule async has been renamed and all classes from this module can now be imported from azure.eventhub directly.

• Breaking change Removed optional callback argument from Receiver.receive and AsyncReceiver.receive.

• Breaking change EventData.properties has been renamed to EventData.application_properties. This removes the potential for messages to be processed via callback for not yet returned in the batch.

• Updated uAMQP dependency to v0.1.0

• Added support for constructing IoTHub connections.

• Fixed memory leak in receive operations.

• Dropped Python 2.7 wheel support.

0.2.0b2 (2018-05-29)

• Added namespace_suffix to EventHubConfig() to support national clouds.

• Added device_id attribute to EventData to support IoT Hub use cases.

• Added message header to workaround service bug for PartitionKey support.

• Updated uAMQP dependency to vRC1.

0.2.0b1 (2018-04-20)

• Updated uAMQP to latest version.

• Further testing and minor bug fixes.

0.2.0a2 (2018-04-02)

• Updated uAQMP dependency.

0.2.0a1 (unreleased)

• Swapped out Proton dependency for uAMQP.