sark-core 0.29.1

Fiber-free request, route, dispatch, and lifecycle core for Sark
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

mod advance;
mod bound;
mod error;
mod plan;
mod start;
mod track;

pub(in crate::body) use advance::Advance;
use bound::{Bound, Kind};
pub use error::Error;
pub use plan::Plan;
pub use start::Start;
pub use track::Track;

/// Whether framing must retain request payload bytes.
#[derive(Clone, Copy, PartialEq, Eq, Debug)]
pub enum Retention {
    Retained,
    Discarded,
}

/// Whether a request builder may consume body segments before transport FIN.
#[derive(Clone, Copy, PartialEq, Eq, Debug)]
pub enum Stream {
    Streaming,
    Buffered,
}

const _: () = assert!(core::mem::size_of::<Stream>() == 1);

/// Whether the complete logical body length was present in the request head.
#[derive(Clone, Copy, PartialEq, Eq)]
pub enum Length {
    Known(usize),
    Unknown,
}

impl Length {
    pub const fn from_option(value: Option<usize>) -> Self {
        match value {
            Some(value) => Self::Known(value),
            None => Self::Unknown,
        }
    }
}

const _: () = assert!(core::mem::size_of::<Length>() == 2 * core::mem::size_of::<usize>());

/// Input may still advance the admitted logical length.
#[derive(Debug)]
pub struct Open;

/// Input ended and its logical length satisfies the admitted bound.
#[derive(Debug)]
pub struct Finished;