#run-time #async #runner #io #async-io #tasks #timer

no-std microasync-rt

A runtime for the very small async runner

2 releases

0.2.1 Jan 12, 2023
0.2.0 Jan 11, 2023

#1960 in Embedded development

MIT license

20KB
484 lines

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.

Dependencies

~24KB