microasync-util 0.1.7

Utilities for the very small async runner
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

DEPRECATED, use [MicroAsync-RT](https://crates.io/crates/microasync-rt) instead!
================================================================================

# microasync-util

[MicroAsync](https://crates.io/crates/microasync)
([GitHub](https://github.com/tudbut/microasync)) does not have many features, no IO
support, no proper runtime. MicroAsync-Util 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!

```rs
use microasync::sync;
use microasync_util::{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");
}
```

```rs
use microasync::sync;
use microasync_util::{QueuedRuntime, wait_ms, get_current_runtime};

fn main() {
    let mut runtime = QueuedRuntime::new();
    runtime.push(print_something_after_ms(0));
    sync(runtime);
}

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!