interprocess 2.4.0

Interprocess communication toolkit
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

use {
    super::{
        r#type::{NamespacedNameType, PathNameType},
        Name,
    },
    std::{
        borrow::Cow,
        ffi::{CStr, CString, OsStr, OsString},
        io,
        path::{Path, PathBuf},
        str,
    },
};

macro_rules! trivial_string_impl {
    (
        $cvttrait:ident<$str:ident>
        :: $mtd:ident<$nttrait:ident>
        for $($tgt:ty => $via:ident :: $ctor:ident)+
    ) => {$(
        impl<'s> $cvttrait<'s, $str> for $tgt {
            #[inline]
            fn $mtd<T: $nttrait<$str>>(self) -> io::Result<Name<'s>> {
                $via::$ctor(self).$mtd::<T>()
            }
        }
    )+};
}

/// Conversion to a filesystem path-type local socket name.
pub trait ToFsName<'s, S: ToOwned + ?Sized> {
    /// Performs the conversion to a filesystem path-type name.
    ///
    /// Fails if the resulting name isn't supported by the platform.
    fn to_fs_name<NT: PathNameType<S>>(self) -> io::Result<Name<'s>>;
}

/// Conversion to a namespaced local socket name.
pub trait ToNsName<'s, S: ToOwned + ?Sized> {
    /// Performs the conversion to a namespaced name.
    ///
    /// Fails if the resulting name isn't supported by the platform.
    fn to_ns_name<NT: NamespacedNameType<S>>(self) -> io::Result<Name<'s>>;
}

#[allow(dead_code)]
fn err(s: &'static str) -> io::Error { io::Error::new(io::ErrorKind::Unsupported, s) }

impl<'s> ToFsName<'s, OsStr> for &'s Path {
    #[inline]
    fn to_fs_name<FT: PathNameType<OsStr>>(self) -> io::Result<Name<'s>> {
        FT::map(Cow::Borrowed(self.as_os_str()))
    }
}
impl<'s> ToFsName<'s, OsStr> for PathBuf {
    #[inline]
    fn to_fs_name<FT: PathNameType<OsStr>>(self) -> io::Result<Name<'s>> {
        FT::map(Cow::Owned(self.into_os_string()))
    }
}
trivial_string_impl! { ToFsName<OsStr>::to_fs_name<PathNameType> for
    &'s str   => Path   ::new
    String    => PathBuf::from
    &'s OsStr => Path   ::new
    OsString  => PathBuf::from
}

impl<'s> ToNsName<'s, OsStr> for &'s OsStr {
    #[inline]
    fn to_ns_name<NT: NamespacedNameType<OsStr>>(self) -> io::Result<Name<'s>> {
        NT::map(Cow::Borrowed(self))
    }
}
impl<'s> ToNsName<'s, OsStr> for OsString {
    #[inline]
    fn to_ns_name<NT: NamespacedNameType<OsStr>>(self) -> io::Result<Name<'s>> {
        NT::map(Cow::Owned(self))
    }
}
trivial_string_impl! { ToNsName<OsStr>::to_ns_name<NamespacedNameType> for
    &'s str => OsStr   ::new
    String  => OsString::from
}

impl<'s> ToFsName<'s, CStr> for &'s CStr {
    #[inline]
    fn to_fs_name<FT: PathNameType<CStr>>(self) -> io::Result<Name<'s>> {
        FT::map(Cow::Borrowed(self))
    }
}
impl<'s> ToFsName<'s, CStr> for CString {
    #[inline]
    fn to_fs_name<FT: PathNameType<CStr>>(self) -> io::Result<Name<'s>> {
        FT::map(Cow::Owned(self))
    }
}

impl<'s> ToNsName<'s, CStr> for &'s CStr {
    #[inline]
    fn to_ns_name<NT: NamespacedNameType<CStr>>(self) -> io::Result<Name<'s>> {
        NT::map(Cow::Borrowed(self))
    }
}
impl<'s> ToNsName<'s, CStr> for CString {
    #[inline]
    fn to_ns_name<NT: NamespacedNameType<CStr>>(self) -> io::Result<Name<'s>> {
        NT::map(Cow::Owned(self))
    }
}