Generator-rs with stack allocation reuse

This is a fork of generator-rs modified to reuse stack allocations.

When using Loom, replacing generator-rs with this fork significantly reduces the test execution time (-62% observed on 9950X) by eliminating repeated mmap-related operations.

It is not recommended for general use cases because of drawbacks.

The original readme follows

---

Generator-rs

rust stackful generator library

[dependencies]
generator = "0.8"

Usage

use generator::{done, Gn};

fn main() {
    let g = Gn::new_scoped(|mut s| {
        let (mut a, mut b) = (0, 1);
        while b < 200 {
            std::mem::swap(&mut a, &mut b);
            b = a + b;
            s.yield_(b);
        }
        done!();
    });

    for i in g {
        println!("{}", i);
    }
}

Output

1
2
3
5
8
13
21
34
55
89
144
233

Goals

• basic send/yield with message support
• generator cancel support
• yield_from support
• panic inside generator support
• stack size tune support
• scoped static type support
• basic coroutine interface support
• stable rust support

based on this basic library

• we can easily port python library based on generator into rust
• coroutine framework running on multi thread

Notices

• This crate supports below platforms, welcome to contribute with other arch and platforms

  • x86_64 Linux
  • x86_64 macOS
  • x86_64 Windows
  • x86_64 Fuchsia
  • x86_64 Android
  • aarch64 Linux
  • aarch64 macOS
  • aarch64 Fuchsia
  • aarch64 Android
  • loongarch64 Linux
  • armv7 Linux
  • riscv64 Linux
  • powerpc64le Linux

License

This project is licensed under either of the following, at your option:

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT License (LICENSE-MIT or http://opensource.org/licenses/MIT)