Files

T

dimgigov ae2e07e626 feat(clients): professional clients with tests, CI/CD, and examples

- Python: pyproject.toml, pytest suite (unit + integration), README, examples
- JavaScript: package.json, TypeScript definitions, node:test suite, README, examples
- Nim: integration tests, examples, README, improved nimble tasks
- Rust: fixed nodelay/localhost IPv6 bug, integration tests, examples, README
- Added GitHub Actions CI for all 4 clients against Docker server
- Added docker-compose.test.yml for local integration testing
- Added .gitignore for each client

2026-05-08 00:18:34 +03:00

3.0 KiB

Raw Blame History

BaraDB Rust Client

Official Rust client for BaraDB — a multimodal database engine written in Nim.

Features

Binary wire protocol — fast TCP communication using only std
Zero dependencies — no external crates required
Sync API — blocking I/O suitable for most applications
Query builder — fluent SQL construction
Vector & JSON support — first-class multimodal types

Installation

Add to your Cargo.toml:

[dependencies]
baradb = "1.0"

Or from source:

git clone https://github.com/barabadb/baradadb.git
cd clients/rust
cargo build

Quick Start

use baradb::Client;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut client = Client::connect("localhost", 9472)?;
    let result = client.query("SELECT name, age FROM users WHERE age > 18")?;
    for row in result.rows() {
        println!("{:?}", row);
    }
    client.close();
    Ok(())
}

Parameterized Queries

use baradb::{Client, WireValue};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut client = Client::connect("localhost", 9472)?;
    let result = client.query_params(
        "SELECT * FROM users WHERE age > $1 AND country = $2",
        &[WireValue::Int64(18), WireValue::String("BG".to_string())],
    )?;
    for row in result.rows() {
        println!("{:?}", row);
    }
    client.close();
    Ok(())
}

Query Builder

use baradb::Client;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut client = Client::connect("localhost", 9472)?;
    let result = baradb::QueryBuilder::new(&mut client)
        .select(&["name", "email"])
        .from("users")
        .where_clause("active = true")
        .order_by("name", "ASC")
        .limit(10)
        .exec()?;
    for row in result.rows() {
        println!("{:?}", row);
    }
    client.close();
    Ok(())
}

Vector Search

use baradb::{Client, WireValue};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let mut client = Client::connect("localhost", 9472)?;
    let result = client.query_params(
        "SELECT id, name FROM products ORDER BY embedding <-> $1 LIMIT 5",
        &[WireValue::Vector(vec![0.1, 0.2, 0.3])],
    )?;
    client.close();
    Ok(())
}

Running Tests

Unit tests (no server):

cargo test --lib

Integration tests (requires server on localhost:9472):

# Start server
docker run -d -p 9472:9472 baradb:latest

# Run all tests
cargo test

API Reference

`Client::connect(host, port)`

Creates a new client connected to the given host and port.

Methods

query(sql) -> Result<QueryResult> — execute SELECT-like query
query_params(sql, params) -> Result<QueryResult> — parameterized query
execute(sql) -> Result<usize> — execute DDL/DML, returns affected rows
auth(token) -> Result<()> — JWT authentication
ping() -> Result<bool> — health check
close() — close connection

License

Apache-2.0

3.0 KiB Raw Blame History