Skip to content

Commit a46898d

Browse files
committed
Make producers take a topic argument at send rather than init time
This allows a single producer to be used to send to multiple topics. See #110
1 parent 6db14de commit a46898d

File tree

3 files changed

+94
-88
lines changed

3 files changed

+94
-88
lines changed

README.md

+13-13
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Copyright 2013, David Arthur under Apache License, v2.0. See `LICENSE`
1717

1818
# Status
1919

20-
The current version of this package is **0.9.0** and is compatible with
20+
The current version of this package is **0.9.0** and is compatible with
2121
Kafka brokers running version **0.8.1**.
2222

2323
# Usage
@@ -32,24 +32,24 @@ from kafka.producer import SimpleProducer, KeyedProducer
3232
kafka = KafkaClient("localhost", 9092)
3333

3434
# To send messages synchronously
35-
producer = SimpleProducer(kafka, "my-topic")
36-
producer.send_messages("some message")
37-
producer.send_messages("this method", "is variadic")
35+
producer = SimpleProducer(kafka)
36+
producer.send_messages("my-topic", "some message")
37+
producer.send_messages("my-topic", "this method", "is variadic")
3838

3939
# To send messages asynchronously
40-
producer = SimpleProducer(kafka, "my-topic", async=True)
41-
producer.send_messages("async message")
40+
producer = SimpleProducer(kafka, async=True)
41+
producer.send_messages("my-topic", "async message")
4242

