Struct Runtime 

pub struct Runtime { /* private fields */ }

Single-threaded async runtime.

Examples

use nexus_async_rt::{Runtime, spawn_boxed, spawn_slab};
use nexus_slab::byte::unbounded::Slab;
use nexus_rt::WorldBuilder;

let mut world = WorldBuilder::new().build();

// Simple — Box-allocated tasks
let mut rt = Runtime::new(&mut world);
rt.block_on(async {
    spawn_boxed(async { /* Box-allocated */ });
});

// With slab for hot-path tasks
let slab = unsafe { Slab::<256>::with_chunk_capacity(64) };
let mut rt = Runtime::builder(&mut world)
    .slab_unbounded(slab)
    .build();
rt.block_on(async {
    spawn_boxed(async { /* Box-allocated */ });
    spawn_slab(async { /* slab-allocated */ });
});

Implementations

impl Runtime

pub fn new(world: &mut World) -> Self

Create a runtime with default settings. Box-allocated tasks only.

For slab allocation or custom configuration, use Runtime::builder.

pub fn builder(world: &mut World) -> RuntimeBuilder<'_>

Create a runtime via the builder pattern.

pub fn shutdown_handle(&self) -> ShutdownHandle

Returns a ShutdownHandle for triggering or observing shutdown.

pub fn install_signal_handlers(&self)

Install signal handlers for SIGTERM and SIGINT.

pub fn task_count(&self) -> usize

Number of live spawned tasks.

impl Runtime

pub fn block_on<F>(&mut self, future: F) -> F::Output

where F: Future + 'static,

Drive the root future to completion. CPU-friendly.

Parks the thread when no work is available.

pub fn block_on_busy<F>(&mut self, future: F) -> F::Output

where F: Future + 'static,

Drive the root future to completion. Busy-wait.

Never parks. Minimum wake latency at 100% CPU.