ark-api-ffi 0.16.0

Ark low-level Wasm FFI API
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

#[derive(Copy, Clone, Debug, PartialEq, Eq)]
pub struct Semver {
    major: u8,
    minor: u8,
    patch: u8,
    pre: u8,
}

impl Semver {
    pub const fn pack(self) -> u64 {
        (self.major as u64) << 24
            | (self.minor as u64) << 16
            | (self.patch as u64) << 8
            | (self.pre as u64)
    }

    pub const fn unpack(v: u64) -> Self {
        Self {
            major: (v >> 24) as u8,
            minor: (v >> 16) as u8,
            patch: (v >> 8) as u8,
            pre: v as u8,
        }
    }
}

impl std::fmt::Display for Semver {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}.{}.{}", self.major, self.minor, self.patch)?;
        if self.pre > 0 {
            write!(f, "-pre.{}", self.pre)?;
        }
        Ok(())
    }
}

#[allow(unsafe_code)]
#[no_mangle]
#[used]
#[doc(hidden)]
pub static ARK_PACKED_FFI_CRATE_VERSION: u64 = Semver {
    major: 0,
    minor: 16,
    patch: 0,
    pre: 0,
}
.pack();

#[cfg(test)]
mod test {
    use super::*;

    #[test]
    #[allow(clippy::panic)]
    fn crate_version_match() {
        let version = Semver::unpack(ARK_PACKED_FFI_CRATE_VERSION);
        let version_str = version.to_string();

        if version_str != env!("CARGO_PKG_VERSION") {
            panic!("Crate version mismatch, please update ARK_PACKED_FFI_CRATE_VERSION (\"{version_str}\") to be the same as the crate version in `api/api-ffi/Cargo.toml` (\"{}\")", env!("CARGO_PKG_VERSION"));
        }
    }
}