Struct PluginManager 

pub struct PluginManager { /* private fields */ }

Manages language plugins for sqry.

The PluginManager is responsible for:

• Registering built-in plugins (statically linked)
• Looking up plugins by file extension or language name
• Enumerating available plugins

Phase 2 Scope

Phase 2 supports built-in plugins only (statically linked). External plugin loading (.so/.dylib) will be added in Phase 3.

Example

use sqry_core::plugin::PluginManager;

// Create manager with default built-in plugins
let manager = PluginManager::new();

// Lookup plugin by extension
if let Some(plugin) = manager.plugin_for_extension("rs") {
    println!("Found Rust plugin");
}

// Lookup plugin by language ID
if let Some(plugin) = manager.plugin_by_id("rust") {
    println!("Found Rust plugin by ID");
}

Implementations

impl PluginManager

pub fn new() -> Self

Create a new PluginManager with default built-in plugins.

Default built-ins will be registered in Phase 2 after the first plugin is implemented. For now, creates an empty manager.

Note

For tests requiring built-in plugins, use the plugin_factory_helpers test module:

use plugin_factory_helpers::with_builtin_plugins;
let manager = with_builtin_plugins();

pub fn with_plugins(plugins: Vec<Box<dyn LanguagePlugin>>) -> Self

Create a PluginManager with custom plugins.

This is primarily for testing, but can also be used to create a manager with a specific set of plugins.

Arguments

• plugins - Vector of boxed plugins to register

Example

use sqry_core::plugin::PluginManager;

let plugins = vec![
    Box::new(RustPlugin::new()) as Box<dyn LanguagePlugin>,
];

let manager = PluginManager::with_plugins(plugins);

pub fn register_builtin(&mut self, plugin: Box<dyn LanguagePlugin>)

Register a built-in plugin.

Adds a plugin to the manager and updates lookup caches.

Arguments

• plugin - Boxed plugin to register

Example

let mut manager = PluginManager::new();
manager.register_builtin(Box::new(RustPlugin::new()));

pub fn plugin_for_extension(&self, ext: &str) -> Option<&dyn LanguagePlugin>

Get plugin for file extension.

Returns a reference to the plugin that handles the given file extension.

Arguments

• ext - File extension without leading dot (e.g., “rs” not “.rs”)

Returns

Optional reference to the language plugin, or None if no plugin handles this extension.

Example

if let Some(plugin) = manager.plugin_for_extension("rs") {
    println!("Found {} plugin", plugin.metadata().name);
}

pub fn plugin_for_path(&self, path: &Path) -> Option<&dyn LanguagePlugin>

Get plugin for a file path, including special filename routing.

This helper supports standard extension matching and special-case routing for filenames like Pulumi.<stack>.yaml that cannot be resolved by extension alone.

pub fn plugin_by_id(&self, id: &str) -> Option<&dyn LanguagePlugin>

Get plugin by language ID.

Returns a reference to the plugin with the given stable language ID.

Arguments

• id - Stable language ID (e.g., “rust”, “javascript”)

Returns

Optional reference to the language plugin, or None if no plugin has this ID.

Example

if let Some(plugin) = manager.plugin_by_id("rust") {
    println!("Found Rust plugin");
}

pub fn plugins(&self) -> Vec<&dyn LanguagePlugin>

List all registered plugins.

Returns a vector of references to all plugins in the manager.

Returns

Vector of plugin references

Example

for plugin in manager.plugins() {
    let metadata = plugin.metadata();
    println!("Plugin: {} v{}", metadata.name, metadata.version);
}

pub fn plugin_state_hash(&self) -> u64

Get cached plugin state hash (for cache key)

Trait Implementations

impl Default for PluginManager

fn default() -> Self

Returns the “default value” for a type.