[rust-zookeeper][doc]
=====================
[![Build Status](https://travis-ci.org/bonifaido/rust-zookeeper.svg?branch=master)](https://travis-ci.org/bonifaido/rust-zookeeper)
[![Coverage Status](https://coveralls.io/repos/bonifaido/rust-zookeeper/badge.svg?branch=master&service=github)](https://coveralls.io/github/bonifaido/rust-zookeeper?branch=master)
[![Version](https://img.shields.io/crates/v/zookeeper.svg)](https://crates.io/crates/zookeeper)
[![License](https://img.shields.io/crates/l/zookeeper.svg)](http://opensource.org/licenses/MIT)

Zookeeper client written 100% in Rust

This library is intended to be equivalent with the official (low-level) [ZooKeeper][javadoc] client which ships with the official ZK distribution.

I have plans to implement recipes and more complex [Curator][curator] like logic as well, but that takes a lot of time, so pull requests are more than welcome! At the moment only PathChildrenCache is implemented.

## Usage

Put this in your Cargo.toml:

```ini
[dependencies]
zookeeper = "0.6"
```

And this in your crate root:

```rust
extern crate zookeeper;
```

## Examples
Check the [examples][examples] directory

## Feature and Bug Handling
Also if you find a bug or would like to see a feature implemented please raise an issue or send a pull-request.

## Documentation
Documentation is available on the [gh-pages][doc] branch.

[doc]: http://bonifaido.github.io/rust-zookeeper
[examples]: https://github.com/bonifaido/rust-zookeeper/tree/master/examples
[javadoc]: https://zookeeper.apache.org/doc/r3.4.6/api/org/apache/zookeeper/ZooKeeper.html
[curator]: http://curator.apache.org/

## Build and develop
```shell
cd zk-test-cluster
mvn clean package
cd ..
cargo test
```
## Contributing
All contributions are welcome! If you need some inspiration, please take a look at the currently open [issues](https://github.com/bonifaido/rust-zookeeper/issues).