embedvec 0.7.0

Fast, lightweight, in-process vector database with HNSW indexing, E8/H4 lattice quantization (up to 24.8x compression), metadata filtering, and PyO3 bindings
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

//! Error types for embedvec
//!
//! ## Table of Contents
//! - **EmbedVecError**: Main error enum covering all failure modes
//! - **Result**: Type alias for Result<T, EmbedVecError>

use thiserror::Error;

/// Main error type for embedvec operations
#[derive(Error, Debug)]
pub enum EmbedVecError {
    /// Vector dimension is invalid (zero)
    #[error("Invalid dimension: {0}. Dimension must be > 0")]
    InvalidDimension(usize),

    /// Vector dimension doesn't match database configuration
    #[error("Dimension mismatch: expected {expected}, got {got}")]
    DimensionMismatch {
        /// Expected dimension
        expected: usize,
        /// Actual dimension provided
        got: usize,
    },

    /// Number of vectors and payloads don't match in batch operation
    #[error("Mismatched lengths: {vectors} vectors, {payloads} payloads")]
    MismatchedLengths {
        /// Number of vectors
        vectors: usize,
        /// Number of payloads
        payloads: usize,
    },

    /// Vector ID not found in storage
    #[error("Vector ID {0} not found")]
    VectorNotFound(usize),

    /// Index is empty, cannot perform search
    #[error("Index is empty")]
    EmptyIndex,

    /// Persistence operation failed
    #[error("Persistence error: {0}")]
    PersistenceError(String),

    /// Serialization/deserialization error
    #[error("Serialization error: {0}")]
    SerializationError(String),

    /// Quantization error
    #[error("Quantization error: {0}")]
    QuantizationError(String),

    /// Invalid parameter value
    #[error("Invalid parameter: {0}")]
    InvalidParameter(String),

    /// Internal error (should not happen in normal operation)
    #[error("Internal error: {0}")]
    InternalError(String),
}

/// Result type alias for embedvec operations
pub type Result<T> = std::result::Result<T, EmbedVecError>;

impl From<serde_json::Error> for EmbedVecError {
    fn from(e: serde_json::Error) -> Self {
        EmbedVecError::SerializationError(e.to_string())
    }
}

#[cfg(feature = "persistence")]
impl From<sled::Error> for EmbedVecError {
    fn from(e: sled::Error) -> Self {
        EmbedVecError::PersistenceError(e.to_string())
    }
}