2 releases
0.1.1 | Oct 10, 2020 |
---|---|
0.1.0 | Sep 8, 2020 |
#524 in Asynchronous
28,081 downloads per month
Used in 55 crates
(18 directly)
8KB
53 lines
spin_on
This crate contains what aims to be the simplest possible implementation of a valid executor. Instead of nicely parking the thread and waiting for the future to wake it up, it continuously polls the future until the future is ready. This will probably use a lot of CPU, so be careful when you use it.
assert_eq!(12, spin_on::spin_on(async {3 * 4}))
The advantages of this crate are:
- It is really simple
- It should work on basically any platform
- It has no dependency on
std
or on an allocator - It only has one dependency
The Design
This crate intentionally violates one of the guidelines of Future
: as of Rust 1.46, the
runtime characteristics
of core::future::Future
says:
The
poll
function is not called repeatedly in a tight loop -- instead, it should only be called when the future indicates that it is ready to make progress (by callingwake()
).
When no Future can make progress, a well-behaved executor should suspend execution and
wait until an external event resumes execution. As far as I know, though, there is not a
cross-platform way to suspend a thread. With Rust's std
, this would be done by using
thread::park
. But, for example, if you're on an embedded board with an ARM Cortex M processor,
you would instead use a WFE or WFI instruction. So, an execution-suspending executor would need
to be adapted for each different platform.
What price do we pay for violating this guideline? This executor is a "resource hog," since it continually runs the CPU at 100%. On an embedded system, this could cause increased power usage. In a situation where many programs are running, this could make your application waste CPU resources that could otherwise be put to good use by other applications.
When might this be useful?
- Running async applications on a platform that doesn't have an executor
- Testing that an async crate works with
no_std
- Educational purposes?
- Implementing an application where you don't care about performance
License: Apache-2.0 OR MIT
Dependencies
~6KB