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

use sark_http::field::{
    Indexing,
    metadata::{block, strings},
};

use crate::hpack::decode;

pub(crate) type Output<S, T> = Result<(S, T), (S, <S as Direct>::Error)>;

pub(crate) enum Begin<R, C> {
    Skip,
    Buffered(R),
    Direct(C),
}

pub(crate) enum Indexed<R> {
    Skip,
    Buffered(R),
}

const _: () =
    assert!(core::mem::size_of::<Indexed<usize>>() <= core::mem::size_of::<Begin<usize, ()>>());

pub(crate) trait Direct {
    type Error: From<decode::Error>;

    fn string(&mut self, cursor: &mut strings::Cursor, input: &[u8]) -> Result<(), Self::Error>;

    fn rollback(&mut self);
}

pub(crate) trait Store: Direct + Sized {
    type Rule: Copy;
    type Completion: Copy;

    fn validate(&mut self, value: block::Validation) -> Result<(), Self::Error>;

    fn begin(
        self,
        name: Option<block::Named<'_>>,
        indexing: Indexing,
    ) -> Output<Self, Begin<Self::Rule, Self::Completion>>;

    fn indexed(self, name: Option<block::Named<'_>>) -> Output<Self, Indexed<Self::Rule>>;

    fn field(
        self,
        rule: Self::Rule,
        value: block::Valued<'_>,
        indexing: Indexing,
        name: block::Named<'_>,
    ) -> Result<Self, (Self, Self::Error)>;

    fn direct(self, done: Self::Completion) -> Result<Self, (Self, Self::Error)>;
}