dope 0.8.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
67
68
69
70
71
72
73
74
75
76
77
78
79
80

use std::io;
use std::marker::PhantomData;
use std::os::fd::{BorrowedFd, OwnedFd};
use std::rc::Rc;

use dope_core::io::fd::Fd;

#[derive(Debug)]
enum Kind<'d> {
    Direct(Rc<OwnedFd>),
    Fixed(Rc<Fd<'d>>),
}

#[derive(Debug)]
pub struct Source<'d, K = Direct> {
    kind: Kind<'d>,
    marker: PhantomData<K>,
}

#[derive(Debug)]
pub enum Direct {}

#[derive(Debug)]
pub enum Fixed {}

#[doc(hidden)]
pub enum SourceRef<'d> {
    Direct(Rc<OwnedFd>),
    Fixed(Rc<Fd<'d>>),
}

impl<'d> Source<'d, Direct> {
    pub fn from_owned_fd(fd: OwnedFd) -> Self {
        Self::owned(fd)
    }

    pub fn try_from_fd(fd: BorrowedFd<'_>) -> io::Result<Self> {
        fd.try_clone_to_owned().map(Self::from_owned_fd)
    }

    #[doc(hidden)]
    pub fn direct(&self) -> Rc<OwnedFd> {
        match &self.kind {
            Kind::Direct(fd) => Rc::clone(fd),
            Kind::Fixed(_) => unreachable!(),
        }
    }

    #[doc(hidden)]
    pub fn owned(fd: OwnedFd) -> Self {
        Self {
            kind: Kind::Direct(Rc::new(fd)),
            marker: PhantomData,
        }
    }
}

impl<'d> Source<'d, Fixed> {
    #[doc(hidden)]
    pub fn fixed(fd: Fd<'d>) -> Self {
        Self {
            kind: Kind::Fixed(Rc::new(fd)),
            marker: PhantomData,
        }
    }
}

impl<'d, K> Source<'d, K> {
    pub fn is_fixed(&self) -> bool {
        matches!(self.kind, Kind::Fixed(_))
    }

    #[doc(hidden)]
    pub fn lease(&self) -> SourceRef<'d> {
        match &self.kind {
            Kind::Direct(fd) => SourceRef::Direct(Rc::clone(fd)),
            Kind::Fixed(fd) => SourceRef::Fixed(Rc::clone(fd)),
        }
    }
}