etcd-client

An etcd v3 API client for Rust. It provides asynchronous client backed by tokio and tonic.

Features

• etcd API v3
• asynchronous

Supported APIs

• [x] KV
• [x] Watch
• [x] Lease
• [x] Lock
• [x] Auth
• [x] Maintenance
• [x] Cluster
• [x] Election

Usage

Add this to your Cargo.toml:

toml [dependencies] etcd-client = "0.5" tokio = { version = "0.2", features = ["full"] }

To get started using etcd-client:

```Rust use etcd_client::{Client, Error};

[tokio::main]

async fn main() -> Result<(), Error> { let mut client = Client::connect(["localhost:2379"], None).await?; // put kv client.put("foo", "bar", None).await?; // get kv let resp = client.get("foo", None).await?; if let Some(kv) = resp.kvs().first() { println!("Get kv: {{{}: {}}}", kv.keystr()?, kv.valuestr()?); }

Ok(())

} ```

Examples

Examples can be found in examples.

Test

We test this library using etcd 3.4.

Notes that we use a fixed etcd server URI (localhost:2379) to connect to etcd server.

Rust version requirements

etcd-client works on rust 1.39 and above as it requires support for the async_await feature.

License

This project is licensed under the MIT license (LICENSE or http://opensource.org/licenses/MIT).

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in etcd-client by you, shall be licensed as MIT, without any additional terms or conditions.