qubit-dcl 0.2.3

Reusable double-checked lock executor for Rust lock abstractions
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

/*******************************************************************************
 *
 *    Copyright (c) 2025 - 2026 Haixing Hu.
 *
 *    SPDX-License-Identifier: Apache-2.0
 *
 *    Licensed under the Apache License, Version 2.0.
 *
 ******************************************************************************/
// qubit-style: allow explicit-imports
#[cfg(test)]
mod tests {
    use std::{
        io,
        panic::{AssertUnwindSafe, catch_unwind},
        sync::{
            Arc,
            atomic::{AtomicBool, Ordering},
        },
    };

    use qubit_dcl::{
        DoubleCheckedLock,
        double_checked::{ExecutionResult, ExecutorError},
    };
    use qubit_lock::ArcMutex;

    mod test_double_checked_lock_ready_builder {
        use super::*;

        #[test]
        fn test_log_methods_are_chainable_before_execute() {
            let data = ArcMutex::new(1);
            let executed = Arc::new(AtomicBool::new(false));

            let result = DoubleCheckedLock::on(data)
                .when(|| true)
                .log_unmet_condition(log::Level::Info, "condition not met")
                .log_prepare_failure(log::Level::Warn, "prepare failed")
                .log_prepare_commit_failure(log::Level::Error, "prepare commit failed")
                .log_prepare_rollback_failure(log::Level::Debug, "prepare rollback failed")
                .disable_unmet_condition_logging()
                .disable_prepare_failure_logging()
                .disable_prepare_commit_failure_logging()
                .disable_prepare_rollback_failure_logging()
                .execute({
                    let executed = executed.clone();
                    move || {
                        executed.store(true, Ordering::Release);
                        Ok::<(), io::Error>(())
                    }
                })
                .get_result();

            assert!(matches!(result, ExecutionResult::Success(())));
            assert!(executed.load(Ordering::Acquire));
        }

        #[test]
        fn test_catch_panics_catches_task_panic() {
            let data = ArcMutex::new(10);
            let result = DoubleCheckedLock::on(data)
                .when(|| true)
                .catch_panics()
                .prepare(|| Ok::<(), io::Error>(()))
                .execute_with(|_value: &mut i32| -> Result<(), io::Error> {
                    panic!("panic in convenient API task");
                })
                .get_result();

            assert!(matches!(
                result,
                ExecutionResult::Failed(ExecutorError::Panic(_))
            ));
        }

        #[test]
        fn test_set_catch_panics_false_allows_panic() {
            let data = ArcMutex::new(10);
            let result = catch_unwind(AssertUnwindSafe(|| {
                DoubleCheckedLock::on(data)
                    .when(|| true)
                    .set_catch_panics(true)
                    .set_catch_panics(false)
                    .execute_with(|_value: &mut i32| -> Result<(), io::Error> {
                        panic!("panic should propagate");
                    })
                    .get_result()
            }));

            assert!(result.is_err());
        }

        #[test]
        fn test_disable_catch_panics_allows_panic() {
            let data = ArcMutex::new(10);
            let caught = catch_unwind(AssertUnwindSafe(|| {
                DoubleCheckedLock::on(data)
                    .when(|| true)
                    .catch_panics()
                    .disable_catch_panics()
                    .execute_with(|_value: &mut i32| -> Result<(), io::Error> {
                        panic!("panic from ready builder disable_catch_panics");
                    })
                    .get_result();
            }));

            assert!(caught.is_err());
        }
    }
}