microasync-rt

Crates.iomicroasync-rt
lib.rsmicroasync-rt
version0.2.1
sourcesrc
created_at2023-01-11 23:14:08.746367
updated_at2023-01-12 00:36:29.488877
descriptionA runtime for the very small async runner
homepage
repositoryhttps://github.com/tudbut/microasync-rt
max_upload_size
id756755
size25,626
Tud (TudbuT)

documentation

README

microasync-runtime

MicroAsync (GitHub) does not have many features, no IO support, no proper runtime. MicroAsync-Runtime provides such things:

  • A small runtime with the ability to add tasks (no_std supported)
  • A small timer
  • AsyncIO for Files, TCP, and UDP

QueuedRuntime

QueuedRuntime is a very small async runtime with support for adding more tasks while it is running. New tasks MUST only be added from within tasks already running on it OR before it is awaited!

use microasync::sync;
use microasync_rt::{QueuedRuntime, wait_ms};

fn main() {
    let mut runtime = QueuedRuntime::new();
    for _ in 0..50 {
        runtime.push(print_something_after_ms(2000));
    }
    sync(runtime);
}

async fn print_something_after_ms(ms: u64) {
    wait_ms(ms).await;
    println!("something! :D");
}
use microasync::sync;
use microasync_rt::{QueuedRuntime, wait_ms, get_current_runtime};

fn main() {
    sync(QueuedRuntime::new_with(print_something_after_ms(0)));
}

async fn print_something_after_ms(ms: u64) {
    wait_ms(ms).await;
    println!("something after {ms}ms! :D");
    get_current_runtime().await.push(print_something_after_ms(ms + 1));
}

Examples

There are a bunch of examples in examples/ - feel free to check those out!

Compatibility

MicroAsync-Runtime is compatible with async-core.

Commit count: 16

cargo fmt