sark-core 0.21.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

use core::{convert, num::NonZero};

use route::{Push as _, TaskBuild as _};
use sark_http::payload::owned;

use crate::{body, request, route};

/// Protocol-neutral input entering one generated task handler.
#[doc(hidden)]
pub enum Input<'d, R: route::Spec<Request: route::Own>> {
    Buffered(
        request::raw::Parsed<
            request::Retained<'d, <R::Request as route::Schema>::Frame>,
            R::Request,
        >,
    ),
    Ready {
        request: route::Built<'d, <R::Request as route::Own>::Task<'d>>,
    },
}

/// Route-specific bridge into cooperative request construction.
#[doc(hidden)]
#[repr(transparent)]
pub struct Build<'d, R: route::Spec<Request: route::Own>> {
    builder: <R::Request as route::Own>::TaskBuilder<'d>,
}

impl<'d, R: route::Spec<Request: route::Own>> Build<'d, R> {
    pub fn new(builder: <R::Request as route::Own>::TaskBuilder<'d>) -> Self {
        Self { builder }
    }
}

impl<'d, R: route::Spec<Request: route::Own>> crate::body::Build<'d> for Build<'d, R>
where
    <R::Request as route::Own>::TaskBuilder<'d>: route::TaskBuild<'d>,
{
    type Output = route::Built<'d, <R::Request as route::Own>::Task<'d>>;
    type StepError =
        <<R::Request as route::Own>::TaskBuilder<'d> as route::TaskBuild<'d>>::StepError;

    fn finish_input(self, body_len: usize) -> Self {
        Self::new(self.builder.finish_body(body_len))
    }

    fn step(
        self,
        budget: NonZero<usize>,
    ) -> crate::body::Step<Self, Self::Output, Self::StepError> {
        self.builder
            .step(budget)
            .map(Self::new, convert::identity, convert::identity)
    }
}

impl<'d, R: route::Spec<Request: route::Own>> body::Push<'d> for Build<'d, R>
where
    <R::Request as route::Own>::TaskBuilder<'d>: route::Push<'d>,
{
    type Error = <<R::Request as route::Own>::TaskBuilder<'d> as route::Push<'d>>::Error;

    fn observe<C: Copy, S: Copy, O: crate::life::Observer<C, S>>(
        error: &Self::Error,
        observer: &mut O,
    ) {
        <<R::Request as route::Own>::TaskBuilder<'d> as route::Push<'d>>::observe(error, observer);
    }

    fn push(self, segment: owned::Segment<'d>) -> body::Transfer<Self, Self::Error> {
        self.builder.push_body(segment).map(Self::new)
    }
}