qubit-thread-pool 0.1.1

Dynamic and fixed thread pool executor services for Qubit Rust libraries
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

/*******************************************************************************
 *
 *    Copyright (c) 2025 - 2026 Haixing Hu.
 *
 *    SPDX-License-Identifier: Apache-2.0
 *
 *    Licensed under the Apache License, Version 2.0.
 *
 ******************************************************************************/
//! Tests for [`FixedThreadPoolBuilder`](qubit_thread_pool::service::FixedThreadPoolBuilder).

use std::io;

use qubit_thread_pool::service::{ExecutorService, FixedThreadPool, ThreadPoolBuildError};

use super::create_runtime;

#[test]
fn test_fixed_thread_pool_builder_rejects_invalid_configuration() {
    assert!(matches!(
        FixedThreadPool::builder().pool_size(0).build(),
        Err(ThreadPoolBuildError::ZeroMaximumPoolSize),
    ));
    assert!(matches!(
        FixedThreadPool::builder()
            .pool_size(1)
            .queue_capacity(0)
            .build(),
        Err(ThreadPoolBuildError::ZeroQueueCapacity),
    ));
    assert!(matches!(
        FixedThreadPool::builder()
            .pool_size(1)
            .stack_size(0)
            .build(),
        Err(ThreadPoolBuildError::ZeroStackSize),
    ));
}

#[test]
fn test_fixed_thread_pool_builder_reports_worker_spawn_failure() {
    let result = FixedThreadPool::builder()
        .pool_size(1)
        .stack_size(usize::MAX)
        .build();

    assert!(matches!(
        result,
        Err(ThreadPoolBuildError::SpawnWorker { .. })
    ));
}

#[test]
fn test_fixed_thread_pool_builder_sets_thread_options() {
    let pool = FixedThreadPool::builder()
        .pool_size(1)
        .queue_capacity(4)
        .unbounded_queue()
        .thread_name_prefix("fixed-custom")
        .stack_size(2 * 1024 * 1024)
        .build()
        .expect("fixed thread pool should be created with custom options");

    let name = pool
        .submit_callable(|| {
            Ok::<_, io::Error>(
                std::thread::current()
                    .name()
                    .expect("fixed worker should be named")
                    .to_owned(),
            )
        })
        .expect("fixed thread pool should accept callable")
        .get()
        .expect("callable should return worker name");

    assert!(name.starts_with("fixed-custom-"));
    assert_eq!(pool.pool_size(), 1);
    assert_eq!(pool.live_worker_count(), 1);
    assert_eq!(pool.queued_count(), 0);
    assert_eq!(pool.running_count(), 0);
    let stats = pool.stats();
    assert_eq!(stats.core_pool_size, 1);
    assert_eq!(stats.maximum_pool_size, 1);
    pool.shutdown();
    create_runtime().block_on(pool.await_termination());
}