tokio-mpmc

A high-performance multi-producer multi-consumer (MPMC) queue implementation based on Tokio.

Features

• Asynchronous implementation based on Tokio
• Support for multi-producer multi-consumer pattern
• Message processing using consumer pool
• Simple and intuitive API
• Complete error handling
• Queue capacity control

Installation

Add the following dependency to your Cargo.toml:

[dependencies]
tokio-mpmc = "0.2"

Usage Example

Queue

use tokio_mpmc::Queue;

#[tokio::main]
async fn main() {
    // Create a queue with capacity of 100
    let queue = Queue::new(100);

    // Send a message
    if let Err(e) = queue.send("Hello").await {
        eprintln!("Send failed: {}", e);
    }

    // Receive a message
    match queue.receive().await {
        Ok(Some(msg)) => println!("Received message: {}", msg),
        Ok(None) => println!("Queue is empty"),
        Err(e) => eprintln!("Receive failed: {}", e),
    }

    // Close the queue
    drop(queue);
}

Channel

use tokio_mpmc::channel;

#[tokio::main]
async fn main() {
    // Create a channel with capacity of 100
    let (tx, rx) = channel(100);

    // Send a message
    if let Err(e) = tx.send("Hello").await {
        eprintln!("Send failed: {}", e);
    }

    // Receive a message
    match rx.recv().await {
        Ok(Some(msg)) => println!("Received message: {}", msg),
        Ok(None) => println!("Channel is closed"),
        Err(e) => eprintln!("Receive failed: {}", e),
    }

    // Close the channel
    drop(tx);
}

Performance

cargo criterion --message-format=json | criterion-table > BENCHMARKS.md

Benchmark Results

Note: non-io means no IO operation, io means IO operation.

See benchmark code

License

This project is licensed under the Apache-2.0 License. See the LICENSE file for details.