# futures-cputask
This library allows you to run long-running CPU-bound tasks on a secondary thread pool and receive a future you can await on.
## Features
- Uses Futures 0.3.0
- For Async/Await
- Runs tasks on a secondary threadpool to avoid blocking one of the main executor threads
- Supports the threadpool from `threadpool` and `uvth` using their respective cargo feature
- Has traits for allowing interoperability with other threadpool implementations
- Contains an optional custom attribute `async_task` to turn a regular function into an async function using this crate
(Note: currently this feature only works with the `threadpool` and `uvth` threadpools)
## Usage
Add this to your `Cargo.toml`:
```toml
futures-cputask = "0.3.0"
```
if you want to use the custom attribute, add this:
```toml
[dependencies.futures-cputask]
version = "0.3.0"
features = ["derive"]
```
## Example
```rust
use futures_cputask::async_task;
#[async_task]
fn long_running_task() -> i64 {
(0..100_000_000).fold(0i64, |a, b| a.wrapping_add(b))
}
```
## 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.
## Contribution
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.