futures-micro
To futures-lite as futures-lite is to futures: smaller.
Features:
-
Fun tools to write everything as async fns.
-
Tiny, no dependencies.
-
100%
no_stdsupport, no heap allocation required! -
Complete stable compiler support - Uses no nightly features!
-
Bootstrap tools:
poll_fn- wrap a function into a future.poll_state- wrap a function and some state into a future.pin!()- pin a value to the stack.
-
Futures interface subversion (poll interface from async fns):
waker()to get the current waker.sleep()to wait until you are woken.next_poll()- polls a future once, returning it for reuse if pending.
-
Common stuff:
pending()- never completes.ready()- completes on first poll.yield_once()- lets some other futures do some work .or()- return the result of the first future to complete.or!()-or(), but varargs.zip()- return the result of both futures when they both complete.zip!()-zip(), but varargs.ready!()- unwraps a ready value or returns pending.
Status
Beta? The API we have here seems pretty reasonable now.
If there's something you're missing, you may be looking for futures-lite.
Soundness
This crate uses unsafe for pin projection. We believe the code to be correct,
but we'd welcome more eyes on it.
Yes, we could get rid of them with pin-project-lite, but it's just
hiding the mess and then we couldn't claim zero dependencies.
Copyright and License
Copyright (c) 2020 James Laver, Matthieu le Brazidec, Stjepan Glavina, futures-micro contributors, futures-lite contributors Copyright (c) 2017 The Tokio Authors Copyright (c) 2016 Alex Crichton
Licensed under either of
- 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)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.