summaryrefslogtreecommitdiff
path: root/README.rst
blob: 7eaf68d6aaa1e83009738ee77ccdd234180d291c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
Kafka Python client
------------------------
.. image:: https://api.travis-ci.org/dpkp/kafka-python.png?branch=master
    :target: https://travis-ci.org/dpkp/kafka-python
    :alt: Build Status

.. image:: https://coveralls.io/repos/dpkp/kafka-python/badge.svg?branch=master
    :target: https://coveralls.io/r/dpkp/kafka-python?branch=master
    :alt: Coverage Status

.. image:: https://readthedocs.org/projects/kafka-python/badge/?version=latest
    :target: http://kafka-python.readthedocs.org/en/latest/
    :alt: Full documentation available on ReadTheDocs

This module provides low-level protocol support for Apache Kafka as well as
high-level consumer and producer classes. Request batching is supported by the
protocol as well as broker-aware request routing. Gzip and Snappy compression
is also supported for message sets.

Coordinated Consumer Group support is under development - see Issue #38.

Full documentation available on `Read the Docs <https://kafka-python.readthedocs.org/en/latest/>`_

On Freenode IRC at #kafka-python, as well as #apache-kafka

For general discussion of kafka-client design and implementation (not python specific),
see https://groups.google.com/forum/#!forum/kafka-clients

For information about Apache Kafka generally, see https://kafka.apache.org/

License
----------
Apache License, v2.0. See `LICENSE <https://github.com/dpkp/kafka-python/blob/master/LICENSE>`_
Copyright 2015, David Arthur, Dana Powers, and Contributors
(See `AUTHORS <https://github.com/dpkp/kafka-python/blob/master/AUTHORS.md>`_)

Status
----------
The current stable version of this package is
`0.9.5 <https://github.com/dpkp/kafka-python/releases/tag/v0.9.5>`_
and is compatible with:

Kafka broker versions

- 0.9.0.0
- 0.8.2.2
- 0.8.2.1
- 0.8.1.1
- 0.8.1
- 0.8.0

Python versions

- 3.5 (tested on 3.5.0)
- 3.4 (tested on 3.4.2)
- 3.3 (tested on 3.3.5)
- 2.7 (tested on 2.7.9)
- 2.6 (tested on 2.6.9)
- pypy (tested on pypy 2.5.0 / python 2.7.8)