dope-net 0.22.0

Owned network transports for dope
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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

use crate::link::egress::{
    self, Resident,
    load::credit,
    reserve::{demand, error, limit},
};

pub(super) enum Shape {
    First,
    Second,
    Pair(credit::Pair),
}

#[derive(Clone, Copy, Eq, PartialEq)]
#[repr(u32)]
pub(in crate::link::egress) enum Entries {
    Zero,
    One,
    Two,
}

impl Entries {
    pub(in crate::link::egress) const fn into_credit(self) -> egress::Entries {
        egress::Entries::new(self as u32)
    }
}

/// Bounds for at most two ordered final-link entries.
#[derive(Clone, Copy, Debug)]
pub struct Bounds {
    first: limit::Limit,
    second: limit::Limit,
    resident: Resident,
}

impl Bounds {
    pub(in crate::link::egress) const fn proven<const PREFIX: usize>(
        capacity: demand::Capacity<PREFIX>,
    ) -> Self {
        Self {
            first: limit::Limit::bounded::<PREFIX>(Resident::new(PREFIX as u32)),
            second: limit::Limit::open(Resident::new(capacity.body())),
            resident: Resident::new(PREFIX as u32 + capacity.body()),
        }
    }

    pub const fn one(first: limit::Limit) -> Self {
        let resident = first.resident();
        Self {
            first,
            second: limit::Limit::EMPTY,
            resident,
        }
    }

    pub fn pair(first: limit::Limit, second: limit::Limit) -> Result<Self, error::Pair> {
        let resident = first
            .resident()
            .checked_add(second.resident())
            .map_err(error::Pair::new)?;
        Ok(Self {
            first,
            second,
            resident,
        })
    }

    pub(super) const fn first(self) -> limit::Limit {
        self.first
    }

    pub(super) const fn second(self) -> limit::Limit {
        self.second
    }

    pub(super) const fn has_second(self) -> bool {
        self.second.is_active()
    }

    pub(super) const fn shape(self) -> Option<Shape> {
        match (self.first.is_active(), self.second.is_active()) {
            (true, false) => Some(Shape::First),
            (false, true) => Some(Shape::Second),
            (true, true) => Some(Shape::Pair(credit::Pair::new(self.first.resident()))),
            (false, false) => None,
        }
    }

    pub(in crate::link::egress) const fn entries(self) -> Entries {
        match (self.first.is_active(), self.second.is_active()) {
            (false, false) => Entries::Zero,
            (true, false) | (false, true) => Entries::One,
            (true, true) => Entries::Two,
        }
    }

    pub(in crate::link::egress) const fn resident(self) -> Resident {
        self.resident
    }

    pub(in crate::link::egress) const fn amount(self) -> credit::Amount {
        credit::Amount::new(self.entries().into_credit(), self.resident())
    }
}

const _: () = {
    assert!(std::mem::size_of::<Entries>() == std::mem::size_of::<u32>());
    assert!(std::mem::size_of::<Bounds>() == 7 * std::mem::size_of::<u32>());
};