graphmind-sdk 0.6.5

Client SDK for Graphmind Graph Database — embedded and remote modes
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
75
76
77
78
79
80
81
82
83

# Graphmind Rust SDK

Rust SDK for [Graphmind](https://github.com/fab679/graphmind) — use as an embedded graph database or connect to a remote server.

## Installation

```toml
[dependencies]
graphmind-sdk = "0.6.5"
```

## Embedded Mode

```rust
use graphmind_sdk::EmbeddedClient;

let mut client = EmbeddedClient::new();

// Create data (semicolons separate multiple statements)
client.query("default", "
    CREATE (a:Person {name: 'Alice', age: 30});
    CREATE (b:Person {name: 'Bob', age: 25});
    MATCH (a:Person {name: 'Alice'}), (b:Person {name: 'Bob'})
    CREATE (a)-[:KNOWS]->(b)
")?;

// Or use shared variables (no semicolons needed)
client.query("default", "
    CREATE (a:Person {name: 'Charlie', age: 35})
    CREATE (b:Person {name: 'Diana', age: 28})
    CREATE (a)-[:KNOWS {since: 2023}]->(b)
")?;

// Query
let result = client.query_readonly("default", "MATCH (n:Person) RETURN n.name, n.age")?;
println!("{:?}", result);

// Schema
let schema = client.schema("default")?;
println!("{}", schema);
```

## Remote Mode

```rust
use graphmind_sdk::RemoteClient;

let client = RemoteClient::new("http://localhost:8080");

let result = client.query("default", "MATCH (n) RETURN n LIMIT 10").await?;
```

## API

Both `EmbeddedClient` and `RemoteClient` implement the `GraphmindClient` trait:

| Method | Description |
|--------|-------------|
| `query(graph, cypher)` | Execute read/write query |
| `query_readonly(graph, cypher)` | Execute read-only query |
| `schema(graph)` | Schema introspection |
| `explain(graph, cypher)` | Show execution plan |
| `profile(graph, cypher)` | Execute with profiling |
| `status()` | Server health |
| `ping()` | Connectivity test |
| `list_graphs()` | List graph namespaces |
| `delete_graph(graph)` | Delete a namespace |

## Feature Flags

The parent `graphmind` crate supports feature flags for minimal builds:

```toml
# Minimal embedded engine (no server, no persistence)
graphmind = { version = "0.6.5", default-features = false }

# With persistence and vector search
graphmind = { version = "0.6.5", default-features = false, features = ["persistence", "vector"] }
```

## License

Apache-2.0 — see [LICENSE](../../LICENSE)