A flexible thread pool providing scoped and static threads.
Clone or download
Latest commit c4a3081 Feb 17, 2017
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples Add an example concurrent quicksort implementation. Mar 31, 2016
src Implement Default for WaitGroup and Pool. Jul 27, 2016
.gitignore (init) Jan 26, 2016
.travis.yml (init) Jan 26, 2016
Cargo.toml (release) 1.0.0. Jul 27, 2016
README.md Fix the broken link in the README Feb 17, 2017

README.md

scoped-pool

A flexible thread pool providing scoped and static threads.

Documentation

Overview

Example of simple use (applying a transformation to every item in an array):

extern crate scoped_pool;

use scoped_pool::Pool;

let pool = Pool::new(4);

let mut buf = [0, 0, 0, 0];

pool.scoped(|scope| {
    for i in &mut buf {
        scope.execute(move || *i += 1);
    }
});

assert_eq!(&buf, &[1, 1, 1, 1]);

Besides the core API used above (Pool::new, Pool::scoped) this crate also provides many extremely useful convenience functions for complex code using scoped threads.

Also includes the raw WaitGroup type, which can be used to implement similar "wait for a group of actions to complete" logic, and is used in Pool and Scope.

See the generated documentation (linked above) for details.

Unique Aspects

Unlike many other scoped threadpool crates, this crate is designed to be maximally flexible: Pool and Scope are both Send + Sync, Pool is Clone, and both have many useful conveniences such as:

Pool::spawn for spawning 'static jobs.

Pool::expand for expanding the number of threads in the pool.

Pool::shutdown for shutting down the pool.

Scope::forever and Scope::zoom for externalizing Scope management and allowing fine-grained control over when jobs are scheduled and waited on.

Nearly all methods on both types require only an immutable borrow, and thus are safe to use concurrently without external synchronization.

In addition, the internal design of this crate is carefully constructed so that all unsafety is encapsulated in the Scope type, which effectively just adds lifetime scoping to the WaitGroup type for jobs scheduled on a Pool.

Usage

Use the crates.io repository; add this to your Cargo.toml along with the rest of your dependencies:

[dependencies]
scoped-pool = "1"

Author

Jonathan Reem is the primary author and maintainer of scoped-pool.

License

MIT