deadpool 0.8.0

Dead simple async pool
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
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161

#[cfg(feature = "unmanaged")]
mod tests {

    use std::time::Duration;

    use tokio::time::{interval, timeout};

    use deadpool::unmanaged::{Pool, PoolError};

    #[tokio::test]
    async fn test_unmanaged_basic() {
        let pool = Pool::from(vec![(), (), ()]);

        let status = pool.status();
        assert_eq!(status.size, 3);
        assert_eq!(status.available, 3);

        let _val0 = pool.get().await;

        let status = pool.status();
        assert_eq!(status.size, 3);
        assert_eq!(status.available, 2);

        let _val1 = pool.get().await;

        let status = pool.status();
        assert_eq!(status.size, 3);
        assert_eq!(status.available, 1);

        let _val2 = pool.get().await;

        let status = pool.status();
        assert_eq!(status.size, 3);
        assert_eq!(status.available, 0);
    }

    #[tokio::test]
    async fn test_unmanaged_close() {
        let pool = Pool::<i64>::new(1);
        pool.try_add(42).unwrap();
        let obj = pool.get().await.unwrap();
        let join_handle = {
            let pool = pool.clone();
            tokio::spawn(async move { pool.get().await })
        };
        assert!(!pool.is_closed());
        assert_eq!(pool.status().available, 0);
        tokio::task::yield_now().await;
        pool.close();
        assert!(pool.is_closed());
        tokio::task::yield_now().await;
        assert_eq!(pool.status().available, 0);
        assert!(matches!(join_handle.await.unwrap(), Err(PoolError::Closed)));
        assert!(matches!(pool.get().await, Err(PoolError::Closed)));
        assert!(matches!(pool.try_get(), Err(PoolError::Closed)));
        drop(obj);
        assert!(pool.is_closed());
        assert!(matches!(pool.try_get(), Err(PoolError::Closed)));
        assert_eq!(pool.status().available, 0);
    }

    #[tokio::test(flavor = "multi_thread")]
    async fn test_unmanaged_concurrent() {
        let pool = Pool::from(vec![0usize, 0, 0]);

        // Spawn tasks
        let futures = (0..100)
            .map(|_| {
                let pool = pool.clone();
                tokio::spawn(async move {
                    *pool.get().await.unwrap() += 1;
                })
            })
            .collect::<Vec<_>>();

        // Await tasks to finish
        for future in futures {
            future.await.unwrap();
        }

        // Verify
        let status = pool.status();
        assert_eq!(status.size, 3);
        assert_eq!(status.available, 3);

        let values = [pool.get().await, pool.get().await, pool.get().await];

        assert_eq!(
            values
                .iter()
                .map(|obj| **obj.as_ref().unwrap())
                .sum::<usize>(),
            100
        );
    }

    #[tokio::test(flavor = "multi_thread")]
    async fn test_unmanaged_add_remove() {
        let pool = Pool::new(2);
        pool.add(1).await.unwrap();
        assert_eq!(pool.status().size, 1);
        pool.add(2).await.unwrap();
        assert_eq!(pool.status().size, 2);
        assert!(
            timeout(Duration::from_millis(10), pool.add(3))
                .await
                .is_err(),
            "adding a third item should timeout"
        );
        pool.remove().await.unwrap();
        assert_eq!(pool.status().size, 1);
        assert!(
            timeout(Duration::from_millis(10), pool.add(3))
                .await
                .is_ok(),
            "adding a third item should not timeout"
        );
        pool.remove().await.unwrap();
        assert_eq!(pool.status().size, 1);
        pool.remove().await.unwrap();
        assert_eq!(pool.status().size, 0);
    }

    #[tokio::test(flavor = "multi_thread")]
    async fn test_unmanaged_try_add_try_remove() {
        let pool = Pool::new(2);
        pool.try_add(1).unwrap();
        assert_eq!(pool.status().size, 1);
        pool.try_add(2).unwrap();
        assert_eq!(pool.status().size, 2);
        assert!(pool.try_add(3).is_err());
        pool.try_remove().unwrap();
        assert_eq!(pool.status().size, 1);
        assert!(pool.try_add(3).is_ok());
        pool.try_remove().unwrap();
        assert_eq!(pool.status().size, 1);
        pool.try_remove().unwrap();
        assert_eq!(pool.status().size, 0);
    }

    #[tokio::test(flavor = "multi_thread")]
    async fn test_unmanaged_add_timeout() {
        let pool = Pool::from(vec![1]);
        let add = {
            let pool = pool.clone();
            tokio::spawn(async move {
                pool.add(2).await.unwrap();
            })
        };
        let mut iv = interval(Duration::from_millis(10));
        iv.tick().await;
        iv.tick().await;
        pool.try_remove().unwrap();
        assert!(
            timeout(Duration::from_millis(10), add).await.is_ok(),
            "add should not timeout"
        );
        assert_eq!(pool.status().size, 1);
        assert_eq!(pool.try_remove().unwrap(), 2);
    }
}