sark-http 0.26.3

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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

use core::{num::NonZero, ops};

#[derive(Clone, Copy)]
pub(super) struct Authority(Option<Range>);

pub(super) enum Source {
    Absent,
    Retained(Range),
    Staged(Range),
}

pub(super) enum Stage {
    Absent,
    Retained,
    Staged(Range),
}

#[derive(Clone, Copy)]
pub(super) struct Range {
    first: u32,
    second: NonZero<u32>,
}

impl Authority {
    pub(super) const fn absent() -> Self {
        Self(None)
    }

    pub(super) fn retained(range: ops::Range<usize>) -> Option<Self> {
        Some(Self(Some(Range::retained(range)?)))
    }

    pub(super) fn staged(range: ops::Range<usize>) -> Option<Self> {
        Some(Self(Some(Range::staged(range)?)))
    }

    pub(super) fn source(self) -> Source {
        match self.0 {
            None => Source::Absent,
            Some(saved) => match saved.is_staged() {
                true => Source::Staged(saved),
                false => Source::Retained(saved),
            },
        }
    }

    pub(super) fn stage(self) -> Stage {
        match self.0 {
            None => Stage::Absent,
            Some(saved) => match saved.is_staged() {
                true => Stage::Staged(saved),
                false => Stage::Retained,
            },
        }
    }
}

impl Range {
    fn retained(range: ops::Range<usize>) -> Option<Self> {
        if range.start >= range.end || range.end > u32::MAX as usize {
            return None;
        }
        Some(Self {
            first: range.start as u32,
            second: NonZero::<u32>::new(range.end as u32)?,
        })
    }

    fn staged(range: ops::Range<usize>) -> Option<Self> {
        let retained = Self::retained(range)?;
        Some(Self {
            first: retained.second.get(),
            second: NonZero::<u32>::MIN.saturating_add(retained.first),
        })
    }

    pub(super) const fn is_staged(self) -> bool {
        self.first >= self.second.get()
    }

    pub(super) fn range(self) -> ops::Range<usize> {
        let second = self.second.get();
        if self.first < second {
            self.first as usize..second as usize
        } else {
            second as usize - 1..self.first as usize
        }
    }
}

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