/kiel

Kafka python client for asynchronous tornado applications.

Primary LanguagePythonApache License 2.0Apache-2.0

Kiel: Kafka Tornado Client

Python Package Version Documentation Status Build Status Code Climate Test Coverage

Kiel is a pure python Kafka client library for use with Tornado applications.

Installation

Pip

Kiel is available via PyPI, installation is as easy as:

pip install kiel

Manual

To install manually, first clone this here repo and:

cd kiel
python setup.py install

Documentation

More detailed information can be found on Read The Docs.

Quick Consumer Example

from kiel import clients
from tornado import gen, ioloop


@gen.coroutine
def consume():
    c = clients.SingleConsumer(brokers=["localhost"])

    yield c.connect()

    while True:
        msgs = yield c.consume("examples.colors")
        for msg in msgs:
            print(msg["color"])


def run():
    loop = ioloop.IOloop.instance()

    loop.add_callback(consume)

    try:
        loop.start()
    except KeyboardInterrupt:
        loop.stop()

Development

The code is hosted on GitHub

To file a bug or possible enhancement see the Issue Tracker, also found on GitHub.

License

(c) 2015-2016 William Glass

Kiel is licensed under the terms of the Apache License (2.0). See the LICENSE file for more details.