gmodx 0.16.0

A swiss army knife for creating binary modules for Garry's Mod in Rust
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

// Thanks to mlua again

#[cfg(not(feature = "send"))]
mod inner {
    use std::cell::{Ref, RefCell, RefMut};

    pub type XRc<T> = std::rc::Rc<T>;
    pub type XCell<T> = RefCell<T>;
    pub type XRef<'a, T> = Ref<'a, T>;
    pub type XRefMut<'a, T> = RefMut<'a, T>;
}

#[cfg(feature = "send")]
mod inner {
    use std::sync::{Arc, Mutex, MutexGuard};

    pub type XRc<T> = Arc<T>;
    pub type XCell<T> = Mutex<T>;
    pub type XRef<'a, T> = MutexGuard<'a, T>;
    pub type XRefMut<'a, T> = MutexGuard<'a, T>; // Mutex has only one guard type
}

pub use inner::*;

// Error type aliases for try_* methods (unified across features)
#[cfg(not(feature = "send"))]
pub type XTryBorrowError = std::cell::BorrowError;
#[cfg(not(feature = "send"))]
pub type XTryBorrowMutError = std::cell::BorrowMutError;

#[cfg(feature = "send")]
pub type XTryLockError<'a, T> = std::sync::TryLockError<std::sync::MutexGuard<'a, T>>;

pub struct XRcCell<T>(XRc<XCell<T>>);

impl<T> XRcCell<T> {
    pub(crate) fn new(value: T) -> Self {
        Self(XRc::new(XCell::new(value)))
    }
}

#[cfg(not(feature = "send"))]
impl<T> XRcCell<T> {
    #[inline]
    pub fn borrow(&self) -> XRef<'_, T> {
        self.0.borrow()
    }

    #[inline]
    pub fn borrow_mut(&self) -> XRefMut<'_, T> {
        self.0.borrow_mut()
    }

    #[inline]
    pub fn try_borrow(&self) -> Result<XRef<'_, T>, XTryBorrowError> {
        self.0.try_borrow()
    }

    #[inline]
    pub fn try_borrow_mut(&self) -> Result<XRefMut<'_, T>, XTryBorrowMutError> {
        self.0.try_borrow_mut()
    }
}

#[cfg(feature = "send")]
impl<T> XRcCell<T> {
    #[inline]
    pub fn lock(&self) -> XRef<'_, T> {
        self.0.lock().expect("Mutex poisoned")
    }

    #[inline]
    pub fn try_lock(&self) -> Result<XRef<'_, T>, XTryLockError<'_, T>> {
        self.0.try_lock()
    }
}

impl<T> Clone for XRcCell<T> {
    fn clone(&self) -> Self {
        Self(self.0.clone())
    }
}

impl<T: Default> Default for XRcCell<T> {
    fn default() -> Self {
        Self::new(T::default())
    }
}

impl<T: std::fmt::Debug> std::fmt::Debug for XRcCell<T> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        #[cfg(not(feature = "send"))]
        {
            match self.try_borrow() {
                Ok(borrowed) => write!(f, "XRcCell({:?})", &*borrowed),
                _ => write!(f, "XRcCell(<borrowed>)"),
            }
        }
        #[cfg(feature = "send")]
        {
            match self.try_lock() {
                Ok(guard) => write!(f, "XRcCell({:?})", &*guard),
                _ => write!(f, "XRcCell(<locked>)"),
            }
        }
    }
}

impl<T> From<T> for XRcCell<T> {
    fn from(value: T) -> Self {
        XRcCell::new(value)
    }
}

impl<T> From<XRc<XCell<T>>> for XRcCell<T> {
    fn from(inner: XRc<XCell<T>>) -> Self {
        XRcCell(inner)
    }
}

impl<T> From<XRcCell<T>> for XRc<XCell<T>> {
    fn from(cell: XRcCell<T>) -> Self {
        cell.0
    }
}