sark-h2 0.24.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

use o3::buffer::storage;
use sark_core::{
    life::session,
    manifold::server::{self, drain},
};
use sark_http::field::metadata::section::{rules, state::Selected};

use crate::{
    conn,
    conn::{event, machine},
};

/// A server event that remains resident in its owning connection queue.
#[must_use]
#[repr(transparent)]
pub struct Ready<'a, F, C, E>(event::Ready<'a, event::Event<Selected<F>, F::Block, C, E>>)
where
    F: rules::Policy,
    C: session::Storage,
    E: event::Evidence;

impl<'a, F, C, E> Ready<'a, F, C, E>
where
    F: rules::Policy,
    C: session::Storage,
    E: event::Evidence,
{
    pub(super) const fn new(
        ready: event::Ready<'a, event::Event<Selected<F>, F::Block, C, E>>,
    ) -> Self {
        Self(ready)
    }

    pub(crate) fn data_stream(&self) -> Option<crate::stream::Key> {
        match self.0.as_ref() {
            event::Event::Data { stream_id, .. } => Some(*stream_id),
            _ => None,
        }
    }

    pub(crate) fn rejection(&self) -> Option<&event::Rejected> {
        match self.0.as_ref() {
            event::Event::StreamReset {
                validation: check, ..
            } => check.as_ref(),
            _ => None,
        }
    }
}

impl<F, C, E> drain::Ready for Ready<'_, F, C, E>
where
    F: rules::Policy,
    C: session::Storage,
    E: event::Evidence,
{
    type Item = server::Event<machine::Connection<crate::ServerRole, F, C, rules::RejectPush, E>>;

    fn take(self) -> Self::Item {
        match drain::Ready::take(self.0) {
            event::Event::Headers {
                stream_id: id,
                head,
                boundary,
                section,
            } => server::Event::Head {
                message: conn::Message::new(id, boundary),
                head,
                section,
            },
            event::Event::Data {
                stream_id: id,
                data,
                boundary,
            } => server::Event::Data {
                message: conn::Message::new(id, boundary),
                data,
            },
            event::Event::StreamReset {
                stream_id: id,
                error,
                retired,
                ..
            } => server::Event::Reset {
                stream: id,
                reason: error.reason(),
                retired,
            },
            event::Event::EgressRetired { write } => server::Event::Retired(write),
            event::Event::PrefaceComplete => server::Event::Established,
            _ => server::Event::Control,
        }
    }
}

const _: () = assert!(
    core::mem::size_of::<Ready<'static, rules::RetainRaw, storage::Shared, event::Retirement>>()
        == core::mem::size_of::<usize>()
);