wtx 0.28.0

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

use core::time::Duration;

/// Tries to support different time machineries of different platforms.
///
/// Currently only supports `std`. For anything else, methods return errors.
#[derive(Clone, Copy, Debug, Eq, Ord, PartialEq, PartialOrd)]
#[cfg_attr(feature = "serde", derive(serde::Deserialize, serde::Serialize))]
pub struct GenericTime {
  #[cfg(feature = "std")]
  _inner: std::time::SystemTime,
  #[cfg(all(feature = "embassy-time", not(any(feature = "std"))))]
  _inner: embassy_time::Instant,
  #[cfg(not(any(feature = "std", feature = "embassy-time")))]
  _inner: (),
}

impl GenericTime {
  /// Returns an instant corresponding to "now".
  #[inline]
  pub fn now() -> Self {
    #[cfg(feature = "std")]
    return Self { _inner: std::time::SystemTime::now() };
    #[cfg(all(feature = "embassy-time", not(any(feature = "std"))))]
    return Self { _inner: embassy_time::Instant::now() };
    #[cfg(not(any(feature = "std", feature = "embassy-time")))]
    return Self { _inner: () };
  }

  /// Returns `Some(t)` where `t` is the time `self + duration` if `t` can be represented as
  /// `GenericTime` (which means it's inside the bounds of the underlying data structure), `None`
  /// otherwise.
  #[inline]
  pub fn checked_add(&self, _duration: Duration) -> crate::Result<Self> {
    #[cfg(feature = "std")]
    return Ok(Self {
      _inner: self._inner.checked_add(_duration).ok_or(crate::Error::InvalidTimeArithmetic)?,
    });
    #[cfg(all(feature = "embassy-time", not(any(feature = "std"))))]
    return Ok(Self {
      _inner: self
        ._inner
        .checked_add(embassy_time::Duration::from_secs(_duration.as_secs()))
        .ok_or(crate::Error::InvalidTimeArithmetic)?,
    });
    #[cfg(not(any(feature = "std", feature = "embassy-time")))]
    return Err(crate::Error::GenericTimeNeedsBackend);
  }

  /// Returns `Some(t)` where `t` is the time `self - duration` if `t` can be represented as
  /// `GenericTime` (which means it's inside the bounds of the underlying data structure), `None`
  /// otherwise.
  #[inline]
  pub fn checked_sub(&self, _duration: Duration) -> crate::Result<Self> {
    #[cfg(feature = "std")]
    return Ok(Self {
      _inner: self._inner.checked_sub(_duration).ok_or(crate::Error::InvalidTimeArithmetic)?,
    });
    #[cfg(all(feature = "embassy-time", not(any(feature = "std"))))]
    return Ok(Self {
      _inner: self
        ._inner
        .checked_sub(embassy_time::Duration::from_secs(_duration.as_secs()))
        .ok_or(crate::Error::InvalidTimeArithmetic)?,
    });
    #[cfg(not(any(feature = "std", feature = "embassy-time")))]
    return Err(crate::Error::GenericTimeNeedsBackend);
  }

  /// Returns the amount of time elapsed from another instant to this one,
  /// or None if that instant is later than this one.
  #[inline]
  pub fn duration_since(&self, _earlier: Self) -> crate::Result<Duration> {
    #[cfg(feature = "std")]
    return self
      ._inner
      .duration_since(_earlier._inner)
      .map_err(|_err| crate::Error::InvalidHardwareTime);
    #[cfg(all(feature = "embassy-time", not(any(feature = "std"))))]
    return Ok(Duration::from_micros(
      self
        ._inner
        .checked_duration_since(_earlier._inner)
        .ok_or(crate::Error::InvalidTimeArithmetic)?
        .as_micros(),
    ));
    #[cfg(not(any(feature = "std", feature = "embassy-time")))]
    return Err(crate::Error::GenericTimeNeedsBackend);
  }

  /// Returns the amount of time elapsed since this instant was created.
  #[inline]
  pub fn elapsed(&self) -> crate::Result<Duration> {
    Self::now().duration_since(*self)
  }

  /// UNIX timestamp of the current time
  #[inline]
  pub fn timestamp() -> crate::Result<Duration> {
    #[cfg(feature = "std")]
    return Self::now().duration_since(Self { _inner: std::time::UNIX_EPOCH });
    #[cfg(all(feature = "embassy-time", not(any(feature = "std"))))]
    return Self::now().duration_since(Self { _inner: embassy_time::Instant::from_secs(0) });
    #[cfg(not(any(feature = "std", feature = "embassy-time")))]
    return Err(crate::Error::GenericTimeNeedsBackend);
  }
}