celerix-store 0.1.2

A lightweight, low-latency KV data store with 1:1 parity with the orginal golang version, atomic persistence, and AES-256-GCM encryption.
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

# Celerix Store (Rust)

[![crates.io](https://img.shields.io/crates/v/celerix-store.svg)](https://crates.io/crates/celerix-store)
[![docs.rs](https://docs.rs/celerix-store/badge.svg)](https://docs.rs/celerix-store)

A lightweight, low-latency Key-Value (KV) data store. This is a high-performance Rust implementation that is 1:1 compatible with the original Go version.

## Key Features

- **Dual Mode Operations**:
    - **Embedded**: Use as a local library with direct file-based persistence.
    - **Remote**: Connect to a `celerix-stored` instance over TCP.
- **Liquid Data Architecture**: Uses the `Persona -> App -> Key` hierarchy for structured data management.
- **Atomic Persistence**: High-integrity "write-then-rename" strategy for JSON storage.
- **Client-Side Encryption**: Built-in AES-256-GCM vault support for sensitive data.
- **Automatic Discovery**: SDK automatically switches modes based on environment variables.
- **Resilient Client**: TCP client with automatic reconnection and exponential backoff retries.

## Quick Start

### As a Service (Daemon)
Run the `celerix-stored` binary to start the TCP server:
```bash
# Defaults to port 7001 and ./data directory
cargo run --bin celerix-stored
```

### As a Library (SDK)
Add this to your `Cargo.toml`:
```toml
[dependencies]
celerix-store = "0.1.0"
tokio = { version = "1.0", features = ["full"] }
serde_json = "1.0"
```

### CLI Tool
Interact with the store via the command line:
```bash
cargo run --bin celerix -- set my-persona my-app my-key '"my-value"'
cargo run --bin celerix -- get my-persona my-app my-key
```

## Documentation
- [USAGE.md](USAGE.md): Detailed usage patterns, library examples, and Docker/Podman deployment.