wtx 0.44.2

A collection of different transport implementations and related tools focused primarily on web technologies.
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
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

use crate::calendar::CalendarError;

/// Semantical unit usually extracted from a stream of bytes
///
/// # Date Formats
///
/// | Format  | Example  | Description                                                                       |
/// | ------- | -------- | --------------------------------------------------------------------------------- |
/// | `%Y`    | `2001`   | Year with four zero-padded digits                                                 |
/// | `%y`    | `01`     | Year with two zero-padded digits                                                  |
/// |         |          |                                                                                   |
/// | `%m`    | `07`     | Month with two zero-padded digits                                                 |
/// | `%b`    | `Jul`    | Abbreviated month name                                                            |
/// |         |          |                                                                                   |
/// | `%d`    | `08`     | Day of month with two zero-padded digits                                          |
/// | `%e`    | ` 8`     | Same as `%d` but space-padded                                                     |
/// |         |          |                                                                                   |
/// | `%a`    | `Sun`    | Abbreviated weekday name                                                          |
/// | `%A`    | `Sunday` | Full weekday name                                                                 |
/// |         |          |                                                                                   |
/// | `%z?`   | `±03`    | Optional offset from the local time to UTC with or without `Z`, colon or minutes¹ |
///
/// # Time Formats
///
/// | Format  | Example  | Description                                     |
/// | ------- | -------- | ----------------------------------------------- |
/// | `%H`    | `00`     | Hour with two zero-padded digits                |
/// |         |          |                                                 |
/// | `%M`    | `59`     | Sixty with two zero-padded digits               |
/// |         |          |                                                 |
/// | `%S`    | `59`     | Second with two zero-padded digits              |
/// |         |          |                                                 |
/// | `%f?`   | `.12345` | Optional number of nanosecond with a dot prefix |
///
/// # Literal Formats
///
/// | Format  | Name                |
/// | ------- | ------------------- |
/// | `:`     | Colon               |
/// | `,`     | Comma               |
/// | `-`     | Dash                |
/// | `.`     | Dot                 |
/// | `GMT`   | Greenwich Mean Time |
/// | `/`     | Slash               |
/// | ` `     | Space               |
/// | `T`     | Date/Time separator |
///
/// ¹: Decoding accept many optional parameters but encoding will always output ±00:00 or `Z`.
#[derive(Clone, Copy, Debug, Eq, Ord, PartialEq, PartialOrd)]
pub enum CalendarToken {
  /// `%b` (Jul)
  AbbreviatedMonthName,
  /// `%a` (Sun)
  AbbreviatedWeekdayName,
  /// Literal `:`
  Colon,
  /// Literal `,`
  Comma,
  /// Literal `-`
  Dash,
  /// Literal `.`
  Dot,
  /// Optional `%f?` `123_456_789`
  DotNano,
  /// `%Y` (2001)
  FourDigitYear,
  /// `%A` (Sunday)
  FullWeekdayName,
  /// Literal `GMT`
  Gmt,
  /// Literal `T`
  Separator,
  /// Literal `/`
  Slash,
  /// Literal ` `
  Space,
  /// Optional `%z?` (`Z`, +03, -0300, +03:30)
  TimeZone,
  /// `%d` (01)
  TwoDigitDay,
  /// `%H` (00)
  TwoDigitHour,
  /// `%M` (00)
  TwoDigitMinute,
  /// `%m` (01)
  TwoDigitMonth,
  /// `%S` (00)
  TwoDigitSecond,
  /// `%y` (25)
  TwoDigitYear,
  /// `%e` ( 1)
  TwoSpaceDay,
}

impl TryFrom<[u8; 2]> for CalendarToken {
  type Error = crate::Error;

  #[inline]
  fn try_from(value: [u8; 2]) -> Result<Self, Self::Error> {
    Ok(match value {
      [0, b'b'] => Self::AbbreviatedMonthName,
      [0, b'a'] => Self::AbbreviatedWeekdayName,
      [0, b':'] => Self::Colon,
      [0, b'.'] => Self::Dot,
      [0, b','] => Self::Comma,
      [0, b'-'] => Self::Dash,
      [b'f', b'?'] => Self::DotNano,
      [0, b'Y'] => Self::FourDigitYear,
      [0, b'A'] => Self::FullWeekdayName,
      [0, b'T'] => Self::Separator,
      [0, b'/'] => Self::Slash,
      [0, b' '] => Self::Space,
      [0, b'd'] => Self::TwoDigitDay,
      [0, b'H'] => Self::TwoDigitHour,
      [0, b'M'] => Self::TwoDigitMinute,
      [0, b'm'] => Self::TwoDigitMonth,
      [0, b'S'] => Self::TwoDigitSecond,
      [0, b'y'] => Self::TwoDigitYear,
      [0, b'e'] => Self::TwoSpaceDay,
      [0, b'Z'] | [b'z', b'?'] => Self::TimeZone,
      _ => return Err(CalendarError::UnknownParsingFormat.into()),
    })
  }
}