link-cli 0.2.6

A CLI tool and reusable library for links manipulation backed by a LiNo-notation doublet storage engine.
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

//! `Platform.Data.Hybrid<uint>`-compatible reference encoding.

const EXTERNAL_ZERO: u32 = (u32::MAX / 2) + 1;

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct HybridReference {
    encoded: u32,
}

impl HybridReference {
    pub fn external(value: u32) -> Self {
        Self {
            encoded: if value == 0 {
                EXTERNAL_ZERO
            } else {
                0u32.wrapping_sub(value)
            },
        }
    }

    pub fn from_encoded(encoded: u32) -> Self {
        Self { encoded }
    }

    pub fn encoded(self) -> u32 {
        self.encoded
    }

    pub fn absolute_value(self) -> Option<u32> {
        if self.encoded == EXTERNAL_ZERO {
            Some(0)
        } else if self.encoded >= EXTERNAL_ZERO {
            Some(0u32.wrapping_sub(self.encoded))
        } else {
            None
        }
    }

    pub fn is_external(self) -> bool {
        self.absolute_value().is_some()
    }
}

/// Encodes an external reference the same way `Platform.Data.Hybrid<uint>` does.
pub fn external_reference(value: u32) -> u32 {
    HybridReference::external(value).encoded()
}

/// Decodes a `Platform.Data.Hybrid<uint>` external reference.
pub fn external_reference_value(value: u32) -> Option<u32> {
    HybridReference::from_encoded(value).absolute_value()
}