kazoo¶
Kazoo is a Python library designed to make working with Zookeeper a more hassle-free experience that is less prone to errors.
Kazoo features:
A wide range of recipe implementations, like Lock, Election or Queue
Data and Children Watchers
Simplified Zookeeper connection state tracking
Unified asynchronous API for use with greenlets or threads
Support for gevent >= 1.2
Support for eventlet
Support for Zookeeper 3.3, 3.4, and 3.5 servers
Integrated testing helpers for Zookeeper clusters
Pure-Python based implementation of the wire protocol, avoiding all the memory leaks, lacking features, and debugging madness of the C library
Kazoo is heavily inspired by Netflix Curator simplifications and helpers.
Note
You should be familiar with Zookeeper and have read the Zookeeper Programmers Guide before using kazoo.
Reference Docs¶
Why¶
Using Zookeeper in a safe manner can be difficult due to the variety of edge-cases in Zookeeper and other bugs that have been present in the Python C binding. Due to how the C library utilizes a separate C thread for Zookeeper communication some libraries like gevent (or eventlet) also don’t work properly by default.
By utilizing a pure Python implementation, Kazoo handles all of these cases and provides a new asynchronous API which is consistent when using threads or gevent (or eventlet) greenlets.
Source Code¶
All source code is available on github under kazoo.
Bugs/Support¶
Bugs should be reported on the kazoo github issue tracker.
The developers of kazoo
can frequently be found on the Freenode IRC
network in the #zookeeper channel.
For general discussions and support questions, please use the python-zk mailing list hosted on Google Groups.
Indices and tables¶
License¶
kazoo
is offered under the Apache License 2.0.