31 releases

new 0.10.10 Jan 11, 2022
0.10.9 Aug 25, 2021
0.10.7 Jun 10, 2021
0.10.2 Feb 7, 2021
0.2.0 Jul 31, 2019

#7 in Concurrency

Download history 18899/week @ 2021-09-26 19106/week @ 2021-10-03 19365/week @ 2021-10-10 24285/week @ 2021-10-17 23306/week @ 2021-10-24 22475/week @ 2021-10-31 21864/week @ 2021-11-07 22162/week @ 2021-11-14 19430/week @ 2021-11-21 22126/week @ 2021-11-28 23745/week @ 2021-12-05 24346/week @ 2021-12-12 17924/week @ 2021-12-19 14788/week @ 2021-12-26 25126/week @ 2022-01-02 23714/week @ 2022-01-09

82,854 downloads per month
Used in 270 crates (111 directly)

Apache-2.0/MIT

70KB
1.5K SLoC

Flume

A blazingly fast multi-producer, multi-consumer channel.

Cargo Documentation License actions-badge

use std::thread;

fn main() {
    println!("Hello, world!");

    let (tx, rx) = flume::unbounded();

    thread::spawn(move || {
        (0..10).for_each(|i| {
            tx.send(i).unwrap();
        })
    });

    let received: u32 = rx.iter().sum();

    assert_eq!((0..10).sum::<u32>(), received);
}

Why Flume?

  • Featureful: Unbounded, bounded and rendezvous queues
  • Fast: Always faster than std::sync::mpsc and sometimes crossbeam-channel
  • Safe: No unsafe code anywhere in the codebase!
  • Flexible: Sender and Receiver both implement Send + Sync + Clone
  • Familiar: Drop-in replacement for std::sync::mpsc
  • Capable: Additional features like MPMC support and send timeouts/deadlines
  • Simple: Few dependencies, minimal codebase, fast to compile
  • Asynchronous: async support, including mix 'n match with sync code
  • Ergonomic: Powerful select-like interface

Usage

To use Flume, place the following line under the [dependencies] section in your Cargo.toml:

flume = "x.y"

Benchmarks

Although Flume has its own extensive benchmarks, don't take it from here that Flume is quick. The following graph is from the crossbeam-channel benchmark suite.

Tests were performed on an AMD Ryzen 7 3700x with 8/16 cores running Linux kernel 5.11.2 with the bfq scheduler.

Flume benchmarks (crossbeam benchmark suite)

License

Flume is licensed under either of:

Dependencies

~260–560KB