calvery 0.3.0

Official Rust SDK for Calvery Vault secret manager
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

# Calvery SDK — Rust

Official Rust SDK for [Calvery Vault](https://calvery.xyz) secret manager.

## Install

Add to `Cargo.toml`:

```toml
[dependencies]
calvery = "0.1"
tokio = { version = "1", features = ["rt-multi-thread", "macros"] }
```

## Quickstart

```rust
use calvery::Client;

#[tokio::main]
async fn main() -> Result<(), calvery::Error> {
    let client = Client::new(
        std::env::var("CVSM_TOKEN").unwrap(),
        "acme-corp",
    )?;

    // Get single secret
    let db_url = client.get("DATABASE_URL").await?;
    println!("DB URL: {}", db_url);

    // Get all secrets as HashMap
    let all = client.get_all().await?;

    // Inject into process env (skip ones already set)
    let injected = client.inject(false).await?;
    println!("Injected {} vars", injected.len());

    Ok(())
}
```

## Config

```rust
use std::time::Duration;
use calvery::Client;

let client = Client::builder("cvsm_xxx", "acme-corp")
    .base_url("https://vault.your-company.internal")  // self-host
    .environment("staging")
    .cache_ttl(Duration::from_secs(60))
    .max_retries(5)
    .timeout(Duration::from_secs(30))
    .build()?;
```

## Error handling

```rust
match client.get("DATABASE_URL").await {
    Ok(v) => println!("{}", v),
    Err(calvery::Error::NotFound(msg)) => eprintln!("secret missing: {msg}"),
    Err(calvery::Error::Auth(msg)) => eprintln!("token invalid: {msg}"),
    Err(calvery::Error::Network(msg)) => eprintln!("network: {msg}"),
    Err(e) => eprintln!("other: {e}"),
}
```

## License

MIT — see [LICENSE](https://github.com/RenzyArmstrong/Calvery-Vault/blob/master/LICENSE).

Bug reports: [github.com/RenzyArmstrong/Calvery-Vault/issues](https://github.com/RenzyArmstrong/Calvery-Vault/issues)
Support: support@calvery.xyz