Struct IndexRegistry 

pub struct IndexRegistry { /* private fields */ }

Thread-safe registry for managing multiple named indexes.

Example

use rag_plusplus_core::index::{IndexRegistry, FlatIndex, IndexConfig};

let mut registry = IndexRegistry::new();

// Register indexes for different modalities
let text_index = FlatIndex::new(IndexConfig::new(768));
let code_index = FlatIndex::new(IndexConfig::new(512));

registry.register("text_embeddings", text_index)?;
registry.register("code_embeddings", code_index)?;

// Search specific index
let results = registry.search("text_embeddings", &query, 10)?;

// Search all indexes
let all_results = registry.search_all(&query, 10)?;

Implementations

impl IndexRegistry

pub fn new() -> Self

Create a new empty registry.

pub fn with_capacity(capacity: usize) -> Self

Create registry with pre-allocated capacity.

pub fn register<I: VectorIndex + 'static>( &mut self, name: impl Into<String>, index: I, ) -> Result<()>

Register a new index with the given name.

Errors

Returns error if an index with the same name already exists.

pub fn register_or_replace<I: VectorIndex + 'static>( &mut self, name: impl Into<String>, index: I, ) -> Option<Box<dyn VectorIndex>>

Register or replace an index.

Returns the previous index if one existed.

pub fn get(&self, name: &str) -> Option<&dyn VectorIndex>

Get a reference to an index by name.

pub fn remove(&mut self, name: &str) -> Option<Box<dyn VectorIndex>>

Remove an index by name.

Returns the removed index if it existed.

pub fn contains(&self, name: &str) -> bool

Check if an index exists.

pub fn list(&self) -> Vec<&str>

List all registered index names.

pub fn info(&self) -> Vec<IndexInfo>

Get information about all registered indexes.

pub fn len(&self) -> usize

Number of registered indexes.

pub fn is_empty(&self) -> bool

Check if registry is empty.

pub fn total_vectors(&self) -> usize

Total number of vectors across all indexes.

pub fn total_memory(&self) -> usize

Total memory usage across all indexes.

pub fn search( &self, name: &str, query: &[f32], k: usize, ) -> Result<Vec<SearchResult>>

Search a specific index by name.

Errors

Returns error if index doesn’t exist or search fails.

pub fn search_all(&self, query: &[f32], k: usize) -> Result<MultiIndexResults>

Search all indexes with the same query.

Note: This is a sequential search. For parallel search, use parallel_search_all.

Errors

Returns error if any search fails.

pub fn search_indexes( &self, names: &[&str], query: &[f32], k: usize, ) -> Result<MultiIndexResults>

Search multiple specific indexes.

Arguments

• names - Index names to search
• query - Query vector
• k - Number of results per index

Errors

Returns error if any index doesn’t exist or search fails.

pub fn add( &mut self, index_name: &str, id: String, vector: &[f32], ) -> Result<()>

Add a vector to a specific index.

Errors

Returns error if index doesn’t exist or add fails.

pub fn remove_vector(&mut self, index_name: &str, id: &str) -> Result<bool>

Remove a vector from a specific index.

Errors

Returns error if index doesn’t exist.

pub fn clear_all(&mut self)

Clear all vectors from all indexes.

Trait Implementations

impl Debug for IndexRegistry

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for IndexRegistry

fn default() -> IndexRegistry

Returns the “default value” for a type.