wtx 0.50.0

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

/// Indicates how TLS streams should interpret connections.
pub trait TlsMode: Clone + Default {
  /// See [`TlsModeTy`].
  const TY: TlsModeTy;
}

/// **NOT SECURE**
///
/// Data is treated as plaintext bytes. Useful for tests or local connections.
#[derive(Clone, Debug, Default)]
pub struct TlsModePlainText {}
impl TlsModePlainText {
  /// New instance
  #[inline]
  pub const fn new() -> Self {
    Self {}
  }
}
impl TlsMode for TlsModePlainText {
  const TY: TlsModeTy = TlsModeTy::PlainText;
}

/// Encrypted but **INSECURE**
///
/// Data is encrypted but certificates are **NOT** verified.
#[derive(Clone, Debug, Default)]
pub struct TlsModeUnverified {}
impl TlsModeUnverified {
  /// New instance
  #[inline]
  pub const fn new() -> Self {
    Self {}
  }
}
impl TlsMode for TlsModeUnverified {
  const TY: TlsModeTy = TlsModeTy::Unverified;
}

/// Secure
///
/// Data is encrypted and certificates are verified.
#[derive(Clone, Debug, Default)]
pub struct TlsModeVerified {}
impl TlsModeVerified {
  /// New instance
  #[inline]
  pub const fn new() -> Self {
    Self {}
  }
}
impl TlsMode for TlsModeVerified {
  const TY: TlsModeTy = TlsModeTy::Verified;
}

/// Strictly secure
///
/// Data is encrypted and certificates are heavily inspected. This version differs from
/// [`TlsModeVerified`] in that some valid but lenient certificates might fail.
#[derive(Clone, Debug, Default)]
pub struct TlsModeStrict {}
impl TlsModeStrict {
  /// New instance
  #[inline]
  pub const fn new() -> Self {
    Self {}
  }
}
impl TlsMode for TlsModeStrict {
  const TY: TlsModeTy = TlsModeTy::Strict;
}

/// Indicates how streams should interpret TLS connections.
#[derive(Clone, Copy, Debug, Default, Eq, PartialEq)]
pub enum TlsModeTy {
  /// See [`TlsModePlainText`].
  PlainText,
  /// See [`TlsModeUnverified`].
  Unverified,
  /// See [`TlsModeVerified`].
  #[default]
  Verified,
  /// See [`TlsModeStrict`].
  Strict,
}

impl TlsModeTy {
  /// Returns `true` if this instance is [`TlsModeTy::PlainText`].
  #[inline]
  pub const fn is_plain_text(&self) -> bool {
    matches!(self, Self::PlainText)
  }

  /// Returns `true` if this instance is [`TlsModeTy::Unverified`].
  #[inline]
  pub const fn is_unverified(&self) -> bool {
    matches!(self, Self::Unverified)
  }

  /// Everything but [`TlsModeTy::PlainText`] and [`TlsModeTy::Unverified`] requires a one or more
  /// certifications for evaluations purposes.
  #[inline]
  pub const fn require_certs(&self) -> bool {
    matches!(self, Self::Verified | Self::Strict)
  }
}