|
| 1 | +//! Configuration values with the value domain of Python's `tomllib` and PyYAML `safe_load`. |
| 2 | +
|
| 3 | +use crate::constants::{ |
| 4 | + FEBRUARY, MAX_HOUR, MAX_MICROSECOND, MAX_MINUTE, MAX_SECOND, MAX_YEAR, MIN_YEAR, |
| 5 | + MONTHS_PER_YEAR, |
| 6 | +}; |
| 7 | + |
| 8 | +/// A calendar date, Python's `datetime.date`. |
| 9 | +#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)] |
| 10 | +pub struct ConfigDate { |
| 11 | + pub year: u16, |
| 12 | + pub month: u8, |
| 13 | + pub day: u8, |
| 14 | +} |
| 15 | + |
| 16 | +/// A time of day with microseconds, Python's naive `datetime.time`. |
| 17 | +#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)] |
| 18 | +pub struct ConfigTime { |
| 19 | + pub hour: u8, |
| 20 | + pub minute: u8, |
| 21 | + pub second: u8, |
| 22 | + pub microsecond: u32, |
| 23 | +} |
| 24 | + |
| 25 | +/// A date and time, Python's `datetime.datetime`, with its UTC offset in seconds when aware. |
| 26 | +#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)] |
| 27 | +pub struct ConfigDateTime { |
| 28 | + pub date: ConfigDate, |
| 29 | + pub time: ConfigTime, |
| 30 | + pub utc_offset_seconds: Option<i32>, |
| 31 | +} |
| 32 | + |
| 33 | +impl ConfigDate { |
| 34 | + /// The date, or `None` where Python's `datetime.date` constructor raises. |
| 35 | + pub fn checked(year: i64, month: i64, day: i64) -> Option<Self> { |
| 36 | + let leap = year % 4 == 0 && (year % 100 != 0 || year % 400 == 0); |
| 37 | + let month_days = match month { |
| 38 | + FEBRUARY => 28 + i64::from(leap), |
| 39 | + 4 | 6 | 9 | 11 => 30, |
| 40 | + _ => 31, |
| 41 | + }; |
| 42 | + let valid = (MIN_YEAR..=MAX_YEAR).contains(&year) |
| 43 | + && (1..=MONTHS_PER_YEAR).contains(&month) |
| 44 | + && (1..=month_days).contains(&day); |
| 45 | + valid.then_some(Self { |
| 46 | + year: year as u16, |
| 47 | + month: month as u8, |
| 48 | + day: day as u8, |
| 49 | + }) |
| 50 | + } |
| 51 | +} |
| 52 | + |
| 53 | +impl ConfigTime { |
| 54 | + /// The time, or `None` where Python's `datetime.time` constructor raises. |
| 55 | + pub fn checked(hour: i64, minute: i64, second: i64, microsecond: i64) -> Option<Self> { |
| 56 | + let valid = (0..=MAX_HOUR).contains(&hour) |
| 57 | + && (0..=MAX_MINUTE).contains(&minute) |
| 58 | + && (0..=MAX_SECOND).contains(&second) |
| 59 | + && (0..=MAX_MICROSECOND).contains(µsecond); |
| 60 | + valid.then_some(Self { |
| 61 | + hour: hour as u8, |
| 62 | + minute: minute as u8, |
| 63 | + second: second as u8, |
| 64 | + microsecond: microsecond as u32, |
| 65 | + }) |
| 66 | + } |
| 67 | +} |
| 68 | + |
| 69 | +/// One loaded configuration value; mappings keep document order and Python key equality. |
| 70 | +#[derive(Clone, Debug, PartialEq)] |
| 71 | +pub enum ConfigValue { |
| 72 | + Null, |
| 73 | + Bool(bool), |
| 74 | + Integer(i64), |
| 75 | + BigInteger(String), |
| 76 | + Float(f64), |
| 77 | + String(String), |
| 78 | + Date(ConfigDate), |
| 79 | + DateTime(ConfigDateTime), |
| 80 | + Time(ConfigTime), |
| 81 | + List(Vec<ConfigValue>), |
| 82 | + Map(Vec<(ConfigValue, ConfigValue)>), |
| 83 | +} |
| 84 | + |
| 85 | +impl ConfigValue { |
| 86 | + /// The entries of a mapping, or `None` for any other value. |
| 87 | + pub fn as_map(&self) -> Option<&[(ConfigValue, ConfigValue)]> { |
| 88 | + match self { |
| 89 | + Self::Map(entries) => Some(entries), |
| 90 | + _ => None, |
| 91 | + } |
| 92 | + } |
| 93 | + |
| 94 | + /// The value of a string key in a mapping, as Python's `mapping.get(key)` finds it. |
| 95 | + pub fn get(&self, key: &str) -> Option<&ConfigValue> { |
| 96 | + self.as_map()? |
| 97 | + .iter() |
| 98 | + .find(|(candidate, _)| matches!(candidate, Self::String(text) if text == key)) |
| 99 | + .map(|(_, value)| value) |
| 100 | + } |
| 101 | +} |
0 commit comments