dope-core 0.15.0

The manifold runtime
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

use std::mem;

use crate::{
    driver::route,
    io::{self, event},
};

/// A socket-creation completion and its affine driver target.
///
/// Safe code cannot mint completion authority.
///
/// ```compile_fail
/// use dope_core::{driver::route, io::{self, event::creation}};
///
/// let _ = creation::Completion::new(
///     route::SHUTDOWN,
///     io::SocketEvent::Failed(std::io::Error::other("not a driver completion")),
/// );
/// ```
///
/// Completion authority is consumed exactly once.
///
/// ```compile_fail
/// use dope_core::io::event::creation;
///
/// fn consume(_: creation::Completion<'static>) {}
/// fn replay(completion: creation::Completion<'static>) {
///     consume(completion);
///     consume(completion);
/// }
/// ```
#[repr(transparent)]
pub struct Completion<'d> {
    targeted: event::Targeted<io::SocketEvent<'d>>,
}

const _: () = {
    assert!(
        mem::size_of::<Completion<'static>>()
            == mem::size_of::<(route::Token, io::SocketEvent<'static>)>()
    );
    assert!(
        mem::align_of::<Completion<'static>>()
            == mem::align_of::<(route::Token, io::SocketEvent<'static>)>()
    );
};

impl<'d> Completion<'d> {
    pub(in crate::io) const fn new(token: route::Token, event: io::SocketEvent<'d>) -> Self {
        Self {
            targeted: event::Targeted::new(token, event),
        }
    }

    pub const fn token(&self) -> route::Token {
        self.targeted.token()
    }

    pub const fn event(&self) -> &io::SocketEvent<'d> {
        self.targeted.value()
    }

    pub fn into_parts(self) -> (route::Token, io::SocketEvent<'d>) {
        self.targeted.into_parts()
    }
}