driveshaft 0.1.1

A minimal, high-performance thread pool for running synchronous tasks with per-thread context from async code.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

use crossbeam::channel::{bounded, unbounded};
use std::thread;

use crate::{
    DriveShaftError,
    job::{Job, JobReciever, JobSender},
};

#[derive(Copy, Clone)]
pub enum WorkerType {
    Bound(usize),
    UnBound,
}

fn spawn_tx<T: Send + 'static>(mut context: T, worker_type: WorkerType) -> JobSender<T> {
    let (tx, rx): (JobSender<T>, JobReciever<T>) = match worker_type {
        WorkerType::Bound(size) => bounded::<Job<T>>(size),
        WorkerType::UnBound => unbounded::<Job<T>>(),
    };
    let _handle = thread::spawn(move || {
        while let Ok(func) = rx.recv() {
            let context_ref = &mut context;
            func(context_ref).expect("The user gave us a good closure!")
        }
    });
    tx
}

pub struct BoundedWorker<T> {
    sender: JobSender<T>,
}

impl<T> BoundedWorker<T> {
    fn new(context: T, size: usize) -> BoundedWorker<T>
    where
        T: Send + 'static,
    {
        let tx = spawn_tx(context, WorkerType::Bound(size));
        BoundedWorker { sender: tx }
    }
}

pub struct UnboundedWorker<T> {
    pub sender: JobSender<T>,
}

impl<T> UnboundedWorker<T> {
    fn new(context: T) -> UnboundedWorker<T>
    where
        T: Send + 'static,
    {
        let tx = spawn_tx(context, WorkerType::UnBound);
        UnboundedWorker { sender: tx }
    }
}

pub enum Worker<T> {
    Bounded(BoundedWorker<T>),
    Unbounded(UnboundedWorker<T>),
}

impl<T> Worker<T> {
    pub fn new(worker_type: WorkerType, context: T) -> Worker<T>
    where
        T: Send + 'static,
    {
        match worker_type {
            WorkerType::Bound(size) => Worker::Bounded(BoundedWorker::new(context, size)),
            WorkerType::UnBound => Worker::Unbounded(UnboundedWorker::new(context)),
        }
    }

    pub fn send(&self, job: Job<T>) -> Result<(), DriveShaftError> {
        match self {
            Self::Bounded(worker) => worker
                .sender
                .send(job)
                .map_err(|_err| DriveShaftError::SendError),
            Self::Unbounded(worker) => worker
                .sender
                .send(job)
                .map_err(|_err| DriveShaftError::SendError),
        }
    }
}