17 stable releases

1.9.1 May 18, 2021
1.9.0 Oct 21, 2020
1.8.1 Sep 17, 2020
1.7.1 Jun 15, 2020
0.0.1 Mar 11, 2017

#46 in Concurrency

Download history 188950/week @ 2021-04-05 188412/week @ 2021-04-12 189416/week @ 2021-04-19 190982/week @ 2021-04-26 184425/week @ 2021-05-03 195562/week @ 2021-05-10 211256/week @ 2021-05-17 209184/week @ 2021-05-24 201685/week @ 2021-05-31 213773/week @ 2021-06-07 227715/week @ 2021-06-14 226482/week @ 2021-06-21 214821/week @ 2021-06-28 210808/week @ 2021-07-05 220255/week @ 2021-07-12 205953/week @ 2021-07-19

792,541 downloads per month
Used in 3,706 crates (7 directly)

Apache-2.0/MIT

220KB
4K SLoC

Rayon-core represents the "core, stable" APIs of Rayon: join, scope, and so forth, as well as the ability to create custom thread-pools with ThreadPool.

Maybe worth mentioning: users are not necessarily intended to directly access rayon-core; all its APIs are mirror in the rayon crate. To that end, the examples in the docs use rayon::join and so forth rather than rayon_core::join.

rayon-core aims to never, or almost never, have a breaking change to its API, because each revision of rayon-core also houses the global thread-pool (and hence if you have two simultaneous versions of rayon-core, you have two thread-pools).

Please see Rayon Docs for details about using Rayon.

Rayon-core currently requires rustc 1.36.0 or greater.


lib.rs:

Rayon-core houses the core stable APIs of Rayon.

These APIs have been mirrored in the Rayon crate and it is recommended to use these from there.

join is used to take two closures and potentially run them in parallel.

  • It will run in parallel if task B gets stolen before task A can finish.
  • It will run sequentially if task A finishes before task B is stolen and can continue on task B.

scope creates a scope in which you can run any number of parallel tasks. These tasks can spawn nested tasks and scopes, but given the nature of work stealing, the order of execution can not be guaranteed. The scope will exist until all tasks spawned within the scope have been completed.

spawn add a task into the 'static' or 'global' scope, or a local scope created by the scope() function.

ThreadPool can be used to create your own thread pools (using ThreadPoolBuilder) or to customize the global one. Tasks spawned within the pool (using install(), join(), etc.) will be added to a deque, where it becomes available for work stealing from other threads in the local threadpool.

Restricting multiple versions

In order to ensure proper coordination between threadpools, and especially to make sure there's only one global threadpool, rayon-core is actively restricted from building multiple versions of itself into a single target. You may see a build error like this in violation:

error: native library `rayon-core` is being linked to by more
than one package, and can only be linked to by one package

While we strive to keep rayon-core semver-compatible, it's still possible to arrive at this situation if different crates have overly restrictive tilde or inequality requirements for rayon-core. The conflicting requirements will need to be resolved before the build will succeed.

Dependencies

~475KB