Struct SessionManager 

pub struct SessionManager { /* private fields */ }

Manages cached unified code graphs for a workspace session.

Implementations

impl SessionManager

pub fn new() -> SessionResult<Self>

Create a session manager with default configuration and an empty plugin manager.

Note: For proper query execution with language support, use with_plugin_manager() instead, passing a PluginManager configured with the language plugins you need.

Errors

Returns SessionError when the background watcher thread cannot be spawned or when watcher initialization fails.

pub fn with_plugin_manager(plugin_manager: PluginManager) -> SessionResult<Self>

Create a session manager with a pre-configured plugin manager.

This is the recommended constructor for production use. The PluginManager should be created via sqry_plugin_registry::create_plugin_manager() or configured with the language plugins you need for query evaluation.

Arguments

• plugin_manager - A PluginManager configured with language plugins

Errors

Returns SessionError when watcher initialization or thread spawning fails.

pub fn with_config(config: SessionConfig) -> SessionResult<Self>

Create a session manager with the provided configuration.

Note: This uses an empty plugin manager. For proper query execution, use with_config_and_plugins() instead.

Errors

Returns SessionError when watcher initialization or thread spawning fails.

pub fn with_config_and_plugins( config: SessionConfig, plugin_manager: PluginManager, ) -> SessionResult<Self>

Create a session manager with configuration and a pre-configured plugin manager.

This is the most flexible constructor, allowing full control over both session configuration and plugin setup.

Arguments

• config - Session configuration (cache size, timeouts, etc.)
• plugin_manager - A PluginManager configured with language plugins

Errors

Returns SessionError when watcher initialization or thread spawning fails.

pub fn get_graph(&self, path: &Path) -> SessionResult<Arc<CodeGraph>>

Get the cached code graph for path, loading it from disk on demand.

Errors

Returns SessionError when the graph cannot be loaded.

pub fn query(&self, path: &Path, query_str: &str) -> SessionResult<QueryResults>

Query symbols from the cached graph for path.

This method loads the graph on demand and returns symbols that match the query criteria. The query string is parsed and evaluated against all symbols in the graph.

Errors

Returns SessionError when the graph cannot be loaded, query parsing fails, or query execution fails.

pub fn invalidate(&self, path: &Path) -> SessionResult<()>

Remove the cached graph for path, if present.

Errors

Returns SessionError when the file watcher fails to unwatch the path.

pub fn preload(&self, path: &Path) -> SessionResult<()>

Ensure the graph for path is loaded into the session cache without affecting query statistics.

Errors

Returns SessionError when loading from disk fails.

pub fn stats(&self) -> SessionStats

Return aggregate session statistics.

pub fn evict_stale(&self, now: Instant) -> SessionResult<usize>

Evict entries that have been idle longer than configured timeout.

Errors

Returns SessionError when watcher operations fail while removing paths.

pub fn shutdown(self) -> SessionResult<()>

Gracefully shut down the cleanup thread. Optional, as Drop handles it.

Errors

Returns SessionError when shutting down watcher operations fails.

Trait Implementations

impl Drop for SessionManager

fn drop(&mut self)

Executes the destructor for this type.