A wrapper for connecting to RabbitMQ which constrains clients to a single purpose channel (producer or consumer) with healing for intermittent connectivity.
Project description
talus (noun) - ta·lus | ˈtā-ləs: a slope formed especially by an accumulation of rock debris; Occasional habitat of the pika.
A wrapper for connecting to RabbitMQ which constrains clients to a single purpose channel (producer or consumer) with healing for intermittent connectivity.
Features
Guided separation of connections for producers and consumers
Re-establish connections to the server when lost
Constrained interface to support simple produce / consume use cases for direct exchanges
Installation
pip install talus
Examples
Creating a message class
from talus.message import message_class
@message_class(routing_key="message.m", queues=["message.q"])
class MyMessage:
a: str
Consumer with defaults for connection and retry
with DurableBlockingConsumerWrapper(consumer_queue='queue_name') as consumer:
for method, properties, body in consumer.consume_generator(auto_ack=True):
pass # DO Something with the message
Consumer specifying connection and retry data
with DurableBlockingConsumerWrapper(consumer_queue='queue_name',
rabbitmq_host="localhost",
rabbitmq_port5672,
rabbitmq_user='guest',
rabbitmq_pass='guest',
retry_delay=1,
retry_backoff=2,
retry_jitter=(1, 10),
retry_max_delay=300,
prefetch_count=1,
connection_name='consumer connection') as consumer:
for method, properties, body in consumer.consume_generator(auto_ack=True):
pass # DO Something with the message
Producer with defaults for connection and retry
with DurableBlockingProducerWrapper(producer_queue_bindings=[{"routing_key": "test.m", "bound_queue": "test.q"}, MyMessage.binding()],
publish_exchange='amq.direct') as producer:
producer.post('test.m', {'key': 'value'})
producer.publish_message(MyMessage(a="s")) # using the message class from an earlier example
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file talus-1.0.0rc1.tar.gz
.
File metadata
- Download URL: talus-1.0.0rc1.tar.gz
- Upload date:
- Size: 18.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.11.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9ad6148c9d5a64df8a7f3003622b74dbd9efcd6ecf079bf238eed3a44ba8e96a |
|
MD5 | 371c58e4b13a37caae890a711b4c3c88 |
|
BLAKE2b-256 | 6d019fe3b44ce902dcda940294c96570026287fa7a5741a189a0ee0f13d7622f |
Provenance
File details
Details for the file talus-1.0.0rc1-py3-none-any.whl
.
File metadata
- Download URL: talus-1.0.0rc1-py3-none-any.whl
- Upload date:
- Size: 22.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.0.0 CPython/3.11.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cc009a199c363e1d05174a29da1383014715b829df1fbf5162c0ebfe4fb3cd5f |
|
MD5 | fca707869c683607908052a239beea44 |
|
BLAKE2b-256 | 366e9acc5a596b4daed02f7c80bc0d47fc507457169b5a9ecbd803319317634b |