scoped-pool

Crates.ioscoped-pool
lib.rsscoped-pool
version1.0.0
sourcesrc
created_at2016-01-26 06:08:05.187347
updated_at2016-07-27 07:59:26.167655
descriptionA flexible thread pool providing scoped threads.
homepage
repositoryhttps://github.com/reem/rust-scoped-pool.git
max_upload_size
id3992
size25,861
log (github:rust-lang:log)

documentation

README

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 = "0.1"

Author

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

License

MIT

Commit count: 38

cargo fmt