Struct NylonRingHost 

pub struct NylonRingHost { /* private fields */ }

The main host for loading and managing nylon-ring plugins.

Implementations

impl NylonRingHost

pub fn new() -> Self

Create a new empty host.

pub fn with_stream_capacity(stream_capacity: usize) -> Self

Create a host with a bounded per-stream frame capacity.

pub fn load(&mut self, name: &str, path: &str) -> Result<()>

Load a plugin from the specified path with a given name.

The plugin must export nylon_ring_get_plugin and match this host’s ABI_VERSION exactly.

pub fn load_pinned(&mut self, name: &str, path: &str) -> Result<()>

Load a plugin that opts out of unload/reload for the life of the process.

Per-call guards on a pinned plugin skip the in-flight tracker RMWs (the dominant per-call cost on short paths); in exchange the plugin can never be unloaded, reloaded, or replaced, its shutdown callback never runs, and its library handle is intentionally leaked at host drop. Streams still take tracker slots.

pub fn unload(&mut self, name: &str) -> Result<()>

Unload a plugin by name.

pub async fn unload_with_grace( &mut self, name: &str, grace: Duration, ) -> Result<()>

Stop accepting new calls, then wait for tracked calls to drain.

pub fn reload(&mut self) -> Result<()>

Reload all plugins.

pub async fn reload_with_grace(&mut self, grace: Duration) -> Result<()>

Reload all plugins and wait for calls on replaced instances to drain.

pub fn plugin(&self, name: &str) -> Option<PluginHandle>

Get a handle to a loaded plugin by name.

pub fn metrics(&self) -> HostMetrics

Capture lightweight host metrics without allocating the shard map.

pub unsafe fn get_host_ext(host_ctx: *mut c_void) -> *const NrHostExt

Get host extension pointer from host_ctx.

Safety

The caller must ensure that host_ctx is a valid pointer to a HostContext instance that was created by this host, or a null pointer.

Trait Implementations

impl Default for NylonRingHost

fn default() -> Self

Returns the “default value” for a type.

impl Drop for NylonRingHost

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.