Skip to main content

frm/
version.rs

1// Copyright (c) 2025-2026 Michael S. Klishin and Contributors
2//
3// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
4// https://www.apache.org/licenses/LICENSE-2.0> or the MIT license
5// <LICENSE-MIT or https://opensource.org/licenses/MIT>, at your
6// option. This file may not be copied, modified, or distributed
7// except according to those terms.
8
9use std::cmp::Ordering;
10use std::fmt;
11use std::str::FromStr;
12
13use serde::{Deserialize, Serialize};
14
15use crate::errors::Error;
16
17#[derive(Debug, Clone, PartialEq, Eq, Hash, Serialize, Deserialize)]
18pub enum Prerelease {
19    Alpha(String),
20    Beta(String),
21    Rc(String),
22}
23
24impl Prerelease {
25    pub fn is_alpha(&self) -> bool {
26        matches!(self, Prerelease::Alpha(_))
27    }
28}
29
30impl fmt::Display for Prerelease {
31    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
32        match self {
33            Prerelease::Alpha(s) => write!(f, "alpha.{}", s),
34            Prerelease::Beta(s) => write!(f, "beta.{}", s),
35            Prerelease::Rc(s) => write!(f, "rc.{}", s),
36        }
37    }
38}
39
40fn compare_prerelease_identifiers(a: &str, b: &str) -> Ordering {
41    match (a.parse::<u32>(), b.parse::<u32>()) {
42        (Ok(na), Ok(nb)) => na.cmp(&nb),
43        _ => a.cmp(b),
44    }
45}
46
47impl Ord for Prerelease {
48    fn cmp(&self, other: &Self) -> Ordering {
49        match (self, other) {
50            (Prerelease::Alpha(a), Prerelease::Alpha(b)) => compare_prerelease_identifiers(a, b),
51            (Prerelease::Alpha(_), _) => Ordering::Less,
52            (_, Prerelease::Alpha(_)) => Ordering::Greater,
53            (Prerelease::Beta(a), Prerelease::Beta(b)) => compare_prerelease_identifiers(a, b),
54            (Prerelease::Beta(_), Prerelease::Rc(_)) => Ordering::Less,
55            (Prerelease::Rc(_), Prerelease::Beta(_)) => Ordering::Greater,
56            (Prerelease::Rc(a), Prerelease::Rc(b)) => compare_prerelease_identifiers(a, b),
57        }
58    }
59}
60
61impl PartialOrd for Prerelease {
62    fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
63        Some(self.cmp(other))
64    }
65}
66
67#[derive(Debug, Clone, PartialEq, Eq, Hash, Serialize, Deserialize)]
68pub struct Version {
69    pub major: u32,
70    pub minor: u32,
71    pub patch: u32,
72    #[serde(skip_serializing_if = "Option::is_none")]
73    pub prerelease: Option<Prerelease>,
74}
75
76impl Version {
77    pub fn new(major: u32, minor: u32, patch: u32) -> Self {
78        Self {
79            major,
80            minor,
81            patch,
82            prerelease: None,
83        }
84    }
85
86    pub fn with_prerelease(major: u32, minor: u32, patch: u32, prerelease: Prerelease) -> Self {
87        Self {
88            major,
89            minor,
90            patch,
91            prerelease: Some(prerelease),
92        }
93    }
94
95    pub fn dir_name(&self) -> String {
96        self.to_string()
97    }
98
99    pub fn is_distributed_via_server_packages_repository(&self) -> bool {
100        self.prerelease.as_ref().is_some_and(|p| p.is_alpha())
101    }
102
103    pub fn download_url(&self) -> String {
104        format!(
105            "https://github.com/rabbitmq/rabbitmq-server/releases/download/v{v}/rabbitmq-server-generic-unix-{v}.tar.xz",
106            v = self
107        )
108    }
109
110    pub fn download_url_with_tag(&self, tag: &str) -> String {
111        format!(
112            "https://github.com/rabbitmq/server-packages/releases/download/{tag}/rabbitmq-server-generic-unix-{v}.tar.xz",
113            tag = tag,
114            v = self
115        )
116    }
117
118    pub fn archive_name(&self) -> String {
119        format!("rabbitmq-server-generic-unix-{}.tar.xz", self)
120    }
121
122    pub fn extracted_dir_name(&self) -> String {
123        format!("rabbitmq_server-{}", self)
124    }
125}
126
127impl fmt::Display for Version {
128    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
129        write!(f, "{}.{}.{}", self.major, self.minor, self.patch)?;
130        if let Some(ref pre) = self.prerelease {
131            write!(f, "-{}", pre)?;
132        }
133        Ok(())
134    }
135}
136
137impl FromStr for Version {
138    type Err = Error;
139
140    fn from_str(s: &str) -> Result<Self, Self::Err> {
141        let s = s.trim().trim_start_matches('v');
142
143        let (version_part, prerelease) = if let Some(idx) = s.find('-') {
144            let (ver, pre) = s.split_at(idx);
145            let pre = &pre[1..];
146            (ver, Some(parse_prerelease(pre, s)?))
147        } else {
148            (s, None)
149        };
150
151        let parts: Vec<&str> = version_part.split('.').collect();
152
153        if parts.len() != 3 {
154            return Err(Error::InvalidVersion(s.to_string()));
155        }
156
157        let major = parts[0]
158            .parse()
159            .map_err(|_| Error::InvalidVersion(s.to_string()))?;
160        let minor = parts[1]
161            .parse()
162            .map_err(|_| Error::InvalidVersion(s.to_string()))?;
163        let patch = parts[2]
164            .parse()
165            .map_err(|_| Error::InvalidVersion(s.to_string()))?;
166
167        Ok(Version {
168            major,
169            minor,
170            patch,
171            prerelease,
172        })
173    }
174}
175
176fn parse_prerelease(s: &str, full: &str) -> Result<Prerelease, Error> {
177    let parts: Vec<&str> = s.split('.').collect();
178    if parts.len() != 2 {
179        return Err(Error::InvalidVersion(full.to_string()));
180    }
181
182    let identifier = parts[1];
183    if identifier.is_empty() {
184        return Err(Error::InvalidVersion(full.to_string()));
185    }
186
187    match parts[0].to_lowercase().as_str() {
188        "alpha" => Ok(Prerelease::Alpha(identifier.to_string())),
189        "beta" => Ok(Prerelease::Beta(identifier.to_string())),
190        "rc" => Ok(Prerelease::Rc(identifier.to_string())),
191        _ => Err(Error::InvalidVersion(full.to_string())),
192    }
193}
194
195impl Ord for Version {
196    fn cmp(&self, other: &Self) -> Ordering {
197        let base =
198            (self.major, self.minor, self.patch).cmp(&(other.major, other.minor, other.patch));
199        if base != Ordering::Equal {
200            return base;
201        }
202
203        match (&self.prerelease, &other.prerelease) {
204            (None, None) => Ordering::Equal,
205            (Some(_), None) => Ordering::Less,
206            (None, Some(_)) => Ordering::Greater,
207            (Some(a), Some(b)) => a.cmp(b),
208        }
209    }
210}
211
212impl PartialOrd for Version {
213    fn partial_cmp(&self, other: &Self) -> Option<Ordering> {
214        Some(self.cmp(other))
215    }
216}