aramid 🧵

Synthetic fibers and Rust.

• very much WIP 🚧 If you want to use it, please come back in 6 months. If you'd like to help hacking, welcome aboard! 💨⛵🌤️
• Fibers are little state machines that behave like stackful coroutines: when spun, they yield and yield, and then they return. In the meantime, they carry their stack around with them.
• Fibers are a model of concurrent computation. They are simple, lightweight and well-suited for cooperative multitasking.
• Fibers can be turned into iterators over their yielded values; and closures with their continuations can be fibers that live on the heap.

Getting started

• To try the library out, simply add it to your project's dependencies, by running the following Cargo command in your project directory:

  sh cargo add aramid

  Or add the following line to your Cargo.toml:

  toml aramid = "0.2.3"

• The documentation is available online at docs.rs.

• Check out the ./examples directory, i.e. a cool implementation of a monster patrolling its dungeon 👾🕹️.

What's the difference between Fibers and Iterators?

Iterators can be fibers too! The difference is mainly in the fact that Fibers have two return types: Yield and Output. A nice trick is to make a fiber yield some values, like an iterator, and then create another fiber as its final output. Weaving fibers like this can turn a bunch of them into a powerful finite state machine.