Struct PluginManager 

pub struct PluginManager {
    pub lua: Lua,
}

Orchestrates Zoi’s extensibility via global Lua plugins.

Plugins allow users to customize Zoi’s behavior by:

• Registering new subcommands (zoi.register_command).
• Intercepting lifecycle events (zoi.on_post_install, etc.).
• Overriding tool versions at runtime (shim resolution).

Plugins are stored in ~/.zoi/plugins/ and are verified against a trusted_hashes.json database to prevent unauthorized execution.

Fields

lua: Lua

The initialized mlua Lua Virtual Machine.

Implementations

impl PluginManager

pub fn new() -> Result<Self>

Initializes a new PluginManager and sets up the global Lua API.

This injects the entire zoi.* API surface into the Lua environment, enabling plugins to interact with the filesystem, HTTP, archives, the UI, and the hook registry.

Errors

Returns an error if the Lua VM cannot be initialized or if the zoi API fails to be injected.

pub fn set_context(&self, scope: Scope) -> Result<()>

Sets the operational scope for plugins.

Errors

Returns an error if the zoi global table cannot be accessed or if the scope cannot be set.

pub fn load_all(&self, yes: bool) -> Result<()>

Loads and executes all trusted Lua plugins from the plugin directory.

Errors

Returns an error if the plugin directory cannot be read, if a plugin script cannot be loaded, or if a plugin execution fails.

pub fn trigger_hook(&self, hook_name: &str, arg: Option<&Value>) -> Result<()>

Triggers a lifecycle hook, executing all registered callbacks.

Errors

Returns an error if the hook registry cannot be accessed or if any callback execution fails.

pub fn trigger_hook_nonfatal(&self, hook_name: &str, arg: Option<&Value>)

Triggers a lifecycle hook but ignores errors, printing a warning instead.

pub fn trigger_resolve_shim_version( &self, bin_name: &str, ) -> Result<Option<String>>

Triggers the shim version resolution hook.

Errors

Returns an error if the hook registry cannot be accessed or if any callback execution fails.

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

Triggers the project installation hook.

Errors

Returns an error if the hook registry cannot be accessed or if any callback execution fails.

pub fn run_command(&self, name: &str, args: Vec<String>) -> Result<bool>

Executes a custom command registered by a plugin.

Errors

Returns an error if the command registry cannot be accessed or if the command execution fails.

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

Lists all custom commands registered by plugins.

Errors

Returns an error if the command registry cannot be accessed.