summaryrefslogtreecommitdiff
path: root/test/test_client.py
diff options
context:
space:
mode:
Diffstat (limited to 'test/test_client.py')
-rw-r--r--test/test_client.py252
1 files changed, 237 insertions, 15 deletions
diff --git a/test/test_client.py b/test/test_client.py
index 800ca66..218586a 100644
--- a/test/test_client.py
+++ b/test/test_client.py
@@ -2,26 +2,248 @@ import os
import random
import struct
import unittest
-import kafka.client
-class ConnTest(unittest.TestCase):
- def test_load_metadata_for_topics(self):
- pass
+from mock import MagicMock, patch
- def test_get_leader_for_partition(self):
- pass
+from kafka import KafkaClient
+from kafka.common import (
+ ProduceRequest, BrokerMetadata, PartitionMetadata,
+ TopicAndPartition, KafkaUnavailableError,
+ LeaderUnavailableError, PartitionUnavailableError
+)
+from kafka.protocol import (
+ create_message, KafkaProtocol
+)
- def test_get_leader_for_partition__no_leader(self):
- pass
+class TestKafkaClient(unittest.TestCase):
+ def test_init_with_list(self):
+ with patch.object(KafkaClient, 'load_metadata_for_topics'):
+ client = KafkaClient(hosts=['kafka01:9092', 'kafka02:9092', 'kafka03:9092'])
- def test_get_conn_for_broker(self):
- pass
+ self.assertItemsEqual(
+ [('kafka01', 9092), ('kafka02', 9092), ('kafka03', 9092)],
+ client.hosts)
+
+ def test_init_with_csv(self):
+ with patch.object(KafkaClient, 'load_metadata_for_topics'):
+ client = KafkaClient(hosts='kafka01:9092,kafka02:9092,kafka03:9092')
+
+ self.assertItemsEqual(
+ [('kafka01', 9092), ('kafka02', 9092), ('kafka03', 9092)],
+ client.hosts)
+
+ def test_init_with_unicode_csv(self):
+ with patch.object(KafkaClient, 'load_metadata_for_topics'):
+ client = KafkaClient(hosts=u'kafka01:9092,kafka02:9092,kafka03:9092')
+
+ self.assertItemsEqual(
+ [('kafka01', 9092), ('kafka02', 9092), ('kafka03', 9092)],
+ client.hosts)
+
+ def test_send_broker_unaware_request_fail(self):
+ 'Tests that call fails when all hosts are unavailable'
+
+ mocked_conns = {
+ ('kafka01', 9092): MagicMock(),
+ ('kafka02', 9092): MagicMock()
+ }
+
+ # inject KafkaConnection side effects
+ mocked_conns[('kafka01', 9092)].send.side_effect = RuntimeError("kafka01 went away (unittest)")
+ mocked_conns[('kafka02', 9092)].send.side_effect = RuntimeError("Kafka02 went away (unittest)")
+
+ def mock_get_conn(host, port):
+ return mocked_conns[(host, port)]
+
+ # patch to avoid making requests before we want it
+ with patch.object(KafkaClient, 'load_metadata_for_topics'):
+ with patch.object(KafkaClient, '_get_conn', side_effect=mock_get_conn):
+ client = KafkaClient(hosts=['kafka01:9092', 'kafka02:9092'])
+
+ with self.assertRaises(KafkaUnavailableError):
+ client._send_broker_unaware_request(1, 'fake request')
+
+ for key, conn in mocked_conns.iteritems():
+ conn.send.assert_called_with(1, 'fake request')
def test_send_broker_unaware_request(self):
- pass
+ 'Tests that call works when at least one of the host is available'
+
+ mocked_conns = {
+ ('kafka01', 9092): MagicMock(),
+ ('kafka02', 9092): MagicMock(),
+ ('kafka03', 9092): MagicMock()
+ }
+ # inject KafkaConnection side effects
+ mocked_conns[('kafka01', 9092)].send.side_effect = RuntimeError("kafka01 went away (unittest)")
+ mocked_conns[('kafka02', 9092)].recv.return_value = 'valid response'
+ mocked_conns[('kafka03', 9092)].send.side_effect = RuntimeError("kafka03 went away (unittest)")
+
+ def mock_get_conn(host, port):
+ return mocked_conns[(host, port)]
+
+ # patch to avoid making requests before we want it
+ with patch.object(KafkaClient, 'load_metadata_for_topics'):
+ with patch.object(KafkaClient, '_get_conn', side_effect=mock_get_conn):
+ client = KafkaClient(hosts='kafka01:9092,kafka02:9092')
+
+ resp = client._send_broker_unaware_request(1, 'fake request')
+
+ self.assertEqual('valid response', resp)
+ mocked_conns[('kafka02', 9092)].recv.assert_called_with(1)
+
+ @patch('kafka.client.KafkaConnection')
+ @patch('kafka.client.KafkaProtocol')
+ def test_load_metadata(self, protocol, conn):
+ "Load metadata for all topics"
+
+ conn.recv.return_value = 'response' # anything but None
+
+ brokers = {}
+ brokers[0] = BrokerMetadata(1, 'broker_1', 4567)
+ brokers[1] = BrokerMetadata(2, 'broker_2', 5678)
+
+ topics = {}
+ topics['topic_1'] = {
+ 0: PartitionMetadata('topic_1', 0, 1, [1, 2], [1, 2])
+ }
+ topics['topic_noleader'] = {
+ 0: PartitionMetadata('topic_noleader', 0, -1, [], []),
+ 1: PartitionMetadata('topic_noleader', 1, -1, [], [])
+ }
+ topics['topic_no_partitions'] = {}
+ topics['topic_3'] = {
+ 0: PartitionMetadata('topic_3', 0, 0, [0, 1], [0, 1]),
+ 1: PartitionMetadata('topic_3', 1, 1, [1, 0], [1, 0]),
+ 2: PartitionMetadata('topic_3', 2, 0, [0, 1], [0, 1])
+ }
+ protocol.decode_metadata_response.return_value = (brokers, topics)
+
+ # client loads metadata at init
+ client = KafkaClient(hosts=['broker_1:4567'])
+ self.assertDictEqual({
+ TopicAndPartition('topic_1', 0): brokers[1],
+ TopicAndPartition('topic_noleader', 0): None,
+ TopicAndPartition('topic_noleader', 1): None,
+ TopicAndPartition('topic_3', 0): brokers[0],
+ TopicAndPartition('topic_3', 1): brokers[1],
+ TopicAndPartition('topic_3', 2): brokers[0]},
+ client.topics_to_brokers)
+
+ @patch('kafka.client.KafkaConnection')
+ @patch('kafka.client.KafkaProtocol')
+ def test_get_leader_for_partitions_reloads_metadata(self, protocol, conn):
+ "Get leader for partitions reload metadata if it is not available"
+
+ conn.recv.return_value = 'response' # anything but None
+
+ brokers = {}
+ brokers[0] = BrokerMetadata(0, 'broker_1', 4567)
+ brokers[1] = BrokerMetadata(1, 'broker_2', 5678)
+
+ topics = {'topic_no_partitions': {}}
+ protocol.decode_metadata_response.return_value = (brokers, topics)
+
+ client = KafkaClient(hosts=['broker_1:4567'])
+
+ # topic metadata is loaded but empty
+ self.assertDictEqual({}, client.topics_to_brokers)
+
+ topics['topic_no_partitions'] = {
+ 0: PartitionMetadata('topic_no_partitions', 0, 0, [0, 1], [0, 1])
+ }
+ protocol.decode_metadata_response.return_value = (brokers, topics)
+
+ # calling _get_leader_for_partition (from any broker aware request)
+ # will try loading metadata again for the same topic
+ leader = client._get_leader_for_partition('topic_no_partitions', 0)
+
+ self.assertEqual(brokers[0], leader)
+ self.assertDictEqual({
+ TopicAndPartition('topic_no_partitions', 0): brokers[0]},
+ client.topics_to_brokers)
+
+ @patch('kafka.client.KafkaConnection')
+ @patch('kafka.client.KafkaProtocol')
+ def test_get_leader_for_unassigned_partitions(self, protocol, conn):
+ "Get leader raises if no partitions is defined for a topic"
+
+ conn.recv.return_value = 'response' # anything but None
+
+ brokers = {}
+ brokers[0] = BrokerMetadata(0, 'broker_1', 4567)
+ brokers[1] = BrokerMetadata(1, 'broker_2', 5678)
+
+ topics = {'topic_no_partitions': {}}
+ protocol.decode_metadata_response.return_value = (brokers, topics)
+
+ client = KafkaClient(hosts=['broker_1:4567'])
+
+ self.assertDictEqual({}, client.topics_to_brokers)
+
+ with self.assertRaises(PartitionUnavailableError):
+ client._get_leader_for_partition('topic_no_partitions', 0)
+
+ @patch('kafka.client.KafkaConnection')
+ @patch('kafka.client.KafkaProtocol')
+ def test_get_leader_returns_none_when_noleader(self, protocol, conn):
+ "Getting leader for partitions returns None when the partiion has no leader"
+
+ conn.recv.return_value = 'response' # anything but None
+
+ brokers = {}
+ brokers[0] = BrokerMetadata(0, 'broker_1', 4567)
+ brokers[1] = BrokerMetadata(1, 'broker_2', 5678)
+
+ topics = {}
+ topics['topic_noleader'] = {
+ 0: PartitionMetadata('topic_noleader', 0, -1, [], []),
+ 1: PartitionMetadata('topic_noleader', 1, -1, [], [])
+ }
+ protocol.decode_metadata_response.return_value = (brokers, topics)
+
+ client = KafkaClient(hosts=['broker_1:4567'])
+ self.assertDictEqual(
+ {
+ TopicAndPartition('topic_noleader', 0): None,
+ TopicAndPartition('topic_noleader', 1): None
+ },
+ client.topics_to_brokers)
+ self.assertIsNone(client._get_leader_for_partition('topic_noleader', 0))
+ self.assertIsNone(client._get_leader_for_partition('topic_noleader', 1))
+
+ topics['topic_noleader'] = {
+ 0: PartitionMetadata('topic_noleader', 0, 0, [0, 1], [0, 1]),
+ 1: PartitionMetadata('topic_noleader', 1, 1, [1, 0], [1, 0])
+ }
+ protocol.decode_metadata_response.return_value = (brokers, topics)
+ self.assertEqual(brokers[0], client._get_leader_for_partition('topic_noleader', 0))
+ self.assertEqual(brokers[1], client._get_leader_for_partition('topic_noleader', 1))
+
+ @patch('kafka.client.KafkaConnection')
+ @patch('kafka.client.KafkaProtocol')
+ def test_send_produce_request_raises_when_noleader(self, protocol, conn):
+ "Send producer request raises LeaderUnavailableError if leader is not available"
+
+ conn.recv.return_value = 'response' # anything but None
+
+ brokers = {}
+ brokers[0] = BrokerMetadata(0, 'broker_1', 4567)
+ brokers[1] = BrokerMetadata(1, 'broker_2', 5678)
+
+ topics = {}
+ topics['topic_noleader'] = {
+ 0: PartitionMetadata('topic_noleader', 0, -1, [], []),
+ 1: PartitionMetadata('topic_noleader', 1, -1, [], [])
+ }
+ protocol.decode_metadata_response.return_value = (brokers, topics)
+
+ client = KafkaClient(hosts=['broker_1:4567'])
+
+ requests = [ProduceRequest(
+ "topic_noleader", 0,
+ [create_message("a"), create_message("b")])]
- def test_send_broker_unaware_request__no_brokers(self):
- pass
+ with self.assertRaises(LeaderUnavailableError):
+ client.send_produce_request(requests)
- def test_send_broker_unaware_request__all_brokers_down(self):
- pass