class TestConfirmMode(unittest.TestCase):
"""
Test the confirm mode functionality of RMQProducer.
"""
@patch("rabbitmq_client.producer.RMQProducer.start")
def setUp(self, _connection_start) -> None:
"""Setup to run before each test case."""
self.producer = RMQProducer()
self.producer.start()
self.producer.on_ready() # Fake connection getting ready
self.producer.confirm_delivery = Mock()
self.producer.declare_exchange = Mock()
self.producer.basic_publish = Mock()
def test_activate_confirm_mode(self):
"""
Verify that confirm mode, when activated, yields the expected state.
"""
# Prep
confirm_mode_started = False
def notify_callback(confirm):
nonlocal confirm_mode_started
if isinstance(confirm, ConfirmModeOK):
confirm_mode_started = True
# Test
self.producer.activate_confirm_mode(notify_callback)
self.producer.confirm_delivery.assert_called_with(
self.producer.on_delivery_confirmed,
callback=self.producer.on_confirm_select_ok)
self.assertFalse(self.producer._confirm_mode_active)
self.producer.on_confirm_select_ok(Mock())
# Assert
self.assertTrue(confirm_mode_started)
self.assertTrue(self.producer._confirm_mode_active)
def test_confirm_mode_publish_key_returned_by_publish(self):
"""
Verify that a publish key is generated and returned by publish if
confirm mode is activated.
"""
# Prep
publish_key = None
def on_confirm(delivery_notification):
if delivery_notification == publish_key:
return
elif isinstance(delivery_notification, ConfirmModeOK):
return
self.fail("delivery notification did not match the generated "
"publish key")
self.producer.activate_confirm_mode(on_confirm)
self.producer.confirm_delivery.assert_called_with(
self.producer.on_delivery_confirmed,
callback=self.producer.on_confirm_select_ok)
self.producer.on_confirm_select_ok(None)
exchange_params = ExchangeParams("exchange")
# Test
publish_key = self.producer.publish(b"body",
exchange_params=exchange_params)
self.producer.declare_exchange.assert_called()
self.producer.on_exchange_declared(b"body",
exchange_params,
None,
publish_key=publish_key)
self.producer.basic_publish.assert_called_with(
b"body",
exchange=exchange_params.exchange,
routing_key="",
publish_params=ANY)
# 1 is the delivery tag
self.assertEqual(self.producer._unacked_publishes[1], publish_key)
frame = Mock()
ack = Basic.Ack()
ack.delivery_tag = 1
frame.method = ack
self.producer.on_delivery_confirmed(frame)
self.assertEqual(len(self.producer._unacked_publishes.keys()), 0)
def test_on_ready_initiates_confirm_mode_again(self):
"""
Verify that after connectivity issues, on_ready will re-start confirm-
mode.
"""
# Prep
self.producer.activate_confirm_mode(lambda _:...)
# Test
self.producer.on_ready()
# Assert
self.producer.confirm_delivery.assert_called_with(
self.producer.on_delivery_confirmed,
callback=self.producer.on_confirm_select_ok)
def test_delivery_not_acked_leads_to_delivery_error(self):
"""
Verify that if a delivery confirmation is NOT an ack, a delivery error
is propagated to the delivery notify callback.
"""
# Prep
got_error = False
def on_confirm(error):
nonlocal got_error
got_error = True
if isinstance(error, DeliveryError):
self.assertEqual("123", error.publish_key)
self.producer.activate_confirm_mode(on_confirm)
self.producer._unacked_publishes[1] = "123"
# Test
frame = Mock()
frame.method = Basic.Nack()
frame.method.delivery_tag = 1
self.producer.on_delivery_confirmed(frame)
# Assert
self.assertTrue(got_error)
def test_activate_confirm_mode_idempotent(self):
"""
Verify that calling activate_confirm_mode more than once has no effect,
and will yield the same result as calling it once.
"""
# Prep
def on_confirm():
...
# Test + assert
self.producer.activate_confirm_mode(on_confirm)
self.producer.activate_confirm_mode(on_confirm)
self.producer.confirm_delivery.assert_called_once()
def test_confirm_mode_delays_buffer_until_confirm_mode_ok(self):
"""
Verify that, if confirm mode has been activated, buffered publishes
are not sent on 'on_ready', but rather 'on_confirm_select_ok'.
"""
# Prep
self.producer.activate_confirm_mode(lambda _:...)
self.producer.on_close()
exchange_params = ExchangeParams("exchange")
# Test + assertions
_pub_key = self.producer.publish(b"body",
exchange_params=exchange_params)
self.assertNotEqual(_pub_key, None)
self.producer.declare_exchange.assert_not_called()
self.assertEqual(len(self.producer._buffered_messages), 1)
self.producer.on_ready()
self.producer.declare_exchange.assert_not_called()
self.assertEqual(len(self.producer._buffered_messages), 1)
self.producer.on_confirm_select_ok(Mock())
self.producer.declare_exchange.assert_called()
self.assertEqual(len(self.producer._buffered_messages), 0)
def test_publish_before_confirm_mode_ok_buffers_the_publish(self):
"""
Verify that any call to publish before confirm mode ok (when confirm
mode has been activated) leads to the call being buffered and delayed
until 'on_confirm_select_ok'.
"""
# Prep
self.producer.activate_confirm_mode(lambda _:...)
exchange_params = ExchangeParams("exchange")
# Test + assertions
_pub_key = self.producer.publish(b"body",
exchange_params=exchange_params)
self.assertNotEqual(_pub_key, None)
self.producer.declare_exchange.assert_not_called()
self.assertEqual(len(self.producer._buffered_messages), 1)
self.producer.on_confirm_select_ok(Mock())
self.producer.declare_exchange.assert_called()
self.assertEqual(len(self.producer._buffered_messages), 0)
class TestProducer(unittest.TestCase):
"""
Test the RMQProducer implementation, which implements the RMQConnection
interface.
"""
@patch("rabbitmq_client.producer.RMQProducer.start")
def setUp(self, _connection_start) -> None:
"""Setup to run before each test case."""
self.producer = RMQProducer()
self.producer.start()
self.producer.on_ready() # Fake connection getting ready
self.producer.declare_queue = Mock()
self.producer.declare_exchange = Mock()
self.producer.bind_queue = Mock()
self.producer.basic_publish = Mock()
def test_producer_readiness(self):
"""Verify the producer ready property changes appropriately."""
self.assertTrue(self.producer.ready)
self.producer.on_close()
self.assertFalse(self.producer.ready)
self.producer.on_ready()
self.assertTrue(self.producer.ready)
self.producer.on_close(permanent=True)
self.assertFalse(self.producer.ready)
def test_producer_error_handling(self):
"""Verify on_error results in correct behavior..."""
with self.assertRaises(NotImplementedError):
self.producer.on_error()
def test_publish_using_exchange_params(self):
"""Verify possibility to publish to an exchange."""
# Prep
exchange_params = ExchangeParams("exchange")
# Run test + assertions
self.producer.publish(b"body", exchange_params=exchange_params)
self.producer.declare_exchange.assert_called_with(exchange_params,
callback=ANY)
self.producer.on_exchange_declared(b"body",
exchange_params,
None,
routing_key="",
publish_params=None)
self.producer.basic_publish.assert_called_with(
b"body",
exchange=exchange_params.exchange,
routing_key="",
publish_params=None)
def test_publish_using_queue_params(self):
"""Verify possibility to publish providing only queue parameters."""
# Prep
queue_params = QueueParams("queue")
frame_mock = Mock()
frame_mock.method.queue = "queue"
# Run test + assertions
self.producer.publish(b"body", queue_params=queue_params)
self.producer.declare_queue.assert_called_with(queue_params,
callback=ANY)
self.producer.on_queue_declared(b"body",
frame_mock,
publish_params=None)
self.producer.basic_publish.assert_called_with(
b"body",
exchange=DEFAULT_EXCHANGE,
routing_key=queue_params.queue,
publish_params=None)
def test_publish_using_both_queue_params_and_exchange_params(self):
"""
Verify that a ValueError is raised if both queue and exchange
parameters are provided to publish.
"""
# Prep
queue_params = QueueParams("queue")
exchange_params = ExchangeParams("exchange")
# Run test + assertions
with self.assertRaises(ValueError):
self.producer.publish(b"body",
exchange_params=exchange_params,
queue_params=queue_params)
def test_publish_using_neither_queue_params_and_exchange_params(self):
"""
Verify that a ValueError is raised if neither queue nor exchange
parameters are provided to publish.
"""
# Run test + assertions
with self.assertRaises(ValueError):
self.producer.publish(b"body")
def test_publish_using_exchange_and_routing_key(self):
"""
Verify that publishing using both exchange and routing key has the
expected behavior.
"""
# Prep
exchange_params = ExchangeParams("exchange")
routing_key = "routing_key"
# Run test + assertions
self.producer.publish(b"body",
exchange_params=exchange_params,
routing_key=routing_key)
self.producer.declare_exchange.assert_called_with(exchange_params,
callback=ANY)
self.producer.on_exchange_declared(b"body",
exchange_params,
None,
routing_key=routing_key,
publish_params=None)
self.producer.basic_publish.assert_called_with(
b"body",
exchange=exchange_params.exchange,
routing_key=routing_key,
publish_params=None)
def test_publish_including_publish_params(self):
"""
Verify that PublishParams are passed as expected when calling publish.
"""
# Prep
exchange_params = ExchangeParams("exchange")
publish_params = PublishParams()
routing_key = "routing_key"
# Run test + assertions
self.producer.publish(b"body",
exchange_params=exchange_params,
routing_key=routing_key,
publish_params=publish_params)
self.producer.declare_exchange.assert_called_with(exchange_params,
callback=ANY)
self.producer.on_exchange_declared(b"body",
exchange_params,
None,
routing_key="",
publish_params=publish_params)
self.producer.basic_publish.assert_called_with(
b"body",
exchange=exchange_params.exchange,
routing_key="",
publish_params=publish_params)
def test_publish_is_delayed_until_producer_connection_ready(self):
"""
Verify that the producer buffers messages that are to be sent when the
producer connection is not in a ready state, and that the buffered
messages are sent upon the producer becoming ready.
"""
# Prep
exchange_params = ExchangeParams("exchange")
frame_mock = Mock()
frame_mock.method.queue = "queue"
queue_params = QueueParams("queue")
# Run test + assertions
self.producer.on_close()
self.producer.publish(b"body", exchange_params=exchange_params)
self.producer.publish(b"body", queue_params=queue_params)
self.assertEqual(2, len(self.producer._buffered_messages))
self.producer.on_ready()
self.producer.declare_exchange.assert_called_with(exchange_params,
callback=ANY)
self.producer.declare_queue.assert_called_with(queue_params,
callback=ANY)