zc.zookeeperrecipes 0.2.0

devtree

The devtree recipe sets up temporary ZooKeeper tree for a buildout:

[myproject]
recipe = zc.zookeeperrecipes:devtree
import-file = tree.txt

In this example, we’re creating a ZooKeeper tree at the path /myprojectYYYY-MM-DDTHH:MM:SS.SSSSSS with data imported from the buildout-local file tree.txt, where YYYY-MM-DDTHH:MM:SS.SSSSSS is the ISO date-time when the node was created.

The devtree recipe options are:

zookeeper

Optional ZooKeeper connection string.

It defaults to ‘127.0.0.1:2181’.

path

Optional path at which to create the tree.

If not provided, the part name is used, with a leading / added.

When a devtree part is installed, a path is created at a path derived from the given (or implied) path by adding the current date and time to the path in ISO date-time format (YYYY-MM-DDTHH:MM:SS.SSSSSS). The derived path is stored a file in the buildout parts directory with a name equal to the section name.

effective-path

Optional path to be used as is.

This option is normally computed by the recipe and is queryable from other recipes, but it may also be set explicitly.

import-file

Optional import file.

This is the name of a file containing tree-definition text. See the zc.zk documentation for information on the format of this file.

import-text

Optional import text.

Unfortunately, because of the way buildout parses configuration files, leading whitespace is stripped, making this option hard to specify.

helper-scripts

Helper-script prefix

If provided, 4 helper scripts will be generated with the given prefix:

PREFIXexport

Export a zookeepeer tree.

PREFIXimport

Import a zookeepeer tree.

PREFIXprint

Print a zookeepeer tree.

PREFIXport

Print the port of the first child of a given path.

Where PREFIX is the profix given to the helper-scripts option.

Change History