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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72

use o3::buffer::hold;
use sark_core::life::session;

use crate::{
    conn::{event, outputs, outputs::payloads},
    flow, stream,
};

pub(crate) struct Retained<'a, C: session::Storage> {
    outbound: &'a mut outputs::Outbound<C>,
}

impl<'a, C: session::Storage> Retained<'a, C> {
    pub(super) fn new(outbound: &'a mut outputs::Outbound<C>) -> Self {
        Self { outbound }
    }
    pub(crate) fn clear(&mut self, mut release: impl FnMut(event::Staging)) {
        self.outbound.payloads.clear(|payload| match payload {
            payloads::Shared::Wire(_) => {}
            payloads::Shared::Data(data) => {
                let body_len = data.body.as_ref().map_or(0, |body| body.as_ref().len());
                let resident = data.body.as_ref().map_or(0, |body| body.resident());
                drop(data.body);
                release(event::Staging {
                    charge: hold::Charge::from_owner(body_len, resident),
                    credit: data.credit,
                });
            }
        });
    }

    /// Drains a subset of the ledger's admitted byte totals and bounded record count.
    pub(crate) fn discard(
        &mut self,
        id: stream::Id,
        mut cancel: impl FnMut(flow::Reserved),
    ) -> Option<event::Retirement> {
        let mut retired: Option<event::Retirement> = None;
        self.drain(id, |data| {
            let body_len = data.body.as_ref().map_or(0, |body| body.as_ref().len());
            let resident = data.body.as_ref().map_or(0, |body| body.resident());
            let released = hold::Charge::from_owner(body_len, resident);
            let charge = match &retired {
                Some(event::Retirement { charge: total, .. }) => hold::Charge::from_commit(
                    total.logical_bytes.wrapping_add(released.logical_bytes),
                    total.resident_bytes.wrapping_add(released.resident_bytes),
                    total.owners.wrapping_add(released.owners),
                ),
                None => released,
            };
            retired = Some(event::Retirement {
                stream_id: data.credit.stream(),
                charge,
            });
            cancel(data.credit);
        });
        retired
    }

    pub(crate) fn cancel(&mut self, id: stream::Id, mut cancel: impl FnMut(flow::Reserved)) {
        self.drain(id, |data| cancel(data.credit))
    }

    fn drain(&mut self, id: stream::Id, mut release: impl FnMut(payloads::Data<Option<C>>)) {
        self.outbound.payloads.drain(id, |payload| {
            let payloads::Shared::Data(data) = payload else {
                return;
            };
            release(data);
        });
    }
}