Enum IndexError 

#[non_exhaustive]
pub enum IndexError {
    Io(Error),
    Sqlite(SqlxError),
    VectorStore(VectorStoreError),
    Llm(LlmError),
    Json(Error),
    Parse(String),
    UnsupportedLanguage,
    Watcher(Error),
    IntConversion(TryFromIntError),
    EmbedTimeout(u64),
    Other(String),
}

Errors that can occur during code indexing operations.

Examples

use zeph_index::error::{IndexError, Result};

fn must_succeed() -> Result<()> {
    Err(IndexError::UnsupportedLanguage)
}

assert!(matches!(must_succeed(), Err(IndexError::UnsupportedLanguage)));

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Io(Error)

I/O error reading source files from disk.

Raised when tokio::fs::read_to_string or std::fs::read_to_string fail, for example because a file was deleted between discovery and indexing.

Sqlite(SqlxError)

SQLite database error from sqlx.

Raised by metadata reads/writes in crate::store::CodeStore.

VectorStore(VectorStoreError)

Qdrant vector store error.

Raised by upsert, search, or collection management operations in crate::store::CodeStore.

Llm(LlmError)

LLM provider error during embedding.

Raised when the configured embedding provider returns an error, for example due to a network timeout or an unsupported model name.

Json(Error)

JSON serialization or deserialization error.

Raised when Qdrant payload values cannot be serialized or when point payloads contain unexpected types.

Parse(String)

Tree-sitter parsing error.

Raised when a grammar is unavailable for a language, or when tree-sitter fails to produce a parse tree (rare — tree-sitter is error-tolerant).

The inner String contains a human-readable description of the failure.

UnsupportedLanguage

Unsupported or unrecognized language.

Raised by crate::indexer when a file has a recognized extension but no corresponding tree-sitter grammar is available for it.

Watcher(Error)

Filesystem watcher initialization error.

Raised by crate::watcher::IndexWatcher::start when the underlying notify watcher cannot be created or the root path cannot be watched.

IntConversion(TryFromIntError)

Integer conversion error when mapping usize values to i64 or u64.

Raised when line numbers or chunk counts overflow the target integer type, which in practice only occurs on pathological inputs.

EmbedTimeout(u64)

Embedding call timed out.

Raised by crate::retriever::CodeRetriever and crate::indexer::CodeIndexer when provider.embed() does not complete within the configured timeout.

Other(String)

Generic catch-all error for cases that do not fit the variants above.

Used internally for errors like a panicking background thread (e.g., the directory walk spawn_blocking task).

Trait Implementations

impl Debug for IndexError

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

Formats the value using the given formatter.

impl Display for IndexError

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

Formats the value using the given formatter.

impl Error for IndexError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for IndexError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for IndexError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for IndexError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for IndexError

fn from(source: SqlxError) -> Self

Converts to this type from the input type.

impl From<LlmError> for IndexError

fn from(source: LlmError) -> Self

Converts to this type from the input type.

impl From<TryFromIntError> for IndexError

fn from(source: TryFromIntError) -> Self

Converts to this type from the input type.

impl From<VectorStoreError> for IndexError

fn from(source: VectorStoreError) -> Self

Converts to this type from the input type.