object-pool 0.5.4

A thread-safe object pool with automatic return and attach/detach semantics
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

#[macro_use]
extern crate criterion;

use criterion::Criterion;
use object_pool::Pool;

static KB: usize = 1024;
static MB: usize = 1024 * KB;
static GB: usize = 1024 * MB;
static SIZES: &[usize] = &[
    4 * KB,
    16 * KB,
    64 * KB,
    128 * KB,
    512 * KB,
    1 * MB,
    16 * MB,
    32 * MB,
    64 * MB,
    128 * MB,
    256 * MB,
    512 * MB,
    1 * GB,
    2 * GB,
    3 * GB,
];

fn basics(c: &mut Criterion) {
    c.bench_function_over_inputs(
        "pulling_from_pool",
        |b, &&size| {
            let pool: Pool<Vec<u8>> = Pool::new(1, || Vec::with_capacity(size));
            b.iter(|| pool.try_pull())
        },
        SIZES,
    );

    c.bench_function_over_inputs(
        "detach_from_pool",
        |b, &&size| {
            let pool: Pool<Vec<u8>> = Pool::new(1, || Vec::with_capacity(size));
            b.iter(|| {
                let item = pool.try_pull().unwrap();
                let (_, vec) = item.detach();
                pool.attach(vec);
            })
        },
        SIZES,
    );

    c.bench_function_over_inputs(
        "alloc",
        |b, &&size| b.iter(|| Vec::<u8>::with_capacity(size)),
        SIZES,
    );
}

criterion_group!(benches, basics);
criterion_main!(benches);