Enum Version 

pub enum Version {
    Semver(Version),
    Numeric(Vec<u64>),
    Opaque(String),
}

parsed version representation for lenient comparison.

covers the three common version formats found in SBOMs:

• Standard semver (possibly with v prefix or fewer than three parts)
• Dot-separated numeric (e.g., date-based 2024.01.15 or four-part 1.2.3.4)
• Opaque strings that cannot be compared

Variants

Semver(Version)

parseable as semver (with lenient parsing: v/V prefix stripped, one- or two-part versions padded to three parts).

Numeric(Vec<u64>)

dot-separated numeric segments that don’t qualify as semver (e.g., four-part versions or versions with leading zeros).

Opaque(String)

non-parseable version string where ordering cannot be determined.

Implementations

impl Version

pub fn parse_lenient(s: &str) -> Self

parses a version string leniently.

tries semver first (stripping v/V prefix and padding one- or two-part versions), then dot-separated numeric, then falls back to Opaque.

Examples

use sbom_model::versions::Version;

assert!(matches!(Version::parse_lenient("1.2.3"), Version::Semver(_)));
assert!(matches!(Version::parse_lenient("v1.2"), Version::Semver(_)));
assert!(matches!(Version::parse_lenient("2024.01.15"), Version::Numeric(_)));
assert!(matches!(Version::parse_lenient("abc"), Version::Opaque(_)));

pub fn is_downgrade(&self, new: &Self) -> bool

returns true if new is a downgrade from self.

comparison strategy depends on the variant pair:

• Semver vs Semver: standard semver ordering (including pre-release)
• Numeric vs Numeric: segment-by-segment with implicit zero padding
• Semver vs Numeric (either direction): extracts [major, minor, patch] from the semver side and compares as numeric segments
• Any Opaque: returns false (ordering unknown)

Examples

use sbom_model::versions::Version;

let old = Version::parse_lenient("2.0.0");
let new = Version::parse_lenient("1.5.0");
assert!(old.is_downgrade(&new));

let old = Version::parse_lenient("1.0.0");
let new = Version::parse_lenient("2.0.0");
assert!(!old.is_downgrade(&new));

Trait Implementations

impl Clone for Version

fn clone(&self) -> Version

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Version

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for Version

impl PartialEq for Version

fn eq(&self, other: &Version) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Version