43 releases
0.14.0 | Jul 10, 2024 |
---|---|
0.12.4 | Jan 1, 2024 |
0.12.3 | Nov 21, 2023 |
0.11.1 | May 3, 2023 |
0.1.1 | Mar 28, 2020 |
#50 in Cryptography
110,985 downloads per month
Used in 73 crates
(25 directly)
230KB
5.5K
SLoC
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
- KV
- Watch
- Lease
- Auth
- Maintenance
- Cluster
- Lock
- Election
- Namespace
Usage
Add this to your Cargo.toml
:
[dependencies]
etcd-client = "0.14"
tokio = { version = "1.0", features = ["full"] }
To get started using etcd-client
:
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.key_str()?, kv.value_str()?);
}
Ok(())
}
Examples
Examples can be found in examples
.
Feature Flags
tls
: Enables therustls
-based TLS connection. Not enabled by default.tls-roots
: Adds system trust roots torustls
-based TLS connection using therustls-native-certs
crate. Not enabled by default.pub-response-field
: Exposes structs used to create regularetcd-client
responses including internal protobuf representations. Useful for mocking. Not enabled by default.tls-openssl
: Enables theopenssl
-based TLS connections. This would make your binary dynamically link tolibssl
.tls-openssl-vendored
: Liketls-openssl
, however compile openssl from source code and statically link to it.
Test
We test this library with etcd 3.5.
Notes that we use a fixed etcd
server URI (localhost:2379) to connect to etcd server.
Rust version requirements
The minimum supported version is 1.70. The current etcd-client
version is not guaranteed to build on Rust versions
earlier than the minimum supported version.
License
Dual-licensed to be compatible with the Rust project.
Licensed under the Apache License, Version 2.0 http://www.apache.org/licenses/LICENSE-2.0 or the MIT license http://opensource.org/licenses/MIT, at your option. This file may not be copied, modified, or distributed except according to those terms.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in etcd-client
by you, shall be licensed as Apache-2.0 and MIT, without any additional
terms or conditions.
Dependencies
~5–17MB
~243K SLoC