4343
# To wait for acknowledgements
4444
# ACK_AFTER_LOCAL_WRITE : server will wait till the data is written to
4545
# a local log before sending response
4646
# ACK_AFTER_CLUSTER_COMMIT : server will block until the message is committed
4747
# by all in sync replicas before sending a response
48-
producer = SimpleProducer(kafka, "my-topic", async=False,
48+
producer = SimpleProducer(kafka, async=False,
4949
req_acks=SimpleProducer.ACK_AFTER_LOCAL_WRITE,
5050
ack_timeout=2000)
5151

52-
response = producer.send_messages("async message")
52+
response = producer.send_messages("my-topic", "async message")
5353

5454
if response:
5555
print(response[0].error)
@@ -62,7 +62,7 @@ if response:
6262
# Notes:
6363
# * If the producer dies before the messages are sent, there will be losses
6464
# * Call producer.stop() to send the messages and cleanup
65-
producer = SimpleProducer(kafka, "my-topic", batch_send=True,
65+
producer = SimpleProducer(kafka, batch_send=True,
6666
batch_send_every_n=20,
6767
batch_send_every_t=60)
6868

@@ -83,11 +83,11 @@ from kafka.partitioner import HashedPartitioner, RoundRobinPartitioner
8383
kafka = KafkaClient("localhost", 9092)
8484

8585
# HashedPartitioner is default
86-
producer = KeyedProducer(kafka, "my-topic")
87-
producer.send("key1", "some message")
88-
producer.send("key2", "this methode")
86+
producer = KeyedProducer(kafka)
87+
producer.send("my-topic", "key1", "some message")
88+
producer.send("my-topic", "key2", "this methode")
8989

90-
producer = KeyedProducer(kafka, "my-topic", partitioner=RoundRobinPartitioner)
90+
producer = KeyedProducer(kafka, partitioner=RoundRobinPartitioner)
9191
```
9292

9393
## Multiprocess consumer

kafka/producer.py

+40-34
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@
2020
STOP_ASYNC_PRODUCER = -1
2121

2222

23-
def _send_upstream(topic, queue, client, batch_time, batch_size,
23+
def _send_upstream(queue, client, batch_time, batch_size,
2424
req_acks, ack_timeout):
2525
"""
2626
Listen on the queue for a specified number of messages or till
@@ -44,23 +44,24 @@ def _send_upstream(topic, queue, client, batch_time, batch_size,
4444
# timeout is reached
4545
while count > 0 and timeout >= 0:
4646
try:
47-
partition, msg = queue.get(timeout=timeout)
47+
topic, partition, msg = queue.get(timeout=timeout)
48+
4849
except Empty:
4950
break
5051

5152
# Check if the controller has requested us to stop
52-
if partition == STOP_ASYNC_PRODUCER:
53+
if topic == STOP_ASYNC_PRODUCER:
5354
stop = True
5455
break
5556

5657
# Adjust the timeout to match the remaining period
5758
count -= 1
5859
timeout = send_at - time.time()
59-
msgset[partition].append(msg)
60+
msgset[(topic, partition)].append(msg)
6061

6162
# Send collected requests upstream
6263
reqs = []
63-
for partition, messages in msgset.items():
64+
for (topic, partition), messages in msgset.items():
6465
req = ProduceRequest(topic, partition, messages)
6566
reqs.append(req)
6667

@@ -78,7 +79,6 @@ class Producer(object):
7879
7980
Params:
8081
client - The Kafka client instance to use
81-
topic - The topic for sending messages to
8282
async - If set to true, the messages are sent asynchronously via another
8383
thread (process). We will not wait for a response to these
8484
req_acks - A value indicating the acknowledgements that the server must
@@ -119,8 +119,7 @@ def __init__(self, client, async=False,
119119
if self.async:
120120
self.queue = Queue() # Messages are sent through this queue
121121
self.proc = Process(target=_send_upstream,
122-
args=(self.topic,
123-
self.queue,
122+
args=(self.queue,
124123
self.client.copy(),
125124
batch_send_every_t,
126125
batch_send_every_n,
@@ -131,17 +130,17 @@ def __init__(self, client, async=False,
131130
self.proc.daemon = True
132131
self.proc.start()
133132

134-
def send_messages(self, partition, *msg):
133+
def send_messages(self, topic, partition, *msg):
135134
"""
136135
Helper method to send produce requests
137136
"""
138137
if self.async:
139138
for m in msg:
140-
self.queue.put((partition, create_message(m)))
139+
self.queue.put((topic, partition, create_message(m)))
141140
resp = []
142141
else:
143142
messages = [create_message(m) for m in msg]
144-
req = ProduceRequest(self.topic, partition, messages)
143+
req = ProduceRequest(topic, partition, messages)
145144
try:
146145
resp = self.client.send_produce_request([req], acks=self.req_acks,
147146
timeout=self.ack_timeout)
@@ -156,7 +155,7 @@ def stop(self, timeout=1):
156155
forcefully cleaning up.
157156
"""
158157
if self.async:
159-
self.queue.put((STOP_ASYNC_PRODUCER, None))
158+
self.queue.put((STOP_ASYNC_PRODUCER, None, None))
160159
self.proc.join(timeout)
161160

162161
if self.proc.is_alive():
@@ -169,7 +168,6 @@ class SimpleProducer(Producer):
169168
170169
Params:
171170
client - The Kafka client instance to use
172-
topic - The topic for sending messages to
173171
async - If True, the messages are sent asynchronously via another
174172
thread (process). We will not wait for a response to these
175173
req_acks - A value indicating the acknowledgements that the server must
@@ -180,27 +178,31 @@ class SimpleProducer(Producer):
180178
batch_send_every_n - If set, messages are send in batches of this size
181179
batch_send_every_t - If set, messages are send after this timeout
182180
"""
183-
def __init__(self, client, topic, async=False,
181+
def __init__(self, client, async=False,
184182
req_acks=Producer.ACK_AFTER_LOCAL_WRITE,
185183
ack_timeout=Producer.DEFAULT_ACK_TIMEOUT,
186184
batch_send=False,
187185
batch_send_every_n=BATCH_SEND_MSG_COUNT,
188186
batch_send_every_t=BATCH_SEND_DEFAULT_INTERVAL):
189-
self.topic = topic
190-
client.load_metadata_for_topics(topic)
191-
self.next_partition = cycle(client.topic_partitions[topic])
192-
187+
self.partition_cycles = {}
193188
super(SimpleProducer, self).__init__(client, async, req_acks,
194189
ack_timeout, batch_send,
195190
batch_send_every_n,
196191
batch_send_every_t)
197192

198-
def send_messages(self, *msg):
199-
partition = self.next_partition.next()
200-
return super(SimpleProducer, self).send_messages(partition, *msg)
193+
def _next_partition(self, topic):
194+
if topic not in self.partition_cycles:
195+
if topic not in self.client.topic_partitions:
196+
self.client.load_metadata_for_topics(topic)
197+
self.partition_cycles[topic] = cycle(self.client.topic_partitions[topic])
198+
return self.partition_cycles[topic].next()
199+
200+
def send_messages(self, topic, *msg):
201+
partition = self._next_partition(topic)
202+
return super(SimpleProducer, self).send_messages(topic, partition, *msg)
201203

202204
def __repr__(self):
203-
return '<SimpleProducer topic=%s, batch=%s>' % (self.topic, self.async)
205+
return '<SimpleProducer batch=%s>' % self.async
204206

205207

206208
class KeyedProducer(Producer):
@@ -209,7 +211,6 @@ class KeyedProducer(Producer):
209211
210212
Args:
211213
client - The kafka client instance
212-
topic - The kafka topic to send messages to
213214
partitioner - A partitioner class that will be used to get the partition
214215
to send the message to. Must be derived from Partitioner
215216
async - If True, the messages are sent asynchronously via another
@@ -220,29 +221,34 @@ class KeyedProducer(Producer):
220221
batch_send_every_n - If set, messages are send in batches of this size
221222
batch_send_every_t - If set, messages are send after this timeout
222223
"""
223-
def __init__(self, client, topic, partitioner=None, async=False,
224+
def __init__(self, client, partitioner=None, async=False,
224225
req_acks=Producer.ACK_AFTER_LOCAL_WRITE,
225226
ack_timeout=Producer.DEFAULT_ACK_TIMEOUT,
226227
batch_send=False,
227228
batch_send_every_n=BATCH_SEND_MSG_COUNT,
228229
batch_send_every_t=BATCH_SEND_DEFAULT_INTERVAL):
229-
self.topic = topic
230-
client.load_metadata_for_topics(topic)
231-
232230
if not partitioner:
233231
partitioner = HashedPartitioner
234-
235-
self.partitioner = partitioner(client.topic_partitions[topic])
232+
self.partitioner_class = partitioner
233+
self.partitioners = {}
236234

237235
super(KeyedProducer, self).__init__(client, async, req_acks,
238236
ack_timeout, batch_send,
239237
batch_send_every_n,
240238
batch_send_every_t)
241239

242-
def send(self, key, msg):
243-
partitions = self.client.topic_partitions[self.topic]
244-
partition = self.partitioner.partition(key, partitions)
245-
return self.send_messages(partition, msg)
240+
def _next_partition(self, topic, key):
241+
if topic not in self.partitioners:
242+
if topic not in self.client.topic_partitions:
243+
self.client.load_metadata_for_topics(topic)
244+
self.partitioners[topic] = \
245+
self.partitioner_class(self.client.topic_partitions[topic])
246+
partitioner = self.partitioners[topic]
247+
return partitioner.partition(key, self.client.topic_partitions[topic])
248+
249+
def send(self, topic, key, msg):
250+
partition = self._next_partition(topic, key)
251+
return self.send_messages(topic, partition, msg)
246252

247253
def __repr__(self):
248-
return '<KeyedProducer topic=%s, batch=%s>' % (self.topic, self.async)
254+
return '<KeyedProducer batch=%s>' % self.async

0 commit comments

Comments
 (0)