uringy 0.4.0

A simple single-threaded async runtime for Rust based on io_uring.
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

//! Timeouts and delays.

use crate::runtime;
use std::time::Duration;

/// Waits until duration has elapsed.
pub async fn sleep(duration: Duration) {
    let result = runtime::syscall(
        runtime::io_uring::opcode::Timeout::new(
            &runtime::io_uring::types::Timespec::new()
                .sec(duration.as_secs())
                .nsec(duration.subsec_nanos()),
        )
        .build(),
    )
    .await;

    // Timeout got completed through expiration of the timer
    assert_eq!(result.unwrap_err().raw_os_error().unwrap(), libc::ETIME);
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::runtime;
    use std::time::Instant;

    mod sleep {
        use super::*;

        #[test]
        fn returns_immediately_with_zero() {
            // Problematic for timerfd-based implementations

            runtime::block_on(async {
                // Given
                let before = Instant::now();

                // When
                sleep(Duration::from_millis(0)).await;

                // Then
                assert!(before.elapsed() <= Duration::from_millis(5));
            });
        }

        #[test]
        fn passes_time() {
            runtime::block_on(async {
                // Given
                let before = Instant::now();

                // When
                sleep(Duration::from_millis(5)).await;

                // Then
                assert!(before.elapsed() >= Duration::from_millis(5));
            });
        }
    }
}