Skip to main content

example_client/
example_client.rs

1//! example_client.rs — connect to the example server and use every capability.
2//!
3//!   cargo build --examples
4//!   cargo run --example example_client
5
6use rcp::Capability;
7
8fn main() -> Result<(), rcp::RcpError> {
9    // The example_server binary sits next to this one in target/.../examples/.
10    let exe = std::env::current_exe().expect("current exe");
11    let server = exe.parent().unwrap().join("example_server");
12    let server = server.to_string_lossy().to_string();
13
14    let mut c = rcp::connect_stdio(&[server.as_str()])?;
15
16    println!(
17        "connected to {} v{} (RCP/{})",
18        c.server().get_str("name").unwrap_or("?"),
19        c.server().get_str("version").unwrap_or("?"),
20        c.protocol_version()
21    );
22    if let Some(caps) = c.capabilities().as_object() {
23        let keys: Vec<&str> = caps.iter().map(|(k, _)| k.as_str()).collect();
24        println!("capabilities: {:?}", keys);
25    }
26
27    if c.supports(Capability::Embed) {
28        let vecs = c.embed(&["hello world"], None)?;
29        println!("embed      -> {} vector(s), dim={}", vecs.len(), vecs[0].len());
30    }
31
32    if c.supports(Capability::Retrieve) {
33        println!("retrieve   ->");
34        for h in c.retrieve("landmark in the French capital", 2)? {
35            let snippet: String = h.text.chars().take(48).collect();
36            println!("   {}  score={:.3}  {}", h.id, h.score, snippet);
37        }
38    }
39
40    if c.supports(Capability::Graph) {
41        let g = c.graph("global", Some(rcp::obj(&[("query", "anything".into())])))?;
42        println!("graph      -> {}", g);
43    }
44
45    c.shutdown();
46    Ok(())
47}