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 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146
use std::fmt; /// Release date including year, month, and day. #[derive(Debug, PartialEq, Eq, Copy, Clone, PartialOrd, Ord)] pub struct Date(u32); impl Date { /// Reads the release date of the running compiler. If it cannot be /// determined (see the [top-level documentation](crate)), returns `None`. /// /// # Example /// /// ```rust /// use version_check::Date; /// /// match Date::read() { /// Some(d) => format!("The release date is: {}", d), /// None => format!("Failed to read the release date.") /// }; /// ``` pub fn read() -> Option<Date> { ::get_version_and_date() .and_then(|(_, date)| date) .and_then(|date| Date::parse(&date)) } /// Return the original (YYYY, MM, DD). fn to_ymd(&self) -> (u8, u8, u8) { let y = self.0 >> 9; let m = (self.0 << 23) >> 28; let d = (self.0 << 27) >> 27; (y as u8, m as u8, d as u8) } /// Parse a release date of the form `%Y-%m-%d`. Returns `None` if `date` is /// not in `%Y-%m-%d` format. /// /// # Example /// /// ```rust /// use version_check::Date; /// /// let date = Date::parse("2016-04-20").unwrap(); /// /// assert!(date.at_least("2016-01-10")); /// assert!(date.at_most("2016-04-20")); /// assert!(date.exactly("2016-04-20")); /// /// assert!(Date::parse("March 13, 2018").is_none()); /// assert!(Date::parse("1-2-3-4-5").is_none()); /// ``` pub fn parse(date: &str) -> Option<Date> { let ymd: Vec<u32> = date.split("-") .filter_map(|s| s.parse::<u32>().ok()) .collect(); if ymd.len() != 3 { return None } let (y, m, d) = (ymd[0], ymd[1], ymd[2]); Some(Date((y << 9) | (m << 5) | d)) } /// Returns `true` if `self` occurs on or after `date`. /// /// If `date` occurs before `self`, or if `date` is not in `%Y-%m-%d` /// format, returns `false`. /// /// # Example /// /// ```rust /// use version_check::Date; /// /// let date = Date::parse("2020-01-01").unwrap(); /// /// assert!(date.at_least("2019-12-31")); /// assert!(date.at_least("2020-01-01")); /// assert!(date.at_least("2014-04-31")); /// /// assert!(!date.at_least("2020-01-02")); /// assert!(!date.at_least("2024-08-18")); /// ``` pub fn at_least(&self, date: &str) -> bool { Date::parse(date) .map(|date| self >= &date) .unwrap_or(false) } /// Returns `true` if `self` occurs on or before `date`. /// /// If `date` occurs after `self`, or if `date` is not in `%Y-%m-%d` /// format, returns `false`. /// /// # Example /// /// ```rust /// use version_check::Date; /// /// let date = Date::parse("2020-01-01").unwrap(); /// /// assert!(date.at_most("2020-01-01")); /// assert!(date.at_most("2020-01-02")); /// assert!(date.at_most("2024-08-18")); /// /// assert!(!date.at_most("2019-12-31")); /// assert!(!date.at_most("2014-04-31")); /// ``` pub fn at_most(&self, date: &str) -> bool { Date::parse(date) .map(|date| self <= &date) .unwrap_or(false) } /// Returns `true` if `self` occurs exactly on `date`. /// /// If `date` is not exactly `self`, or if `date` is not in `%Y-%m-%d` /// format, returns `false`. /// /// # Example /// /// ```rust /// use version_check::Date; /// /// let date = Date::parse("2020-01-01").unwrap(); /// /// assert!(date.exactly("2020-01-01")); /// /// assert!(!date.exactly("2019-12-31")); /// assert!(!date.exactly("2014-04-31")); /// assert!(!date.exactly("2020-01-02")); /// assert!(!date.exactly("2024-08-18")); /// ``` pub fn exactly(&self, date: &str) -> bool { Date::parse(date) .map(|date| self == &date) .unwrap_or(false) } } impl fmt::Display for Date { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { let (y, m, d) = self.to_ymd(); write!(f, "{}-{}-{}", y, m, d) } }