3 stable releases
new 1.2.1 | Aug 27, 2024 |
---|---|
1.2.0 | Jul 9, 2024 |
1.1.0 | Jul 1, 2024 |
#1819 in Network programming
77KB
2K
SLoC
yet another etcd client for Rust
An etcd (API v3) client for Rust backed by tokio and tonic.
Supported APIs
- KV
- Put
- Range
- Delete
- Transaction
- Compact
- Lease
- Grant
- Revoke
- KeepAlive
- TimeToLive
- Watch
- WatchCreate
- WatchCancel
- Auth
- Authenticate
- AuthStatus
- AuthEnable
- AuthDisable
- RoleAdd
- RoleDelete
- RoleList
- RoleGrantPermission
- UserAdd
- UserDelete
- UserGrantRole
- Cluster
- MemberAdd
- MemberRemove
- MemberUpdate
- MemberList
- Maintenance
- Alarm
- Status
- Defragment
- Hash
- Snapshot
- MoveLeader
Rust Version
ya-etcd-rs
's MSRV is 1.75
.
$ rustup update
$ cargo build
Usage
Add following dependencies in your project cargo.toml
:
[dependencies]
ya-etcd-rs = "1.2"
use ya_etcd_rs::{Client, ClientConfig, KeyValueOp, Result};
#[tokio::main]
async fn main() -> Result<()> {
let cli = Client::new(ClientConfig::new([
"http://127.0.0.1:12379".into(),
"http://127.0.0.1:22379".into(),
"http://127.0.0.1:32379".into(),
]))
.await?;
cli.put(("foo", "bar")).await.expect("put kv");
let kvs = cli.get("foo").await.expect("get kv").kvs;
assert_eq!(kvs.len(), 1);
Ok(())
}
Development
requirements:
- Makefile
- docker
- docker compose
Start local etcd cluster
make setup-etcd-cluster
stop cluster
make teardown-etcd-cluster
for specified case:
TEST_CASE=test_put_error make test-one
License
This project is licensed under the MIT license.
Dependencies
~5–15MB
~184K SLoC