sark-http 0.21.0

HTTP wire types, semantics, codecs, and ownership invariants 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

//! HTTP/1 head syntax, framing, and admission.

use core::mem;

use crate::{
    h1::{
        field::{self, syntax},
        framing, switch, target,
    },
    payload::response::status,
    request::span,
};

mod limit;
pub mod line;
pub mod request;
pub mod response;
mod state;
mod tail;

pub use limit::Limit;

#[derive(Clone, Copy, PartialEq, Eq, Debug)]
pub enum Boundary {
    Invalid,
    TooLarge { actual: usize, limit: usize },
    Span(span::Error),
}

#[derive(Clone, Copy, PartialEq, Eq, Debug)]
pub enum Semantic {
    Status(status::Error),
    Field(field::Error),
    Host(target::HostError),
    Routing(target::Invalid),
    Authority(target::Error),
    Connection(field::TokenError),
    Upgrade(switch::UpgradeError),
    Admission(framing::RequestError),
    Transition(switch::Error),
    Framing(framing::Error),
}

const _: () = {
    assert!(mem::size_of::<Boundary>() == 4 * mem::size_of::<usize>());
    assert!(mem::size_of::<Option<Boundary>>() == mem::size_of::<Boundary>());
    assert!(!mem::needs_drop::<Boundary>());
    assert!(mem::size_of::<Semantic>() == 6 * mem::size_of::<usize>());
    assert!(mem::size_of::<Option<Semantic>>() == mem::size_of::<Semantic>());
    assert!(!mem::needs_drop::<Semantic>());
};

#[derive(Clone, Copy, PartialEq, Eq, Debug)]
pub enum ParseError<E> {
    Boundary(Boundary),
    Field(syntax::Error),
    Semantic(Semantic),
    Sink(E),
}

impl<E> ParseError<E> {
    pub const fn invalid() -> Self {
        Self::Boundary(Boundary::Invalid)
    }

    pub const fn too_large(actual: usize, limit: usize) -> Self {
        Self::Boundary(Boundary::TooLarge { actual, limit })
    }
}