Struct KernelHandle 

pub struct KernelHandle {
    id: KernelId,
    inner: Arc<dyn KernelHandleInner>,
}

Handle to a launched kernel.

Provides an ergonomic API for interacting with a kernel.

Fields

id: KernelId

Kernel identifier.

inner: Arc<dyn KernelHandleInner>

Inner implementation.

Implementations

impl KernelHandle

pub fn new(id: KernelId, inner: Arc<dyn KernelHandleInner>) -> Self

Create a new kernel handle.

pub fn id(&self) -> &KernelId

Get the kernel ID.

pub async fn activate(&self) -> Result<()>

Activate the kernel.

pub async fn deactivate(&self) -> Result<()>

Deactivate the kernel.

pub async fn terminate(&self) -> Result<()>

Terminate the kernel.

pub async fn send<M: RingMessage>(&self, message: M) -> Result<()>

Send a message to the kernel.

pub async fn send_envelope(&self, envelope: MessageEnvelope) -> Result<()>

Send a raw envelope.

pub async fn receive(&self) -> Result<MessageEnvelope>

Receive a message from the kernel.

pub async fn receive_timeout( &self, timeout: Duration, ) -> Result<MessageEnvelope>

Receive a message with timeout.

pub fn try_receive(&self) -> Result<MessageEnvelope>

Try to receive a message (non-blocking).

pub async fn call<M: RingMessage>( &self, message: M, timeout: Duration, ) -> Result<MessageEnvelope>

Send request and wait for response (call pattern).

pub fn status(&self) -> KernelStatus

Get kernel status.

pub fn metrics(&self) -> KernelMetrics

Get kernel metrics.

pub async fn wait(&self) -> Result<()>

Wait for kernel to terminate.

pub fn state(&self) -> KernelState

Get the current kernel state.

This is a convenience method that returns just the state from status().

pub async fn suspend(&self) -> Result<()>

Suspend (deactivate) the kernel.

This is an alias for deactivate() for more intuitive API usage.

pub async fn resume(&self) -> Result<()>

Resume (activate) the kernel.

This is an alias for activate() for more intuitive API usage.

pub fn is_active(&self) -> bool

Check if the kernel is currently active.

pub fn is_terminated(&self) -> bool

Check if the kernel has terminated.

Trait Implementations

impl Clone for KernelHandle

fn clone(&self) -> KernelHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KernelHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.