Struct IndexLocation 

pub struct IndexLocation {
    pub index_root: PathBuf,
    pub query_scope: PathBuf,
    pub is_ancestor: bool,
    pub is_file_query: bool,
    pub requires_scope_filter: bool,
}

Result of index discovery, containing location and scope information.

Fields

index_root: PathBuf

Absolute path to the directory containing .sqry-index

query_scope: PathBuf

Original path the user requested (for scoping results)

is_ancestor: bool

True if index was found in an ancestor directory (relative to start dir)

is_file_query: bool

True if the query scope is a file (not a directory)

requires_scope_filter: bool

True if query augmentation/filtering is needed. This is true when:

• Index is in ancestor directory (is_ancestor), OR
• Query targets a specific file (is_file_query)

Note: File queries always need filtering even when the index is in the file’s parent directory (is_ancestor would be false due to how we start discovery from the parent).

Implementations

impl IndexLocation

pub fn relative_scope(&self) -> Option<PathBuf>

Get the relative path from index_root to query_scope for filtering.

Returns:

• Some(relative_path) when scope filtering is needed and path is inside index root
• None when no filtering needed (query_scope == index_root and !is_file_query)
• None when query_scope is outside index_root (edge case, shouldn’t happen)

Note: Uses requires_scope_filter (not is_ancestor) to ensure file queries in the index root still compute their relative scope for exact-match filtering.

Trait Implementations

impl Clone for IndexLocation

fn clone(&self) -> IndexLocation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IndexLocation

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

Formats the value using the given formatter.