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.

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

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

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

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

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

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

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

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