pub struct SymbolCache { /* private fields */ }Expand description
Symbol cache for storing and retrieving parsed symbols
Implementations§
Source§impl SymbolCache
impl SymbolCache
Sourcepub const INSERT_SYMBOLS_SQL: &'static str = "INSERT OR REPLACE INTO symbols (file_id, file_hash, symbols_json, last_cached) \
VALUES (?, ?, ?, ?)"
pub const INSERT_SYMBOLS_SQL: &'static str = "INSERT OR REPLACE INTO symbols (file_id, file_hash, symbols_json, last_cached) \ VALUES (?, ?, ?, ?)"
The INSERT the background pass’s writer prepares once.
Sourcepub fn ensure_schema(conn: &Connection) -> Result<()>
pub fn ensure_schema(conn: &Connection) -> Result<()>
Create or migrate the symbols table on an already-open connection.
The query path calls this once per index handle (see
OpenIndex::meta_conn), not once per query: it is several statements
(pragma_table_info, CREATE TABLE, two CREATE INDEX, a version read)
that cost real milliseconds and never change between queries.
Sourcepub fn get(
&self,
file_path: &str,
file_hash: &str,
) -> Result<Option<Vec<SearchResult>>>
pub fn get( &self, file_path: &str, file_hash: &str, ) -> Result<Option<Vec<SearchResult>>>
Get cached symbols for a file (returns None if not cached or hash mismatch)
Sourcepub fn batch_get(
&self,
files: &[(String, String)],
) -> Result<Vec<(String, Option<Vec<SearchResult>>)>>
pub fn batch_get( &self, files: &[(String, String)], ) -> Result<Vec<(String, Option<Vec<SearchResult>>)>>
Get cached symbols for multiple files in one transaction (batch read)
This is significantly faster than calling get() repeatedly because:
- Opens only ONE database connection instead of N
- Reuses ONE prepared statement instead of creating N
- Executes in ONE transaction instead of N
Returns results in the same order as input. None means cache miss or hash mismatch.
Sourcepub fn batch_get_with_kind(
&self,
file_ids: &[(i64, String, String)],
kind_filter: Option<SymbolKind>,
) -> Result<HashMap<i64, Vec<SearchResult>>>
pub fn batch_get_with_kind( &self, file_ids: &[(i64, String, String)], kind_filter: Option<SymbolKind>, ) -> Result<HashMap<i64, Vec<SearchResult>>>
Get cached symbols for multiple files with optional kind filtering
Uses integer file_ids for fast batch retrieval, then filters by kind in Rust. This avoids the cache miss detection bug that occurs with SQL-level filtering.
Automatically chunks large batches to avoid SQLite parameter limits (999 max).
Parameters:
- file_ids: Vec of (file_id, file_hash, file_path) tuples
- kind_filter: Optional symbol kind to filter by (applied in Rust after retrieval)
Returns HashMap of file_id → symbols for cache hits.
Sourcepub fn batch_get_with_kind_on(
conn: &Connection,
file_ids: &[(i64, String, String)],
kind_filter: Option<SymbolKind>,
) -> Result<HashMap<i64, Vec<SearchResult>>>
pub fn batch_get_with_kind_on( conn: &Connection, file_ids: &[(i64, String, String)], kind_filter: Option<SymbolKind>, ) -> Result<HashMap<i64, Vec<SearchResult>>>
Self::batch_get_with_kind on an already-open connection.
Only rows whose stored file_hash equals the expected hash are returned.
INSERT OR REPLACE keys on (file_id, file_hash), so a file that changed
keeps its old-hash row next to the new one; before 2.0.0 this read ignored
the hash and could serve a changed file its pre-change symbols.
Sourcepub fn set(
&self,
file_path: &str,
file_hash: &str,
symbols: &[SearchResult],
) -> Result<()>
pub fn set( &self, file_path: &str, file_hash: &str, symbols: &[SearchResult], ) -> Result<()>
Store symbols for a file using file_id
Sourcepub fn batch_set_by_id_on(
conn: &mut Connection,
entries: &[(i64, String, Vec<SearchResult>)],
) -> Result<()>
pub fn batch_set_by_id_on( conn: &mut Connection, entries: &[(i64, String, Vec<SearchResult>)], ) -> Result<()>
Store parsed symbols for files already resolved to ids, in one transaction
on an open connection. Used by the query path for cache misses, which
previously opened a connection and ran an INSERT per file from inside the
parse pool.
Sourcepub fn batch_set(
&self,
entries: &[(String, String, Vec<SearchResult>)],
) -> Result<()>
pub fn batch_set( &self, entries: &[(String, String, Vec<SearchResult>)], ) -> Result<()>
Batch store symbols for multiple files in a single transaction
Sourcepub fn stats(&self) -> Result<SymbolCacheStats>
pub fn stats(&self) -> Result<SymbolCacheStats>
Get cache statistics
Sourcepub fn load_cached_keys_on(conn: &Connection) -> Result<HashSet<(i64, String)>>
pub fn load_cached_keys_on(conn: &Connection) -> Result<HashSet<(i64, String)>>
Every (file_id, file_hash) pair with a cached entry, in one query.
The background pass used to ask get once per file — a fresh
connection and two queries each, on one thread, for every file in the tree.
Sourcepub fn cleanup_stale_on(conn: &Connection) -> Result<usize>
pub fn cleanup_stale_on(conn: &Connection) -> Result<usize>
cleanup_stale on an open connection.
Sourcepub fn cleanup_stale(&self) -> Result<usize>
pub fn cleanup_stale(&self) -> Result<usize>
Remove symbols no indexed file or branch version needs any more
(see CLEANUP_STALE_SQL).
Auto Trait Implementations§
impl Freeze for SymbolCache
impl RefUnwindSafe for SymbolCache
impl Send for SymbolCache
impl Sync for SymbolCache
impl Unpin for SymbolCache
impl UnsafeUnpin for SymbolCache
impl UnwindSafe for SymbolCache
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
impl<T> ErasedDestructor for Twhere
T: 'static,
impl<A, B, T> HttpServerConnExec<A, B> for Twhere
B: Body,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<D> OwoColorize for D
impl<D> OwoColorize for D
Source§fn fg<C>(&self) -> FgColorDisplay<'_, C, Self>where
C: Color,
fn fg<C>(&self) -> FgColorDisplay<'_, C, Self>where
C: Color,
Source§fn bg<C>(&self) -> BgColorDisplay<'_, C, Self>where
C: Color,
fn bg<C>(&self) -> BgColorDisplay<'_, C, Self>where
C: Color,
Source§fn black(&self) -> FgColorDisplay<'_, Black, Self>
fn black(&self) -> FgColorDisplay<'_, Black, Self>
Source§fn on_black(&self) -> BgColorDisplay<'_, Black, Self>
fn on_black(&self) -> BgColorDisplay<'_, Black, Self>
Source§fn red(&self) -> FgColorDisplay<'_, Red, Self>
fn red(&self) -> FgColorDisplay<'_, Red, Self>
Source§fn on_red(&self) -> BgColorDisplay<'_, Red, Self>
fn on_red(&self) -> BgColorDisplay<'_, Red, Self>
Source§fn green(&self) -> FgColorDisplay<'_, Green, Self>
fn green(&self) -> FgColorDisplay<'_, Green, Self>
Source§fn on_green(&self) -> BgColorDisplay<'_, Green, Self>
fn on_green(&self) -> BgColorDisplay<'_, Green, Self>
Source§fn yellow(&self) -> FgColorDisplay<'_, Yellow, Self>
fn yellow(&self) -> FgColorDisplay<'_, Yellow, Self>
Source§fn on_yellow(&self) -> BgColorDisplay<'_, Yellow, Self>
fn on_yellow(&self) -> BgColorDisplay<'_, Yellow, Self>
Source§fn blue(&self) -> FgColorDisplay<'_, Blue, Self>
fn blue(&self) -> FgColorDisplay<'_, Blue, Self>
Source§fn on_blue(&self) -> BgColorDisplay<'_, Blue, Self>
fn on_blue(&self) -> BgColorDisplay<'_, Blue, Self>
Source§fn magenta(&self) -> FgColorDisplay<'_, Magenta, Self>
fn magenta(&self) -> FgColorDisplay<'_, Magenta, Self>
Source§fn on_magenta(&self) -> BgColorDisplay<'_, Magenta, Self>
fn on_magenta(&self) -> BgColorDisplay<'_, Magenta, Self>
Source§fn purple(&self) -> FgColorDisplay<'_, Magenta, Self>
fn purple(&self) -> FgColorDisplay<'_, Magenta, Self>
Source§fn on_purple(&self) -> BgColorDisplay<'_, Magenta, Self>
fn on_purple(&self) -> BgColorDisplay<'_, Magenta, Self>
Source§fn cyan(&self) -> FgColorDisplay<'_, Cyan, Self>
fn cyan(&self) -> FgColorDisplay<'_, Cyan, Self>
Source§fn on_cyan(&self) -> BgColorDisplay<'_, Cyan, Self>
fn on_cyan(&self) -> BgColorDisplay<'_, Cyan, Self>
Source§fn white(&self) -> FgColorDisplay<'_, White, Self>
fn white(&self) -> FgColorDisplay<'_, White, Self>
Source§fn on_white(&self) -> BgColorDisplay<'_, White, Self>
fn on_white(&self) -> BgColorDisplay<'_, White, Self>
Source§fn default_color(&self) -> FgColorDisplay<'_, Default, Self>
fn default_color(&self) -> FgColorDisplay<'_, Default, Self>
Source§fn on_default_color(&self) -> BgColorDisplay<'_, Default, Self>
fn on_default_color(&self) -> BgColorDisplay<'_, Default, Self>
Source§fn bright_black(&self) -> FgColorDisplay<'_, BrightBlack, Self>
fn bright_black(&self) -> FgColorDisplay<'_, BrightBlack, Self>
Source§fn on_bright_black(&self) -> BgColorDisplay<'_, BrightBlack, Self>
fn on_bright_black(&self) -> BgColorDisplay<'_, BrightBlack, Self>
Source§fn bright_red(&self) -> FgColorDisplay<'_, BrightRed, Self>
fn bright_red(&self) -> FgColorDisplay<'_, BrightRed, Self>
Source§fn on_bright_red(&self) -> BgColorDisplay<'_, BrightRed, Self>
fn on_bright_red(&self) -> BgColorDisplay<'_, BrightRed, Self>
Source§fn bright_green(&self) -> FgColorDisplay<'_, BrightGreen, Self>
fn bright_green(&self) -> FgColorDisplay<'_, BrightGreen, Self>
Source§fn on_bright_green(&self) -> BgColorDisplay<'_, BrightGreen, Self>
fn on_bright_green(&self) -> BgColorDisplay<'_, BrightGreen, Self>
Source§fn bright_yellow(&self) -> FgColorDisplay<'_, BrightYellow, Self>
fn bright_yellow(&self) -> FgColorDisplay<'_, BrightYellow, Self>
Source§fn on_bright_yellow(&self) -> BgColorDisplay<'_, BrightYellow, Self>
fn on_bright_yellow(&self) -> BgColorDisplay<'_, BrightYellow, Self>
Source§fn bright_blue(&self) -> FgColorDisplay<'_, BrightBlue, Self>
fn bright_blue(&self) -> FgColorDisplay<'_, BrightBlue, Self>
Source§fn on_bright_blue(&self) -> BgColorDisplay<'_, BrightBlue, Self>
fn on_bright_blue(&self) -> BgColorDisplay<'_, BrightBlue, Self>
Source§fn bright_magenta(&self) -> FgColorDisplay<'_, BrightMagenta, Self>
fn bright_magenta(&self) -> FgColorDisplay<'_, BrightMagenta, Self>
Source§fn on_bright_magenta(&self) -> BgColorDisplay<'_, BrightMagenta, Self>
fn on_bright_magenta(&self) -> BgColorDisplay<'_, BrightMagenta, Self>
Source§fn bright_purple(&self) -> FgColorDisplay<'_, BrightMagenta, Self>
fn bright_purple(&self) -> FgColorDisplay<'_, BrightMagenta, Self>
Source§fn on_bright_purple(&self) -> BgColorDisplay<'_, BrightMagenta, Self>
fn on_bright_purple(&self) -> BgColorDisplay<'_, BrightMagenta, Self>
Source§fn bright_cyan(&self) -> FgColorDisplay<'_, BrightCyan, Self>
fn bright_cyan(&self) -> FgColorDisplay<'_, BrightCyan, Self>
Source§fn on_bright_cyan(&self) -> BgColorDisplay<'_, BrightCyan, Self>
fn on_bright_cyan(&self) -> BgColorDisplay<'_, BrightCyan, Self>
Source§fn bright_white(&self) -> FgColorDisplay<'_, BrightWhite, Self>
fn bright_white(&self) -> FgColorDisplay<'_, BrightWhite, Self>
Source§fn on_bright_white(&self) -> BgColorDisplay<'_, BrightWhite, Self>
fn on_bright_white(&self) -> BgColorDisplay<'_, BrightWhite, Self>
Source§fn bold(&self) -> BoldDisplay<'_, Self>
fn bold(&self) -> BoldDisplay<'_, Self>
Source§fn dimmed(&self) -> DimDisplay<'_, Self>
fn dimmed(&self) -> DimDisplay<'_, Self>
Source§fn italic(&self) -> ItalicDisplay<'_, Self>
fn italic(&self) -> ItalicDisplay<'_, Self>
Source§fn underline(&self) -> UnderlineDisplay<'_, Self>
fn underline(&self) -> UnderlineDisplay<'_, Self>
Source§fn blink(&self) -> BlinkDisplay<'_, Self>
fn blink(&self) -> BlinkDisplay<'_, Self>
Source§fn blink_fast(&self) -> BlinkFastDisplay<'_, Self>
fn blink_fast(&self) -> BlinkFastDisplay<'_, Self>
Source§fn reversed(&self) -> ReversedDisplay<'_, Self>
fn reversed(&self) -> ReversedDisplay<'_, Self>
Source§fn strikethrough(&self) -> StrikeThroughDisplay<'_, Self>
fn strikethrough(&self) -> StrikeThroughDisplay<'_, Self>
Source§fn color<Color>(&self, color: Color) -> FgDynColorDisplay<'_, Color, Self>where
Color: DynColor,
fn color<Color>(&self, color: Color) -> FgDynColorDisplay<'_, Color, Self>where
Color: DynColor,
OwoColorize::fg or
a color-specific method, such as OwoColorize::green, Read moreSource§fn on_color<Color>(&self, color: Color) -> BgDynColorDisplay<'_, Color, Self>where
Color: DynColor,
fn on_color<Color>(&self, color: Color) -> BgDynColorDisplay<'_, Color, Self>where
Color: DynColor,
OwoColorize::bg or
a color-specific method, such as OwoColorize::on_yellow, Read more