Skip to main content

Crate vectorizer_sdk

Crate vectorizer_sdk 

Source
Expand description

Hive Vectorizer Rust SDK

High-performance Rust client for the Hive Vectorizer vector database. v3.x ships with VectorizerRPC as the default transport (binary MessagePack over raw TCP, see rpc); HTTP stays available as the legacy fallback under the http Cargo feature.

Suppresses the long tail of legacy clippy warnings (cast_lossless, uninlined_format_args, etc.) that the workspace lint policy escalates to deny. Mirrors the same blanket allow the umbrella vectorizer crate + vectorizer-core + vectorizer-cli all carry — without it, joining the workspace under sub-phase 6 would fail clippy on pre-existing SDK code untouched by the move.

The SDK also explicitly allows unwrap_used / expect_used at the crate root because it carries 13 pre-existing call sites (mostly in client/ discovery + files modules) that phase4_enforce-no-unwrap-policy cleared from the server crate but not yet from the SDK. A dedicated cleanup task (separate from the workspace split) covers those — the policy only fires on the server’s public surface today, not the SDK.

§Quick start (RPC, default)

use vectorizer_sdk::rpc::{RpcClient, HelloPayload};

let client = RpcClient::connect("127.0.0.1:15503").await?;
client.hello(HelloPayload::new("vectorizer-sdk-rust/3.0.0")).await?;
let collections = client.list_collections().await?;
println!("collections: {collections:?}");

Re-exports§

pub use client::ClientConfig;
pub use client::VectorizerClient;
pub use error::Result;
pub use error::VectorizerError;
pub use http_transport::HttpTransport;
pub use rpc::HelloPayload;
pub use rpc::HelloResponse;
pub use rpc::RpcClient;
pub use rpc::RpcClientError;
pub use rpc::RpcPool;
pub use transport::Protocol;
pub use transport::Transport;
pub use transport::parse_connection_string;
pub use models::*;

Modules§

client
REST VectorizerClient — split per API surface (phase4).
error
Error types for the Vectorizer SDK
http_transport
HTTP transport implementation using reqwest
models
Data models for the Vectorizer SDK
rpc
VectorizerRPC client — length-prefixed MessagePack over raw TCP.
transport
Transport abstraction layer for Vectorizer client.
utils
Essential utilities for the Vectorizer SDK

Constants§

DEFAULT_BASE_URL
Default API base URL
DEFAULT_MAX_RETRIES
Default maximum retries
DEFAULT_MCP_URL
Default MCP server URL
DEFAULT_RETRY_DELAY_SECS
Default retry delay in seconds
DEFAULT_TIMEOUT_SECS
Default request timeout in seconds
VERSION
SDK version