#generator #yield #coroutine #async #await

macro genawaiter-proc-macro

procedural macro for generators (genawaiter)

2 releases

0.99.1 Mar 8, 2020
0.99.0 Feb 16, 2020

#13 in #yield

Download history 3889/week @ 2023-06-14 3978/week @ 2023-06-21 3579/week @ 2023-06-28 3351/week @ 2023-07-05 3096/week @ 2023-07-12 3229/week @ 2023-07-19 4051/week @ 2023-07-26 4292/week @ 2023-08-02 3785/week @ 2023-08-09 4672/week @ 2023-08-16 4415/week @ 2023-08-23 2981/week @ 2023-08-30 3439/week @ 2023-09-06 3528/week @ 2023-09-13 3968/week @ 2023-09-20 4570/week @ 2023-09-27

16,067 downloads per month
Used in genawaiter

MIT/Apache

9KB
164 lines

genawaiter

crate-badge docs-badge ci-badge

This crate implements stackless generators (aka coroutines) in stable Rust. Instead of using yield, which won't be stabilized anytime soon, you use async/await, which is stable today.

Features:

  • supports resume arguments and completion values
  • allocation-free
  • no runtime dependencies
    • no compile-time dependencies either, with default-features = []
  • built on top of standard language constructs, which means there are no platform-specific shenanigans

Example:

let odd_numbers_less_than_ten = gen!({
    let mut n = 1;
    while n < 10 {
        yield_!(n); // Suspend a function at any point with a value.
        n += 2;
    }
});

// Generators can be used as ordinary iterators.
for num in odd_numbers_less_than_ten {
    println!("{}", num);
}

Result:

1
3
5
7
9

See the docs for more.

Development

Install prerequisites

Install the pre-commit hook

pre-commit install

This installs a Git hook that runs a quick sanity check before every commit.

Run the app

cargo run

Run the tests

cargo test

Dependencies

~1.5MB
~32K SLoC