vibescript_abi/
version.rs1#[repr(transparent)]
10#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
11pub struct SemVer64(pub u64);
12
13impl SemVer64 {
14 #[inline]
16 pub const fn new(major: u16, minor: u16, patch: u16, abi_flags: u16) -> Self {
17 let m = (major as u64) << 48;
18 let n = (minor as u64) << 32;
19 let p = (patch as u64) << 16;
20 let f = abi_flags as u64;
21 Self(m | n | p | f)
22 }
23
24 #[inline]
26 pub const fn release(major: u16, minor: u16, patch: u16) -> Self {
27 Self::new(major, minor, patch, 0)
28 }
29
30 #[inline]
32 pub const fn major(self) -> u16 {
33 (self.0 >> 48) as u16
34 }
35
36 #[inline]
38 pub const fn minor(self) -> u16 {
39 ((self.0 >> 32) & 0xFFFF) as u16
40 }
41
42 #[inline]
44 pub const fn patch(self) -> u16 {
45 ((self.0 >> 16) & 0xFFFF) as u16
46 }
47
48 #[inline]
50 pub const fn abi_flags(self) -> u16 {
51 (self.0 & 0xFFFF) as u16
52 }
53
54 #[inline]
56 pub const fn is_stable(self) -> bool {
57 self.abi_flags() == 0
58 }
59
60 #[inline]
62 pub const fn release_key(self) -> u64 {
63 self.0 & 0xFFFF_FFFF_FFFF_0000
64 }
65}
66
67#[repr(C)]
69#[derive(Debug, Clone, Copy, PartialEq, Eq)]
70pub enum SemVerReq {
71 AnyStable,
73 Exact(SemVer64),
75 Caret(SemVer64),
80 Tilde(SemVer64),
83 Range {
85 min_inclusive: SemVer64,
86 max_exclusive: SemVer64,
87 },
88}
89
90impl SemVerReq {
91 #[inline]
93 pub const fn matches(&self, candidate: SemVer64) -> bool {
94 match *self {
95 Self::AnyStable => candidate.is_stable(),
96 Self::Exact(req) => candidate.0 == req.0,
97 Self::Caret(req) => {
98 if candidate.abi_flags() != req.abi_flags() {
99 return false;
100 }
101 let c_key = candidate.release_key();
102 let r_key = req.release_key();
103 if c_key < r_key {
104 return false;
105 }
106 if req.major() > 0 {
107 candidate.major() == req.major()
108 } else if req.minor() > 0 {
109 candidate.major() == 0 && candidate.minor() == req.minor()
110 } else {
111 candidate.major() == 0
112 && candidate.minor() == 0
113 && candidate.patch() == req.patch()
114 }
115 }
116 Self::Tilde(req) => {
117 if candidate.abi_flags() != req.abi_flags() {
118 return false;
119 }
120 candidate.major() == req.major()
121 && candidate.minor() == req.minor()
122 && candidate.patch() >= req.patch()
123 }
124 Self::Range {
125 min_inclusive,
126 max_exclusive,
127 } => {
128 if !candidate.is_stable() {
129 return false;
130 }
131 let c_key = candidate.release_key();
132 c_key >= min_inclusive.release_key() && c_key < max_exclusive.release_key()
133 }
134 }
135 }
136}
137
138#[repr(C)]
140#[derive(Debug, Clone, Copy, PartialEq, Eq)]
141pub struct ContractVersionAxes {
142 pub language_version: SemVer64,
144 pub abi_version: SemVer64,
146 pub host_version: SemVer64,
148 pub provider_version: SemVer64,
150 pub ontology_version: SemVer64,
152}
153
154pub const ABI_CRATE_VERSION: SemVer64 = SemVer64::release(0, 0, 41);
159
160impl ContractVersionAxes {
161 #[inline]
163 pub const fn v0_3_default(provider_version: SemVer64, ontology_version: SemVer64) -> Self {
164 Self {
165 language_version: SemVer64::release(0, 1, 0),
166 abi_version: SemVer64::release(0, 3, 0),
167 host_version: SemVer64::release(0, 1, 0),
168 provider_version,
169 ontology_version,
170 }
171 }
172
173 #[inline]
175 pub const fn is_engine_compatible(&self) -> bool {
176 SemVerReq::Caret(SemVer64::release(0, 1, 0)).matches(self.language_version)
177 && SemVerReq::Caret(SemVer64::release(0, 3, 0)).matches(self.abi_version)
178 && SemVerReq::Caret(SemVer64::release(0, 1, 0)).matches(self.host_version)
179 }
180}