pyver 1.0.1

Python PEP-440 Version Parser
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

use serde::{Deserialize, Serialize};

/// # `PEP-440` Pre-Release identifier
/// This identifier is used to mark a Pre-Release version
#[derive(Debug, Serialize, Deserialize, Eq, PartialEq, PartialOrd)]
pub enum PreHeader {
    /// Present in versions like 1.1beta1 or 1.0b1 both are represented the same way
    /// ```
    /// use pyver::ids::PreHeader;
    ///
    /// PreHeader::Beta(Some(1));
    /// ```
    Beta(Option<u32>),
    /// Present in versions like 1.0alpha2 or 1.0a2 both are represented the same way
    /// ```
    /// use pyver::ids::PreHeader;
    ///
    /// PreHeader::Alpha(Some(2));
    /// ```
    Alpha(Option<u32>),
    /// Present in versions like 1.1pre3
    /// ```
    /// use pyver::ids::PreHeader;
    ///
    /// PreHeader::Preview(Some(3));
    /// ```
    Preview(Option<u32>),
    /// Present in versions like 1.1-rc-4 or 1.1c-4
    /// ```
    /// use pyver::ids::PreHeader;
    ///
    /// PreHeader::ReleaseCandidate(Some(4));
    /// ```
    ReleaseCandidate(Option<u32>),
}

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

    #[test]
    fn test_pre_ordering() {
        assert!(PreHeader::ReleaseCandidate(None) > PreHeader::Preview(None));
        assert!(PreHeader::Preview(None) > PreHeader::Alpha(None));
        assert!(PreHeader::Alpha(None) > PreHeader::Beta(None));

        assert!(
            PreHeader::ReleaseCandidate(Some(2)) > PreHeader::ReleaseCandidate(Some(1))
        );
        assert!(PreHeader::Preview(Some(50)) > PreHeader::Preview(Some(3)));
        assert!(PreHeader::Alpha(Some(504)) > PreHeader::Alpha(Some(0)));
        assert!(PreHeader::Beta(Some(1234)) > PreHeader::Beta(Some(1)));

        assert!(PreHeader::ReleaseCandidate(Some(1)) > PreHeader::Beta(Some(45067885)));
    }
}