yielding-executor 0.10.0

Async executor with configurable yielding
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

# Yielding Executor for WebAssembly

[![Crate](https://img.shields.io/crates/v/yielding-executor.svg)](https://crates.io/crates/yielding-executor)
[![API](https://docs.rs/yielding-executor/badge.svg)](https://docs.rs/yielding-executor)

This executor is a fork of [wasm-rs-async-executor](https://github.com/wasm-rs/async-executor) decoupled from wasm-bindgen.

There are a number of async task executors available in Rust's ecosystem.
However, most (if not all?) of them rely on primitives that might not be
available or optimal for WebAssembly deployment at the time and rely on the
ability to monopolize a thread until completion. This crate gives you a simple
executor that you can configure to yield in arbitrary ways.

## Usage

Include this dependency in your `Cargo.toml`:

```toml
[dependencies]
yielding-executor = "0.9.0"
```

`yielding-executor` is expected to work on stable Rust, 1.49.0 and higher up.

## Supported targets

This crate passes tests for `wasm32-unknown-unknown` and `wasm32-wasi` targets and should not really be used for anything else. There are better executors for other targets.

## Notes

Please note that this library hasn't received much analysis in terms of safety
and soundness. Some of the caveats related to that might never be resolved
completely. This is an ongoing development and the maintainer is aware of
potential pitfalls. Any productive reports of unsafeties or unsoundness are
welcomed (whether they can be resolved or simply walled with `unsafe` for end-user
to note).

## License

Licensed under either of

- Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT) at your option.