dope-core 0.20.0

Owned native I/O and completion driver for dope
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

use std::mem;

use crate::driver::{life::native::request, retained, retained::flight, route, route::kind};

pub(crate) struct Bound<'owner, 'd: 'owner, R = request::Lowered, C: kind::Class = kind::Any> {
    raw: Captured<'owner, 'd, R>,
    reservation: flight::Reserved<'d, C>,
}

impl<'owner, 'd: 'owner, R, C: kind::Class> Bound<'owner, 'd, R, C> {
    pub(crate) fn new<Tag: route::Tag>(
        raw: Captured<'owner, 'd, R>,
        vacancy: flight::Vacant<'_, 'd, Tag, C>,
    ) -> Self {
        Self {
            raw,
            reservation: vacancy.reserve(),
        }
    }

    pub(in crate::driver::life::native::request) fn into_parts(
        self,
    ) -> (Captured<'owner, 'd, R>, flight::Reserved<'d, C>) {
        (self.raw, self.reservation)
    }
}

impl<'owner, 'd: 'owner, C: kind::Class> Bound<'owner, 'd, request::Datagram<'d>, C> {
    pub(crate) fn into_raw(self) -> Bound<'owner, 'd, request::Lowered, C> {
        Bound {
            raw: Captured::new(self.raw.raw.into_inner(), self.raw.token),
            reservation: self.reservation,
        }
    }
}

impl<'d, R, C: kind::Class> Bound<'d, 'd, R, C> {
    pub(crate) fn scoped<Tag: route::Tag>(raw: R, vacancy: flight::Vacant<'_, 'd, Tag, C>) -> Self {
        Self::new(Captured::scoped(raw), vacancy)
    }
}

const _: () = {
    assert!(
        mem::size_of::<Bound<'static, 'static>>()
            == mem::size_of::<(request::Lowered, flight::Reserved<'static>,)>()
    );
    assert!(
        mem::align_of::<Bound<'static, 'static>>()
            == mem::align_of::<(request::Lowered, flight::Reserved<'static>,)>()
    );
};

/// Backend value whose erased resources stay tied to one retained owner.
#[must_use]
#[repr(transparent)]
pub(crate) struct Captured<'owner, 'd: 'owner, R> {
    raw: R,
    token: retained::raw::Token<'owner, 'd>,
}

impl<'owner, 'd: 'owner, R> Captured<'owner, 'd, R> {
    pub(crate) fn new(raw: R, token: retained::raw::Token<'owner, 'd>) -> Self {
        Self { raw, token }
    }

    pub(in crate::driver::life::native::request) fn into_inner(self) -> R {
        self.raw
    }
}

impl<'d, R> Captured<'d, 'd, R> {
    /// Binds an owned backend value whose Rust borrows already carry `'d`.
    pub(in crate::driver::life::native::request) fn scoped(raw: R) -> Self {
        Self::new(raw, retained::raw::Token::scoped())
    }
}

const _: () = {
    assert!(mem::size_of::<Captured<'static, 'static, usize>>() == mem::size_of::<usize>());
    assert!(mem::align_of::<Captured<'static, 'static, usize>>() == mem::align_of::<usize>());
};