Skip to content

nkvoll/djkeeper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

djkeeper: Utilities for using ZooKeeper in a Django project

No longer maintained, supersceded by Kazoo: https://github.com/python-zk/kazoo

Installing

Either install the latest relase from PYPI:

$ pip install djkeeper

... or get the latest development version from GitHub:

$ pip install https://github.com/nkvoll/djkeeper/zipball/master#egg=djkeeper

Additionally, djkeeper requires a working installation of the official low level Python ZooKeeper bindings. These can either be built from source (recommended, explanation below), or you could install the statically compiled version zc-zookeeper-static) from PYPI, which may or may not work on your architecture/OS, and may or may not be the latest available ZooKeeper version.

Installing ZooKeeper on OS X (homebrew)

If you don't have homebrew, follow the Linux installation below, skipping "ldconfig", otherwise, use homebrew to install zookeeper with the --python flag:

$ brew install --python zookeeper

Installing ZooKeeper on Linux

Download and unpack the latest release of ZooKeeper from http://zookeeper.apache.org/releases.html:

$ tar -zxvf zookeeper-3.4.2.tar.gz

Build the C bindings:

$ cd zookeeper-3.4.2/src/c
$ ./configure --prefix=/usr/local
$ make
$ sudo make install
$ ldconfig

Build and install the python bindings:

$ cd ../contrib/zkpython
$ ant install

Running the test-suite

The test suite assumes you have a ZooKeeper server running on localhost:22181:

$ cd example
$ export ZOOCFGDIR=$(pwd) zkServer start-foreground

zkServer / zkServer.sh is found in the ZooKeeper installation directory.

The tests can then be run via the setup.py script:

$ python setup.py test

Example usage with Django

See https://github.com/nkvoll/pykeeper/blob/master/Readme.md for more detailed usage of the client object instance.

Configuring:

ZooKeeper clients are configured in your settings.py file under the configuration key DJKEEPER:

DJKEEPER = dict(
    clients = dict(
        client_name = dict(
            servers = 'localhost:22181', # defaults to localhost:2181
            reconnect = True # defaults to True, which means the client should reconnect if the connection is lost
        )
    )
)

Multiple named clients can be configured this way.

Using in a view:

For example, in views.py:

from django.http import HttpResponse
from djkeeper import manager


def index(request):
    client = manager.ZooKeeperManager.get_or_create_client('client_name')
    root_children = client.get_children('/')
    return HttpResponse('Root children: {0}'.format(root_children))

manager.ZooKeeperManager accepts the following keyword parameters:

* ``auto_connect``: Whether to call .connect() on a newly created client before returning it. Defaults to true.
* ``wait_until_connected``: Whether to block until the client state becomes ``connected`` before returning the client. Defaults to true.
* ``wait_until_connected_timeout``: How long the call is allowed to block (in seconds) before a ``pykeeper.TimeoutException`` is raised. Defaults to ``None``, which means no timeout.

Admin-overview

First, add djkeeper to your list of INSTALLED_APPS in settings.py, then add the following route to your urls.py:

#...
url(r'^admin/djkeeper/', 'djkeeper.views.index'),
#...

Or, if you use django-adminplus, an overview over the clients is automatically added to the admin panel when you call admin.autodiscover(). In this case, the custom route should NOT be added to your urls.py.

License

MIT licensed, see LICENSE for details.

About

Utilities for using ZooKeeper from a Django project.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages