Struct CompsysCache 

pub struct CompsysCache { /* private fields */ }

SQLite cache for completion system

Implementations

impl CompsysCache

pub fn conn(&self) -> &Connection

Access the underlying SQLite connection (for dbview etc.)

pub fn count_table(&self, table: &str) -> Result<usize>

Count rows in a table.

pub fn count_table_where(&self, table: &str, condition: &str) -> Result<usize>

Count rows matching a WHERE clause.

pub fn open(path: impl AsRef<Path>) -> Result<Self>

Open or create cache database with maximum performance settings

pub fn memory() -> Result<Self>

In-memory cache (for testing)

pub fn add_autoload( &self, name: &str, source: &str, offset: i64, size: i64, ) -> Result<()>

Register an autoload stub (without body)

pub fn add_autoload_with_body( &self, name: &str, source: &str, body: &str, ) -> Result<()>

Register an autoload with full function body (for instant loading)

pub fn add_autoloads_bulk( &mut self, autoloads: &[(String, String, i64, i64)], ) -> Result<()>

Bulk insert autoloads (much faster)

pub fn add_autoloads_with_bodies_bulk( &mut self, autoloads: &[(String, String, String)], ) -> Result<()>

Bulk insert autoloads with bodies (for compinit to cache function definitions)

pub fn get_autoload(&self, name: &str) -> Result<Option<AutoloadStub>>

Lookup autoload by name

pub fn get_autoload_body(&self, name: &str) -> Result<Option<String>>

Get function body directly (fast path for autoload -Xz)

pub fn count_autoloads_with_body(&self) -> Result<usize>

Count autoloads with a non-NULL body. Replaces the legacy count_autoloads_missing_bytecode — bytecode coverage is now derived by subtracting the rkyv shard’s cached_names set from this count (caller-side, see the autoload_cache module in the zsh / zshrs library crate).

pub fn get_autoload_bodies_excluding( &self, exclude: &HashSet<String>, limit: usize, ) -> Result<Vec<(String, String)>>

Get a batch of (name, body) pairs for autoloads with a non-NULL body, excluding any whose name is in exclude (e.g. names already present in the rkyv autoload-bytecode shard). Used by compinit’s background backfill: SQLite supplies the source bodies, the caller parses+compiles, then writes results to the rkyv shard.

Returns up to limit entries; caller iterates until the empty vec or counts what was returned.

pub fn get_autoload_body_or_zwc(&self, name: &str) -> Option<String>

Get function body with ZWC fallback

1. If body column has content, return it (fast path)
2. If body is NULL but source/offset/size exist, read from ZWC file
3. Returns None if function not found or ZWC read fails

pub fn autoload_count(&self) -> Result<i64>

Count autoloads

pub fn list_autoloads(&self, limit: usize) -> Result<Vec<String>>

List all autoload names (for debugging)

pub fn list_autoload_names(&self) -> Result<Vec<String>>

List all autoload names (no limit)

pub fn set_zstyle( &self, pattern: &str, style: &str, values: &[String], eval: bool, ) -> Result<()>

Set a zstyle

pub fn set_zstyles_bulk( &mut self, styles: &[(String, String, Vec<String>, bool)], ) -> Result<()>

Bulk insert zstyles

pub fn delete_zstyle(&self, pattern: &str, style: Option<&str>) -> Result<usize>

Delete a zstyle

pub fn lookup_zstyle( &self, context: &str, style: &str, ) -> Result<Option<ZStyleEntry>>

Lookup zstyle - returns all matching patterns sorted by specificity

pub fn list_zstyles(&self) -> Result<Vec<(String, String, Vec<String>, bool)>>

List all zstyles (for zstyle -L)

pub fn zstyle_count(&self) -> Result<i64>

Count zstyles

pub fn set_comp(&self, command: &str, function: &str) -> Result<()>

Register a completion function for a command

pub fn set_comps_bulk(&mut self, comps: &[(String, String)]) -> Result<()>

Bulk insert comps + populate FTS5 index

pub fn comps_prefix_fts(&self, prefix: &str) -> Result<Vec<(String, String)>>

Fast prefix search using FTS5 (O(log n) vs O(n) for LIKE)

pub fn comps_prefix(&self, prefix: &str) -> Result<Vec<(String, String)>>

Fast prefix search (LIKE with index scan, ORDER BY is free on indexed column)

pub fn get_comp(&self, command: &str) -> Result<Option<String>>

Lookup completion function for command

pub fn get_all_comps(&self) -> Result<HashMap<String, String>>

Get all comps as HashMap (for compatibility)

pub fn comp_count(&self) -> Result<i64>

Count comps

pub fn delete_comp(&self, command: &str) -> Result<usize>

Delete a completion registration

pub fn set_patcomp(&self, pattern: &str, function: &str) -> Result<()>

Register a pattern completion

pub fn find_patcomp(&self, command: &str) -> Result<Option<String>>

Find matching pattern completion

pub fn set_keycomp(&self, key: &str, function: &str) -> Result<()>

Register a key completion (for -K)

pub fn get_keycomp(&self, key: &str) -> Result<Option<String>>

Lookup key completion

pub fn cache_results( &self, context: &str, data: &[u8], mtime: i64, ) -> Result<()>

Cache completion results

pub fn get_cached(&self, context: &str, max_age: i64) -> Result<Option<Vec<u8>>>

Get cached results if not stale

pub fn clear_stale_cache(&self, max_age: i64) -> Result<usize>

Clear old cache entries

pub fn clear_cache(&self) -> Result<()>

Clear all cache

pub fn vacuum(&self) -> Result<()>

Vacuum database

pub fn stats(&self) -> Result<CacheStats>

Get database stats

impl CompsysCache

pub fn comps_count(&self) -> Result<i64>

Get count of _comps entries (for $#_comps)

pub fn comps_keys(&self) -> Result<Vec<String>>

Get all _comps keys (for ${(k)_comps}) - ORDER BY is free on PRIMARY KEY

pub fn comps_values(&self) -> Result<Vec<String>>

Get all _comps values (for ${(v)_comps})

pub fn comps_kv(&self) -> Result<Vec<(String, String)>>

Get _comps as key-value pairs (for ${(kv)_comps})

pub fn patcomps_count(&self) -> Result<i64>

Get count of _patcomps

pub fn patcomps_keys(&self) -> Result<Vec<String>>

Get all _patcomps keys

pub fn patcomps_kv(&self) -> Result<Vec<(String, String)>>

Get all _patcomps as kv

pub fn set_service(&self, command: &str, service: &str) -> Result<()>

Set a service mapping

pub fn get_service(&self, command: &str) -> Result<Option<String>>

Get service for command

pub fn services_count(&self) -> Result<i64>

Get count of _services

pub fn services_keys(&self) -> Result<Vec<String>>

Get all _services keys

pub fn set_services_bulk(&mut self, services: &[(String, String)]) -> Result<()>

Bulk insert services

pub fn compautos_count(&self) -> Result<i64>

Get count of autoloaded functions

pub fn compautos_keys(&self) -> Result<Vec<String>>

Get all autoload names (for ${(k)_compautos})

pub fn has_executables(&self) -> Result<bool>

Check if executables cache is populated

pub fn set_executables_bulk( &mut self, executables: &[(String, String)], ) -> Result<()>

Store executables in bulk + populate FTS5 index

pub fn get_executable_names(&self) -> Result<HashSet<String>>

Get all executable names (fast lookup set)

pub fn has_executable(&self, name: &str) -> Result<bool>

Check if an executable exists in cache (O(1) lookup)

pub fn get_executable_path(&self, name: &str) -> Result<Option<String>>

Get executable path by name (direct key lookup)

pub fn get_executables_prefix_fts( &self, prefix: &str, ) -> Result<Vec<(String, String)>>

Fast prefix search using FTS5

pub fn get_executables_prefix( &self, prefix: &str, ) -> Result<Vec<(String, String)>>

Get executables matching prefix (LIKE with index, ORDER BY free on PRIMARY KEY)

pub fn executables_count(&self) -> Result<i64>

Count executables

pub fn has_named_dirs(&self) -> Result<bool>

Check if named_dirs cache is populated

pub fn set_named_dirs_bulk(&mut self, dirs: &[(String, String)]) -> Result<()>

Store named directories in bulk (clears existing)

pub fn get_named_dirs(&self) -> Result<Vec<(String, String)>>

Get all named directories (ORDER BY free on PRIMARY KEY)

pub fn get_named_dirs_prefix( &self, prefix: &str, ) -> Result<Vec<(String, String)>>

Get named directories matching prefix

pub fn named_dirs_count(&self) -> Result<i64>

Count named directories

pub fn has_shell_functions(&self) -> Result<bool>

Check if shell_functions cache is populated

pub fn set_shell_functions_bulk( &mut self, funcs: &[(String, String)], ) -> Result<()>

Store shell functions in bulk + populate FTS5 index

pub fn get_shell_function_names(&self) -> Result<Vec<String>>

Get all shell function names (ORDER BY free on PRIMARY KEY)

pub fn get_shell_functions(&self) -> Result<Vec<(String, String)>>

Get shell functions with source paths

pub fn get_shell_functions_prefix_fts( &self, prefix: &str, ) -> Result<Vec<(String, String)>>

Fast prefix search using FTS5 (note: FTS5 doesn’t preserve order, needs post-sort)

pub fn get_shell_functions_prefix( &self, prefix: &str, ) -> Result<Vec<(String, String)>>

Get shell functions matching prefix (LIKE with index, ORDER BY free)

pub fn shell_functions_count(&self) -> Result<i64>

Count shell functions

pub fn set_metadata(&self, key: &str, value: &str) -> Result<()>

Set metadata key-value

pub fn get_metadata(&self, key: &str) -> Result<Option<String>>

Get metadata value

pub fn has_zstyles(&self) -> Result<bool>

Check if zstyles cache is populated

pub fn zstyles_count(&self) -> Result<i64>

Count zstyles

pub fn get_all_zstyles(&self) -> Result<Vec<(String, String, String)>>

Get all zstyles (for debugging)