flex-version 0.4.0

A crate for flexible version numbers, mostly inspired by Ruby's Gem::Version
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

use super::*;

fn parse(input: &str) -> Version {
    input.parse().unwrap()
}

#[test]
fn test_equals() {
    let expected: Version = parse("1.2");

    assert_eq!(parse("1.2.0"), expected);
    assert_eq!(parse("1.2.0.0.0.0"), expected);
    assert_ne!(parse("1.2.0.0.0.1"), expected);
    assert_ne!(parse("1.2.0.0.0.a"), expected);
}

#[test]
fn test_ordering() {
    let versions: Vec<Version> = vec![
        parse("0.9"),
        parse("1.0.a.2"),
        parse("1.0.b1"),
        parse("1.0"),
        parse("1"),
        parse("1.0.0.0"),
        parse("1.0.1"),
    ];

    let mut versions_sorted = versions.clone();
    versions_sorted.reverse();
    versions_sorted.sort();

    assert_eq!(versions, versions_sorted)
}

/// Some versions have the format "7.4.1 (4452929)", so we must be able to parse the
/// trailing parenthesized component.
#[test]
fn test_calculator_version() {
    "7.4.1 (4452929)"
        .parse::<Version>()
        .expect("invalid version");
}

/// Some versions have the format "10.0.014 (Isengard_RC01.phone_dynamic)", so we must be
/// able to parse the trailing parenthesized component.
#[test]
fn test_messaging_version() {
    "10.0.014 (Isengard_RC01.phone_dynamic)"
        .parse::<Version>()
        .expect("invalid version");
}

/// Some vendors sometimes use goofy versions, and we must be able to parse them.
#[test]
fn test_vendor_version() {
    "3.10.6.0004_tacIssue_RIDCrush_Issue_211101_182805"
        .parse::<Version>()
        .expect("invalid version");
}

#[test]
fn test_version_with_timestamp() {
    "3.10.0+20251203173456"
        .parse::<Version>()
        .expect("invalid version");
}

#[test]
fn test_version_with_iso8601_timestamp() {
    let utc = "1.0.0+2025-12-03T17:34:56Z"
        .parse::<Version>()
        .expect("invalid version");
    let tz_minus = "1.0.0+2025-12-03T17:34:56-03:00"
        .parse::<Version>()
        .expect("invalid version");
    let tz_plus = "1.0.0+2025-12-03T17:34:56+03:00"
        .parse::<Version>()
        .expect("invalid version");
    let tz_plus_2 = "1.0.0+2025-12-03T17:34:56+02:00"
        .parse::<Version>()
        .expect("invalid version");
    assert!(utc < tz_minus);
    assert!(utc < tz_plus);
    assert!(tz_minus == tz_plus);
    assert!(tz_minus > tz_plus_2);
    assert!(tz_plus > tz_plus_2);
}