upstream_rs/models/common/

version.rs

use std::fmt;

use anyhow::{Result, bail};
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub struct Version {
    pub major: u32,
    pub minor: u32,
    pub patch: u32,
    pub is_prerelease: bool,
}

impl Version {
    pub fn new(major: u32, minor: u32, patch: u32, is_prerelease: bool) -> Self {
        Self {
            major,
            minor,
            patch,
            is_prerelease,
        }
    }

    pub fn is_newer_than(&self, other: &Version) -> bool {
        if self.major != other.major {
            return self.major > other.major;
        }
        if self.minor != other.minor {
            return self.minor > other.minor;
        }
        if self.patch != other.patch {
            return self.patch > other.patch;
        }
        if self.is_prerelease != other.is_prerelease {
            return !self.is_prerelease;
        }

        false
    }

    pub fn is_unknown(&self) -> bool {
        self.major == 0 && self.minor == 0 && self.patch == 0 && !self.is_prerelease
    }

    pub fn parse(s: &str) -> Result<Self> {
        if s.trim().is_empty() {
            bail!("Cannot parse empty version",);
        }

        let parts: Vec<&str> = s.split('.').collect();

        if parts.is_empty() || parts.len() > 3 {
            bail!("Invalid version format",);
        }

        let Ok(major) = parts[0].parse::<u32>() else {
            bail!("Invalid major");
        };

        let minor = if parts.len() > 1 {
            let Ok(value) = parts[1].parse::<u32>() else {
                bail!("Invalid minor");
            };
            value
        } else {
            0
        };

        let patch = if parts.len() > 2 {
            let Ok(value) = parts[2].parse::<u32>() else {
                bail!("Invalid patch");
            };
            value
        } else {
            0
        };

        Ok(Version::new(major, minor, patch, false))
    }

    pub fn from_filename(s: &str) -> Result<Self> {
        let trimmed = s.trim();
        if trimmed.is_empty() {
            bail!("Cannot parse empty version");
        }

        if let Some(candidate) = Self::find_triplet(trimmed) {
            return Self::parse(&candidate);
        }

        Self::parse(trimmed)
    }

    pub fn from_tag(tag: &str) -> Result<Self> {
        let tag = tag.trim();
        let tag = tag
            .strip_prefix('v')
            .or_else(|| tag.strip_prefix('V'))
            .unwrap_or(tag);

        const PREFIXES: &[&str] = &["release-", "rel-", "ver-", "version-"];
        let lowered = tag.to_lowercase();
        let cleaned = PREFIXES
            .iter()
            .find_map(|prefix| lowered.strip_prefix(prefix).map(|_| &tag[prefix.len()..]))
            .unwrap_or(tag);

        Self::from_filename(cleaned).or_else(|_| Self::parse(cleaned))
    }

    fn find_triplet(s: &str) -> Option<String> {
        let bytes = s.as_bytes();
        let len = bytes.len();

        let mut i = 0;
        while i < len {
            if !bytes[i].is_ascii_digit() {
                i += 1;
                continue;
            }

            let major_start = i;
            while i < len && bytes[i].is_ascii_digit() {
                i += 1;
            }
            if i >= len || bytes[i] != b'.' {
                continue;
            }

            i += 1;
            let minor_start = i;
            while i < len && bytes[i].is_ascii_digit() {
                i += 1;
            }
            if minor_start == i || i >= len || bytes[i] != b'.' {
                continue;
            }

            i += 1;
            let patch_start = i;
            while i < len && bytes[i].is_ascii_digit() {
                i += 1;
            }
            if patch_start == i {
                continue;
            }

            return Some(s[major_start..i].to_string());
        }

        None
    }
}

impl fmt::Display for Version {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        if self.is_prerelease {
            write!(f, "{}.{}.{}-pre", self.major, self.minor, self.patch)
        } else {
            write!(f, "{}.{}.{}", self.major, self.minor, self.patch)
        }
    }
}

// Implement PartialOrd and Ord for proper comparison
impl PartialOrd for Version {
    fn partial_cmp(&self, other: &Self) -> Option<std::cmp::Ordering> {
        Some(std::cmp::Ord::cmp(self, other))
    }
}

impl Ord for Version {
    fn cmp(&self, other: &Self) -> std::cmp::Ordering {
        match self.major.cmp(&other.major) {
            std::cmp::Ordering::Equal => {}
            ord => return ord,
        }
        match self.minor.cmp(&other.minor) {
            std::cmp::Ordering::Equal => {}
            ord => return ord,
        }
        match self.patch.cmp(&other.patch) {
            std::cmp::Ordering::Equal => {}
            ord => return ord,
        }

        // Stable releases are "greater than" prereleases for the same version.
        match (self.is_prerelease, other.is_prerelease) {
            (false, true) => std::cmp::Ordering::Greater,
            (true, false) => std::cmp::Ordering::Less,
            _ => std::cmp::Ordering::Equal,
        }
    }
}

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

    #[test]
    fn parse_supports_short_and_full_versions() {
        assert_eq!(
            Version::parse("1").expect("parse 1"),
            Version::new(1, 0, 0, false)
        );
        assert_eq!(
            Version::parse("1.2").expect("parse 1.2"),
            Version::new(1, 2, 0, false)
        );
        assert_eq!(
            Version::parse("1.2.3").expect("parse 1.2.3"),
            Version::new(1, 2, 3, false)
        );
    }

    #[test]
    fn parse_rejects_invalid_versions() {
        assert!(Version::parse("").is_err());
        assert!(Version::parse("1.2.3.4").is_err());
        assert!(Version::parse("v1.2.3").is_err());
        assert!(Version::parse("1.a.3").is_err());
    }

    #[test]
    fn from_filename_extracts_triplet_when_present() {
        let parsed = Version::from_filename("tool-v2.15.9-linux-x86_64.tar.gz")
            .expect("version extracted from filename");
        assert_eq!(parsed, Version::new(2, 15, 9, false));
    }

    #[test]
    fn from_tag_handles_common_prefixes() {
        assert_eq!(
            Version::from_tag("v1.2.3").expect("v-prefixed tag"),
            Version::new(1, 2, 3, false)
        );
        assert_eq!(
            Version::from_tag("release-7.8.9").expect("release-prefixed tag"),
            Version::new(7, 8, 9, false)
        );
        assert_eq!(
            Version::from_tag("VERSION-10.11.12").expect("case-insensitive prefix"),
            Version::new(10, 11, 12, false)
        );
    }

    #[test]
    fn comparison_prefers_stable_over_prerelease_for_same_numbers() {
        let stable = Version::new(1, 0, 0, false);
        let prerelease = Version::new(1, 0, 0, true);

        assert!(stable > prerelease);
        assert!(stable.is_newer_than(&prerelease));
        assert!(!prerelease.is_newer_than(&stable));
    }
}