release_version/
build_version.rs1use std::cmp::Ordering;
4use std::fmt;
5
6use semver::Version;
7
8use crate::upgrade_decision::UpgradeDecision;
9
10#[derive(Debug, Clone)]
17pub struct BuildVersion {
18 semver: Version,
19 build_number: u64,
20 dev_build: bool,
21}
22
23impl BuildVersion {
24 #[must_use]
26 pub fn new(semver: Version, build_number: u64, dev_build: bool) -> Self {
27 Self {
28 semver,
29 build_number,
30 dev_build,
31 }
32 }
33
34 pub fn from_manifest(binary_version: &str, build_number: u64) -> Result<Self, semver::Error> {
42 Ok(Self {
43 semver: Version::parse(binary_version)?,
44 build_number,
45 dev_build: false,
46 })
47 }
48
49 #[must_use]
51 pub fn semver(&self) -> &Version {
52 &self.semver
53 }
54
55 #[must_use]
57 pub fn build_number(&self) -> u64 {
58 self.build_number
59 }
60
61 #[must_use]
63 pub fn is_dev_build(&self) -> bool {
64 self.dev_build
65 }
66
67 #[must_use]
73 pub fn compare_for_upgrade(&self, available: &Self, allow_override: bool) -> UpgradeDecision {
74 match self.semver.cmp(&available.semver) {
75 Ordering::Less => return UpgradeDecision::Upgrade,
76 Ordering::Greater => {
77 return if allow_override {
78 UpgradeDecision::Upgrade
79 } else {
80 UpgradeDecision::Downgrade
81 };
82 }
83 Ordering::Equal => {}
84 }
85
86 if self.dev_build || available.dev_build {
88 return if allow_override {
89 UpgradeDecision::Upgrade
90 } else {
91 UpgradeDecision::DevBuild
92 };
93 }
94
95 match self.build_number.cmp(&available.build_number) {
97 Ordering::Less => UpgradeDecision::Upgrade,
98 Ordering::Equal => UpgradeDecision::UpToDate,
99 Ordering::Greater => {
100 if allow_override {
101 UpgradeDecision::Upgrade
102 } else {
103 UpgradeDecision::Downgrade
104 }
105 }
106 }
107 }
108}
109
110impl fmt::Display for BuildVersion {
111 fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
112 write!(f, "{}.{}", self.semver, self.build_number)
113 }
114}
115
116impl Default for BuildVersion {
117 fn default() -> Self {
120 Self {
121 semver: Version::new(0, 0, 0),
122 build_number: 0,
123 dev_build: true,
124 }
125 }
126}
127
128#[cfg(test)]
129mod tests {
130 use super::*;
131
132 #[test]
133 fn display_format() {
134 let v = BuildVersion::new(Version::new(0, 11, 0), 207, false);
135 assert_eq!(v.to_string(), "0.11.0.207");
136 }
137
138 #[test]
139 fn from_manifest_valid() {
140 let v = BuildVersion::from_manifest("0.11.0", 207).expect("valid semver");
141 assert_eq!(v.semver(), &Version::new(0, 11, 0));
142 assert_eq!(v.build_number(), 207);
143 assert!(!v.is_dev_build());
144 }
145
146 #[test]
147 fn from_manifest_invalid_semver() {
148 assert!(BuildVersion::from_manifest("not.valid", 1).is_err());
149 }
150}