What problem does it solve?
Provides a reliable, production-ready Python interface for ingesting and processing high-throughput event streams with Azure Event Hubs, removing the complexity of partitioning, checkpointing, and client lifecycle management.
Core Features & Use Cases
- Producers and Consumers: Examples and patterns for EventHubProducerClient and EventHubConsumerClient in both sync and async flavors.
- Checkpointing: BlobCheckpointStore integration and multiple checkpointing strategies (per-event, batch, time-based, hybrid).
- Partitioning & Load Balancing: Guidance for partition keys, explicit partition sends, and consumer load balancing with ownership events.
- Operational Utility: CLI script for inspecting Event Hub properties, partition details, sending test events, and receiving with optional checkpointing.
- Best Practices: Use of DefaultAzureCredential, context managers for clients, error handling and graceful shutdown patterns.
Quick Start
Use the azure-eventhub-py skill to send test events to my-eventhub and run a checkpointed consumer using DefaultAzureCredential and a BlobCheckpointStore.