gen-z 0.1.0

Macro-free stream construction through asynchronous generators via an awaitable sender
Documentation
  • Coverage
  • 33.33%
    2 out of 6 items documented0 out of 5 items with examples
  • Size
  • Source code size: 20.52 kB This is the summed size of all the files inside the crates.io package for this release.
  • Documentation size: 1.54 MB This is the summed size of all files generated by rustdoc for all configured targets
  • Links
  • Dessix/gen-z-rs
    2 0 0
  • crates.io
  • Dependencies
  • Versions
  • Owners
  • Dessix

Generators are still unstable, and generating streams requires complicated ownership handling, so this crate aims to enable ad-hoc generation of streams.

Current async implementations attempt to provide yield syntax via macros, but this is not transparent to IDEs at the time of this library's creation, so gen_z attempts to work in a way that IDEs understand.

gen_z(|mut z| async move {
  let awaited = bar().await; // Make awaitable calls in the generator
  z.send(awaited).await; // Streams do not support responses; `yield` has output `()`
  // Share yield helper with calls, allowing them to emit outputs while producing values
  let shared_result = baz(&mut z).await;
  z.send(foo + shared_result).await;
  // Return is infallible; if `Result` is needed, wrap calls to comply with TryStream
}) // => Result is a futures::stream::Stream<Item = T>
  • Send is required for Stream::Item.
    • The stream is Send if the provided future is also Send.
  • Sync is available if Stream::Item and the future are both Sync.
  • The generator only requires FnOnce, so it may close over mutable references.
  • Infinite streams can be generated by looping within the provided future
  • Generators are infallible; the given future must return (), run forever, or panic.
    • To use Result<_, _>, create an inner-future which returns Result and convert an Err return to a type compatible with Stream::Item. TryStream compatibility can be achieved by setting the Stream::Item type to Result<T, TErr>.