poolio 0.2.3

A thread pool.
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
44
45
46
47
48
49
50
51
52
53

# poolio

[![crates.io][crates-badge]][crates-url]
[![GPL licensed][license-badge]][license-url]
[![CI][actions-badge]][actions-url]

[crates-badge]: https://img.shields.io/crates/v/poolio.svg
[crates-url]: https://crates.io/crates/poolio
[license-badge]: https://img.shields.io/badge/license-GPL-blue.svg
[license-url]: ./Cargo.toml
[actions-badge]: https://github.com/shtsoft/poolio/actions/workflows/ci.yaml/badge.svg
[actions-url]: https://github.com/shtsoft/poolio/actions/workflows/ci.yaml

A **simple**, **safe**, and **fast** thread pool based on pure message-passing concurrency that defies the mainstream.

- simplicity:
  * small API
  * less than 300 lines of code
- safety:
  * no dependencies (apart from crossbeam)
  * thoroughly tested
  * memory-safety: no `unsafe` code
  * thread-safety:
    + no data races
    + no deadlocks
- performance:
  * [crossbeam](https://github.com/crossbeam-rs/crossbeam) channels
  * as fast as the most popular Rust [threadpool](https://github.com/rust-threadpool/rust-threadpool) (see [Benchmarks](#benchmarks))

For documentation, see the [Released API docs](https://docs.rs/poolio).
In particular, you can find design and usage descriptions there.

### Benchmarks

The [benchmarks](benches) pit poolio against [threadpool](https://github.com/rust-threadpool/rust-threadpool) in a test of computing various lists of primes and writing them to a sink.
On an Intel(R) Core(TM) i7-9750H CPU @ 2.60GHz (6 cores, 12 threads) running x86_64 GNU/Linux, we measured the following average execution times:

| Primes     | poolio     | threadpool |
| ---------- | ----------:| ----------:|
| 6 workers  | 27.468 ms  | 28.431 ms  |
| 12 workers | 24.056 ms  | 23.456 ms  |

This suggests that poolio and threadpool are equally performant.
The full results can be downloaded [here](https://github.com/shtsoft/poolio/releases/latest/download/benches.tar.gz).
(The benchmarks are powered by [criterion](https://github.com/bheisler/criterion.rs).)

## Contributing

If you want to contribute: [CONTRIBUTING](CONTRIBUTING.md).

### Security

For security-related issues, see: [SECURITY](SECURITY.md).