2020-08-29 19:35:41 +00:00
|
|
|
# bevy_tasks
|
|
|
|
|
|
|
|
A refreshingly simple task executor for bevy. :)
|
|
|
|
|
|
|
|
This is a simple threadpool with minimal dependencies. The main usecase is a scoped fork-join, i.e. spawning tasks from
|
2021-02-22 04:50:05 +00:00
|
|
|
a single thread and having that thread await the completion of those tasks. This is intended specifically for
|
2020-08-29 19:35:41 +00:00
|
|
|
[`bevy`][bevy] as a lighter alternative to [`rayon`][rayon] for this specific usecase. There are also utilities for
|
2021-02-22 04:50:05 +00:00
|
|
|
generating the tasks from a slice of data. This library is intended for games and makes no attempt to ensure fairness
|
2020-08-29 19:35:41 +00:00
|
|
|
or ordering of spawned tasks.
|
|
|
|
|
2020-09-10 19:54:24 +00:00
|
|
|
It is based on [`async-executor`][async-executor], a lightweight executor that allows the end user to manage their own threads.
|
|
|
|
`async-executor` is based on async-task, a core piece of async-std.
|
2020-08-29 19:35:41 +00:00
|
|
|
|
|
|
|
[bevy]: https://bevyengine.org
|
|
|
|
[rayon]: https://github.com/rayon-rs/rayon
|
2020-09-10 19:54:24 +00:00
|
|
|
[async-executor]: https://github.com/stjepang/async-executor
|
2020-08-29 19:35:41 +00:00
|
|
|
|
|
|
|
## Dependencies
|
|
|
|
|
|
|
|
A very small dependency list is a key feature of this module
|
|
|
|
|
2021-02-22 04:50:05 +00:00
|
|
|
```text
|
2020-09-10 19:54:24 +00:00
|
|
|
├── async-executor
|
2020-08-29 19:35:41 +00:00
|
|
|
│ ├── async-task
|
|
|
|
│ ├── concurrent-queue
|
|
|
|
│ │ └── cache-padded
|
|
|
|
│ └── fastrand
|
|
|
|
├── num_cpus
|
|
|
|
│ └── libc
|
|
|
|
├── parking
|
2020-09-10 19:54:24 +00:00
|
|
|
└── futures-lite
|
2020-08-29 19:35:41 +00:00
|
|
|
```
|