qualia_client_core/
qapp_version.rs1use std::cmp::Ordering;
7
8#[derive(Debug, Clone, PartialEq, Eq)]
10pub struct ParsedVersion {
11 pub major: u32,
12 pub minor: u32,
13 pub patch: u32,
14 pub pre_release: Option<String>,
16}
17
18pub fn normalize_version_label(raw: &str) -> String {
20 let trimmed = raw.trim().trim_start_matches('v').trim();
21 let core = trimmed.split('+').next().unwrap_or(trimmed);
22 core.to_string()
23}
24
25pub fn parse_version(raw: &str) -> Option<ParsedVersion> {
27 let label = normalize_version_label(raw);
28 if label.is_empty() {
29 return None;
30 }
31
32 let (numeric, pre) = match label.split_once('-') {
33 Some((n, p)) if !p.is_empty() => (n, Some(p.to_string())),
34 _ => (label.as_str(), None),
35 };
36
37 let mut parts = numeric.split('.');
38 let major = parts.next()?.parse().ok()?;
39 let minor = parts.next().unwrap_or("0").parse().ok()?;
40 let patch = parts.next().unwrap_or("0").parse().ok()?;
41
42 Some(ParsedVersion {
43 major,
44 minor,
45 patch,
46 pre_release: pre,
47 })
48}
49
50pub fn compare_parsed(a: &ParsedVersion, b: &ParsedVersion) -> Ordering {
52 (a.major, a.minor, a.patch)
53 .cmp(&(b.major, b.minor, b.patch))
54 .then_with(|| compare_pre_release(&a.pre_release, &b.pre_release))
55}
56
57fn compare_pre_release(a: &Option<String>, b: &Option<String>) -> Ordering {
58 match (a, b) {
59 (None, None) => Ordering::Equal,
60 (None, Some(_)) => Ordering::Greater,
61 (Some(_), None) => Ordering::Less,
62 (Some(a), Some(b)) => a.cmp(b),
63 }
64}
65
66pub fn compare_versions(a: &str, b: &str) -> Option<Ordering> {
68 let pa = parse_version(a)?;
69 let pb = parse_version(b)?;
70 Some(compare_parsed(&pa, &pb))
71}
72
73pub fn is_version_newer(candidate: &str, installed: &str) -> bool {
75 matches!(
76 compare_versions(candidate, installed),
77 Some(Ordering::Greater)
78 )
79}
80
81#[cfg(test)]
82mod tests {
83 use super::*;
84
85 #[test]
86 fn stable_beats_prerelease_at_same_numbers() {
87 assert!(is_version_newer("0.0.12", "0.0.12-dev"));
88 assert!(!is_version_newer("0.0.12-dev", "0.0.12"));
89 }
90
91 #[test]
92 fn patch_bump_is_newer() {
93 assert!(is_version_newer("0.0.13", "0.0.12"));
94 assert!(!is_version_newer("0.0.12", "0.0.13"));
95 }
96
97 #[test]
98 fn v_prefix_and_whitespace() {
99 use std::cmp::Ordering;
100
101 assert!(parse_version(" v0.0.12 ").is_some());
102 assert!(!is_version_newer("v0.0.12", "0.0.12"));
103 assert_eq!(compare_versions("v0.0.12", "0.0.12"), Some(Ordering::Equal));
104 }
105
106 #[test]
107 fn equal_versions_not_newer() {
108 assert!(!is_version_newer("0.0.12", "0.0.12"));
109 assert!(!is_version_newer("0.0.12-dev", "0.0.12-dev"));
110 }
111}