sark-core 0.24.0

Fiber-free request, route, dispatch, and lifecycle core for Sark
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

use core::convert::Infallible;
type Emitted<'d, S> = Result<
    (<S as decode::Encode<'d, 'd>>::Prepared, life::Outcome),
    (
        <S as decode::Encode<'d, 'd>>::Error,
        <S as decode::Cancel>::Target,
    ),
>;

use sark_http::{
    payload::response::{Response, dispatch},
    request::Id,
};

use crate::{
    decode, life,
    route::{self, Reject},
};

pub enum Outcome<T> {
    Response(T),
    Rejected(Reject),
}

/// Route-specific result retained by one generated task.
pub struct Output<'d, R: route::Task<'d, A>, A> {
    id: Id<'d>,
    outcome: Outcome<R::Output>,
}

impl<'d, R: route::Task<'d, A>, A> Output<'d, R, A> {
    pub const fn response(id: Id<'d>, response: R::Output) -> Self {
        Self {
            id,
            outcome: Outcome::Response(response),
        }
    }

    pub const fn rejected(id: Id<'d>, reject: Reject) -> Self {
        Self {
            id,
            outcome: Outcome::Rejected(reject),
        }
    }

    pub const fn id(&self) -> Id<'d> {
        self.id
    }

    pub fn into_parts(self) -> (Id<'d>, Outcome<R::Output>) {
        (self.id, self.outcome)
    }

    pub fn emit<S>(self, sink: S) -> Emitted<'d, S>
    where
        S: decode::Encode<'d, 'd>,
    {
        match self.outcome {
            Outcome::Response(response) => {
                let prepared =
                    <<R::Output as dispatch::IntoOutput<'d, 'd>>::Output as dispatch::Complete<
                        'd,
                        'd,
                    >>::complete(
                        <R::Output as dispatch::IntoOutput<'d, 'd>>::into_output(response),
                        sink,
                    )?;
                Ok((prepared, life::Outcome::Completed))
            }
            Outcome::Rejected(reject) => {
                let prepared = dispatch::Immediate::emit(Response::new(reject.status()), sink)?;
                Ok((prepared, life::Outcome::Rejected))
            }
        }
    }
}

/// Homogeneous generated completion retained by a multiplexed protocol.
pub trait Completion<'d>: Sized {
    fn id(&self) -> Id<'d>;

    fn emit<S: decode::Encode<'d, 'd>>(self, sink: S) -> Emitted<'d, S>;
}

impl<'d> Completion<'d> for Infallible {
    fn id(&self) -> Id<'d> {
        match *self {}
    }

    fn emit<S: decode::Encode<'d, 'd>>(self, _: S) -> Emitted<'d, S> {
        match self {}
    }
}

/// Slot-specific construction of one homogeneous retained completion.
pub trait Pack<'d, R: route::Task<'d, A>, A, T> {
    fn pack(output: Output<'d, R, A>) -> T;
}