mirror of
https://github.com/tokio-rs/tokio.git
synced 2026-08-17 00:00:11 +02:00
Carl Lerche
4d514b7eb3
This patch relicenses the Tokio project exclusively under the MIT license. Before this, the project was dual licensed under MIT and Apache 2. As such, switching to only MIT is permitted. Fixes #202
55 lines
1.4 KiB
Markdown
55 lines
1.4 KiB
Markdown
# Tokio Thread Pool
|
|
|
|
A library for scheduling execution of futures concurrently across a pool of
|
|
threads.
|
|
|
|
**Note**: This library isn't quite ready for use.
|
|
|
|
### Why not Rayon?
|
|
|
|
Rayon is designed to handle parallelizing single computations by breaking them
|
|
into smaller chunks. The scheduling for each individual chunk doesn't matter as
|
|
long as the root computation completes in a timely fashion. In other words,
|
|
Rayon does not provide any guarantees of fairness with regards to how each task
|
|
gets scheduled.
|
|
|
|
On the other hand, `tokio-threadpool` is a general purpose scheduler and
|
|
attempts to schedule each task fairly. This is the ideal behavior when
|
|
scheduling a set of unrelated tasks.
|
|
|
|
### Why not futures-cpupool?
|
|
|
|
It's 10x slower.
|
|
|
|
## Examples
|
|
|
|
```rust
|
|
extern crate tokio_threadpool;
|
|
extern crate futures;
|
|
|
|
use tokio_threadpool::*;
|
|
use futures::*;
|
|
use futures::sync::oneshot;
|
|
|
|
pub fn main() {
|
|
let (tx, _pool) = ThreadPool::new();
|
|
|
|
let res = oneshot::spawn(future::lazy(|| {
|
|
println!("Running on the pool");
|
|
Ok::<_, ()>("complete")
|
|
}), &tx);
|
|
|
|
println!("Result: {:?}", res.wait());
|
|
}
|
|
```
|
|
|
|
## License
|
|
|
|
This project is licensed under the [MIT license](../LICENSE).
|
|
|
|
### Contribution
|
|
|
|
Unless you explicitly state otherwise, any contribution intentionally submitted
|
|
for inclusion in Tokio by you, shall be licensed as MIT, without any additional
|
|
terms or conditions.
|