Struct ReloadMailbox 

pub struct ReloadMailbox { /* private fields */ }

A reload-signal mail slot (B5d). The reload callback (built by reload_callback_from_mailbox) captures a clone; the TUI installs a tokio unbounded sender after it starts. When a plugin calls runtime_action(Reload), the callback signals () (if a TUI is installed) and the TUI performs the reload asynchronously — the plugin’s call returns Ok(null) immediately, so the calling plugin’s cdylib is NOT unmapped while its runtime_action frame is still on the stack (the reload, which drops the old keepalive, happens after the call returns). This breaks the self-unmapping race a synchronous plugin-initiated reload would have.

rpi-extensions carries only () (no pi-cli TuiMessage type) — preserving the leaf DAG. The TUI owns the receiver + the actual reload routine.

Implementations

impl ReloadMailbox

pub fn new() -> Self

A fresh empty mail slot (no TUI installed yet).

pub fn install(&self, tx: UnboundedSender<()>)

Install the TUI’s reload-signal sender (after the TUI starts). Replaces any prior sender. The TUI drops the receiver on shutdown; a sender held here keeps the channel half-open, so [clear] on shutdown is advised.

pub fn signal(&self) -> Result<(), ()>

Signal a reload (plugin-initiated via runtime_action(Reload)). Ok(()) if a TUI is installed (the signal was enqueued; the TUI may still be mid-reload). Err(()) if no TUI is installed (the host returns a “reload not available” error to the plugin).

pub fn clear(&self)

Drop the installed sender (TUI shutdown). Idempotent.

Trait Implementations

impl Clone for ReloadMailbox

fn clone(&self) -> ReloadMailbox

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for ReloadMailbox

fn default() -> Self

Returns the “default value” for a type.