rama-core 0.3.0

rama service core code, used by rama and service authors
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

/// Alternative for [`From`] which can be implemented by external crates for external types
///
/// To implement this trait, use a crate local `CrateMarker` generic type
/// More info: <https://ramaproxy.org/book/intro/patterns.html#working-around-the-orphan-rule-in-specific-cases>
///
/// Note: [`RamaFrom`] has a blacket implementation for types that implement [`From`]
pub trait RamaFrom<T, CrateMarker = ()> {
    fn rama_from(value: T) -> Self;
}

impl<T, U> RamaFrom<T> for U
where
    U: From<T>,
{
    fn rama_from(value: T) -> Self {
        Self::from(value)
    }
}

/// Alternative for [`Into`] which can be implemented by external crates for external types
///
/// To implement this trait, use a crate local `CrateMarker` generic type
/// More info: <https://ramaproxy.org/book/intro/patterns.html#working-around-the-orphan-rule-in-specific-cases>
///
/// Note: [`RamaInto`] has a blacket implementation for types that implement [`RamaFrom`] in
/// the opposite direction, and as such also work for types that implement [`Into`]
pub trait RamaInto<T, CrateMarker = ()>: Sized {
    fn rama_into(self) -> T;
}

impl<T, U, CrateMarker> RamaInto<U, CrateMarker> for T
where
    U: RamaFrom<T, CrateMarker>,
{
    #[inline(always)]
    fn rama_into(self) -> U {
        U::rama_from(self)
    }
}

/// Alternative for [`TryFrom`] which can be implemented by external crates for external types
///
/// To implement this trait, use a crate local `CrateMarker` generic type
/// More info: <https://ramaproxy.org/book/intro/patterns.html#working-around-the-orphan-rule-in-specific-cases>
///
/// Note: [`RamaTryFrom`] has a blacket implementation for types that implement [`TryFrom`]
pub trait RamaTryFrom<T, CrateMarker = ()>: Sized {
    type Error;
    fn rama_try_from(value: T) -> Result<Self, Self::Error>;
}

impl<T, U> RamaTryFrom<T> for U
where
    U: TryFrom<T>,
{
    type Error = U::Error;

    fn rama_try_from(value: T) -> Result<Self, Self::Error> {
        Self::try_from(value)
    }
}

/// Alternative for [`TryInto`] which can be implemented by external crates for external types
///
/// To implement this trait, use a crate local `CrateMarker` generic type
/// More info: <https://ramaproxy.org/book/intro/patterns.html#working-around-the-orphan-rule-in-specific-cases>
///
/// Note: [`RamaTryInto`] has a blacket implementation for types that implement [`RamaTryFrom`] in
/// the opposite direction, and as such also work for types that implement [`TryInto`]
pub trait RamaTryInto<T, CrateMarker = ()>: Sized {
    type Error;
    fn rama_try_into(self) -> Result<T, Self::Error>;
}

impl<T, U, CrateMarker> RamaTryInto<U, CrateMarker> for T
where
    U: RamaTryFrom<T, CrateMarker>,
{
    type Error = U::Error;

    #[inline(always)]
    fn rama_try_into(self) -> Result<U, U::Error> {
        U::rama_try_from(self)
    }
}

/// Create `Self` from a reference `T`
///
/// This is mostly used for extractors, but it can be used for anything
/// that needs to create an owned type from a reference
pub trait FromRef<T> {
    /// Converts to this type from a reference to the input type.
    fn from_ref(input: &T) -> Self;
}

pub use rama_macros::FromRef;

impl<T> FromRef<T> for T
where
    T: Clone,
{
    fn from_ref(input: &T) -> Self {
        input.clone()
    }
}