qubit-lock 0.7.0

Lock utilities library providing synchronous, asynchronous, and monitor-based locking primitives
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

/*******************************************************************************
 *
 *    Copyright (c) 2025 - 2026 Haixing Hu.
 *
 *    SPDX-License-Identifier: Apache-2.0
 *
 *    Licensed under the Apache License, Version 2.0.
 *
 ******************************************************************************/
use qubit_lock::WaitTimeoutResult;

fn double_i32(value: i32) -> i32 {
    value * 2
}

fn i32_to_string(value: i32) -> String {
    value.to_string()
}

/// Test wait-timeout result variants and value semantics.
#[test]
fn test_wait_timeout_result_variants_are_distinct() {
    assert_eq!(WaitTimeoutResult::Ready(42), WaitTimeoutResult::Ready(42));
    assert_ne!(WaitTimeoutResult::Ready(42), WaitTimeoutResult::Ready(7));
    assert_ne!(WaitTimeoutResult::Ready(42), WaitTimeoutResult::TimedOut);

    let copied = WaitTimeoutResult::Ready("ready");
    assert_eq!(copied, copied);
}

/// Test wait-timeout result helper methods for ready values.
#[test]
fn test_wait_timeout_result_ready_helpers() {
    let result = WaitTimeoutResult::Ready(21);

    assert!(result.is_ready());
    assert!(!result.is_timed_out());
    assert_eq!(result.into_option(), Some(21));

    let mapped = WaitTimeoutResult::Ready(21).map(double_i32);
    assert_eq!(mapped, WaitTimeoutResult::Ready(42));

    let mapped_to_string = WaitTimeoutResult::Ready(21).map(i32_to_string);
    assert_eq!(
        mapped_to_string,
        WaitTimeoutResult::Ready(String::from("21"))
    );
}

/// Test wait-timeout result helper methods for timeout values.
#[test]
fn test_wait_timeout_result_timed_out_helpers() {
    let result = WaitTimeoutResult::<i32>::TimedOut;

    assert!(!result.is_ready());
    assert!(result.is_timed_out());
    assert_eq!(result.into_option(), None);

    let mapped = WaitTimeoutResult::<i32>::TimedOut.map(double_i32);
    assert_eq!(mapped, WaitTimeoutResult::TimedOut);

    let mapped_to_string: WaitTimeoutResult<String> =
        WaitTimeoutResult::<i32>::TimedOut.map(i32_to_string);
    assert_eq!(mapped_to_string, WaitTimeoutResult::TimedOut);
}