topcoat-runtime 0.10.0

A modular, batteries-included Rust web framework for server-rendered apps.
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
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

use std::ops::Deref;

use crate::{Surrogate, Surrogated};

impl Surrogated for () {
    type Surrogate = ();
    fn into_surrogate(self) -> Self::Surrogate {}
}

impl Surrogate for () {
    type Real = ();
    fn into_real(self) -> Self::Real {}
}

/// A tuple whose elements can be borrowed as runtime values.
pub trait TupleProject<'a> {
    /// A tuple of the borrowed elements' surrogates.
    type Projected;

    fn project(&'a self) -> Self::Projected;
}

/// A borrowed tuple of runtime values.
///
/// Field access reads the borrowed elements, so `.0` on a borrowed pair
/// borrows its first element.
pub struct TupleRefSurrogate<'a, T>
where
    T: TupleProject<'a>,
{
    real: &'a T,
    projected: T::Projected,
}

impl<'a, T> TupleRefSurrogate<'a, T>
where
    T: TupleProject<'a>,
{
    fn new(real: &'a T) -> Self {
        Self {
            real,
            projected: real.project(),
        }
    }
}

impl<'a, T> TupleRefSurrogate<'a, T>
where
    T: TupleProject<'a> + Surrogated + Clone,
{
    /// Clones the borrowed tuple into an owned tuple.
    // Cloning a `&(A, B)` yields an `(A, B)`, which `Clone` cannot express.
    #[must_use]
    #[allow(clippy::should_implement_trait)]
    pub fn clone(&self) -> T::Surrogate {
        self.real.clone().into_surrogate()
    }
}

impl<'a, T> Deref for TupleRefSurrogate<'a, T>
where
    T: TupleProject<'a>,
{
    type Target = T::Projected;

    fn deref(&self) -> &Self::Target {
        &self.projected
    }
}

impl<'a, T> serde::Serialize for TupleRefSurrogate<'a, T>
where
    T: TupleProject<'a>,
    T::Projected: serde::Serialize,
{
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        self.projected.serialize(serializer)
    }
}

macro_rules! impl_tuple_surrogate {
    ($($t:ident $idx:tt),+ $(,)?) => {
        impl<$($t),+> Surrogated for ($($t,)+)
        where
            $($t: Surrogated,)+
        {
            type Surrogate = ($(<$t as Surrogated>::Surrogate,)+);

            fn into_surrogate(self) -> Self::Surrogate {
                ($(self.$idx.into_surrogate(),)+)
            }
        }

        impl<$($t),+> Surrogate for ($($t,)+)
        where
            $($t: Surrogate,)+
        {
            type Real = ($(<$t as Surrogate>::Real,)+);

            fn into_real(self) -> Self::Real {
                ($(self.$idx.into_real(),)+)
            }
        }

        impl<'a, $($t: 'a),+> TupleProject<'a> for ($($t,)+)
        where
            $(&'a $t: Surrogated,)+
        {
            type Projected = ($(<&'a $t as Surrogated>::Surrogate,)+);

            fn project(&'a self) -> Self::Projected {
                ($((&self.$idx).into_surrogate(),)+)
            }
        }

        impl<'a, $($t: 'a),+> Surrogated for &'a ($($t,)+)
        where
            $(&'a $t: Surrogated,)+
        {
            type Surrogate = TupleRefSurrogate<'a, ($($t,)+)>;

            fn into_surrogate(self) -> Self::Surrogate {
                TupleRefSurrogate::new(self)
            }
        }

        impl<'a, $($t: 'a),+> Surrogate for TupleRefSurrogate<'a, ($($t,)+)>
        where
            $(&'a $t: Surrogated,)+
        {
            type Real = &'a ($($t,)+);

            fn into_real(self) -> Self::Real {
                self.real
            }
        }
    };
}

impl_tuple_surrogate!(T1 0);
impl_tuple_surrogate!(T1 0, T2 1);
impl_tuple_surrogate!(T1 0, T2 1, T3 2);
impl_tuple_surrogate!(T1 0, T2 1, T3 2, T4 3);
impl_tuple_surrogate!(T1 0, T2 1, T3 2, T4 3, T5 4);
impl_tuple_surrogate!(T1 0, T2 1, T3 2, T4 3, T5 4, T6 5);
impl_tuple_surrogate!(T1 0, T2 1, T3 2, T4 3, T5 4, T6 5, T7 6);
impl_tuple_surrogate!(T1 0, T2 1, T3 2, T4 3, T5 4, T6 5, T7 6, T8 7);
impl_tuple_surrogate!(T1 0, T2 1, T3 2, T4 3, T5 4, T6 5, T7 6, T8 7, T9 8);
impl_tuple_surrogate!(T1 0, T2 1, T3 2, T4 3, T5 4, T6 5, T7 6, T8 7, T9 8, T10 9);
impl_tuple_surrogate!(T1 0, T2 1, T3 2, T4 3, T5 4, T6 5, T7 6, T8 7, T9 8, T10 9, T11 10);
impl_tuple_surrogate!(
    T1 0, T2 1, T3 2, T4 3, T5 4, T6 5, T7 6, T8 7, T9 8, T10 9, T11 10, T12 11,
);