Struct HotReloadManager 

pub struct HotReloadManager {
    pub loaded_plugins: HashMap<String, PluginVersion>,
    pub policy: ReloadPolicy,
    pub watchers: Vec<WatchEntry>,
    /* private fields */
}

Manages the hot-reload lifecycle for a set of plugins.

Simulation note

This implementation does not perform actual dynamic library loading; it manages the metadata and change-detection layer. The actual dlopen / dlclose operations are performed by the loader module (feature-gated on dynamic-loading).

Fields

loaded_plugins: HashMap<String, PluginVersion>

Currently loaded plugins by ID.

policy: ReloadPolicy

Active reload policy.

watchers: Vec<WatchEntry>

File watchers for change detection.

Implementations

impl HotReloadManager

pub fn new(policy: ReloadPolicy) -> Self

Create a new manager with the given policy and no loaded plugins.

pub fn register_loaded(&mut self, version: PluginVersion)

Register a plugin as loaded with the given metadata.

pub fn watch( &mut self, plugin_id: impl Into<String>, path: impl Into<String>, initial_content: &[u8], )

Add a watcher for a plugin path.

initial_content should be the current bytes of the plugin binary so that the baseline hash is computed correctly.

pub fn check_for_changes( &self, current_content: &HashMap<String, Vec<u8>>, ) -> Vec<String>

Check for changes by comparing current_content (indexed by plugin_id) against stored hashes.

Returns the IDs of plugins whose content has changed. The internal last_hash values are not updated here; call update_hash after a successful reload.

pub fn update_hash(&mut self, plugin_id: &str, new_content: &[u8])

Update the stored hash for a plugin after a successful reload.

pub fn reload_plugin( &mut self, plugin_id: &str, new_version: PluginVersion, ) -> PluginResult<()>

Simulate reloading a plugin (metadata update only — no actual dlopen).

Updates the loaded_at timestamp and version hash in the manager’s internal state.

Errors

Returns PluginError::NotFound if the plugin ID is not currently loaded.

pub fn unload_plugin(&mut self, plugin_id: &str) -> PluginResult<PluginVersion>

Unload a plugin, removing it from the manager.

Errors

Returns PluginError::NotFound if the plugin is not loaded.

pub fn is_scheduled_reload_due(&mut self) -> bool

Check whether a scheduled reload is due.

Returns true only when the policy is ReloadPolicy::Scheduled and the interval has elapsed. Resets the internal timer on a true return.

pub fn auto_reload_enabled(&self) -> bool

Return true if the policy allows automatic reloading.