sark-h2 0.22.0

Fiber-free HTTP/2 protocol primitives and manifold server 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
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

use o3::buffer::resident;
use sark_core::{decode, manifold::schedule};
use sark_http::field::metadata::section::rules;

use crate::{
    conn::{
        event,
        machine::{self, ops, view},
    },
    server::sync::{self, Book, Dispatch, Endpoint},
};

/// Direct synchronous connection tied to its router and validated limits.
///
/// The endpoint borrow prevents a connection from outliving that authority.
///
///
/// The retained payload domain cannot be widened after construction.
///
pub struct Conn<'endpoint, 'd: 'endpoint, R: decode::Decode> {
    endpoint: &'endpoint Endpoint<R>,
    machine: machine::Connection<
        crate::ServerRole,
        R::Plan,
        resident::Shared<'d>,
        rules::RejectPush,
        event::Ignore,
    >,
    book: Book<'d, R>,
}

impl<'endpoint, 'd: 'endpoint, R> Conn<'endpoint, 'd, R>
where
    R: decode::Decode,
{
    pub fn ingress(
        &mut self,
    ) -> ops::Ingress<
        '_,
        crate::ServerRole,
        R::Plan,
        resident::Shared<'d>,
        rules::RejectPush,
        event::Ignore,
    > {
        self.machine.ingress()
    }

    pub fn transfer(
        &mut self,
    ) -> ops::Transfer<
        '_,
        crate::ServerRole,
        R::Plan,
        resident::Shared<'d>,
        rules::RejectPush,
        event::Ignore,
    > {
        self.machine.transfer()
    }

    pub fn output(
        &self,
    ) -> view::Output<
        '_,
        crate::ServerRole,
        R::Plan,
        resident::Shared<'d>,
        rules::RejectPush,
        event::Ignore,
    > {
        self.machine.output()
    }

    pub fn status(
        &self,
    ) -> view::Status<
        '_,
        crate::ServerRole,
        R::Plan,
        resident::Shared<'d>,
        rules::RejectPush,
        event::Ignore,
    > {
        self.machine.status()
    }
}

impl<'endpoint, 'd: 'endpoint, R> Conn<'endpoint, 'd, R>
where
    R: Dispatch<'d>,
{
    pub fn try_new(endpoint: &'endpoint Endpoint<R>) -> Result<Self, sync::Create> {
        let config = endpoint.machine();
        let capacity = config.stream_count();
        let machine = machine::Connection::from_seed(config, endpoint.seed())
            .map_err(sync::Create::Connection)?;
        Ok(Self {
            endpoint,
            machine,
            book: Book::try_new(capacity).map_err(sync::Create::Book)?,
        })
    }

    pub fn drain_events(&mut self) {
        self.endpoint
            .router()
            .events(&mut self.book, &mut self.machine, self.endpoint.limits())
    }

    pub fn pump(&mut self) -> schedule::Report {
        self.endpoint.router().pump::<false, _>(
            &mut self.book,
            &mut self.machine,
            self.endpoint.limits(),
            schedule::Egress::Released,
            || Some(()),
        )
    }

    pub fn close(&mut self) {
        self.endpoint
            .router()
            .clear(&mut self.book, &mut self.machine);
    }
}