wtx 0.43.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

use crate::{
  collection::{ArrayVectorU8, Vector},
  http::{
    AutoStream, ManualStream, OperationMode, StatusCode, is_web_socket_handshake,
    server_framework::{Endpoint, EndpointNode, RouteMatch, ServerFrameworkError},
  },
  misc::FnFut,
};

/// Requires a WebSocket tunneling.
#[derive(Debug)]
pub struct WebSocket<T>(
  /// Arbitrary type
  pub T,
);

/// Creates a new [`WebSocket`] instance.
#[inline]
pub fn web_socket<A, T>(ty: T) -> WebSocket<T::Wrapper>
where
  T: FnFut<A>,
{
  WebSocket(ty.into_wrapper())
}

impl<CA, E, S, SA, T> Endpoint<CA, E, S, SA> for WebSocket<T>
where
  E: From<crate::Error>,
  T: Endpoint<CA, E, S, SA>,
{
  const OM: OperationMode = T::OM;

  #[inline]
  async fn auto(
    &self,
    auto_stream: &mut AutoStream<CA, SA>,
    path_defs: (u8, &[RouteMatch]),
  ) -> Result<StatusCode, E> {
    if !is_web_socket_handshake(
      &auto_stream.req.rrd.headers,
      auto_stream.req.method,
      auto_stream.protocol,
    ) {
      return Err(crate::Error::from(ServerFrameworkError::InvalidWebSocketParameters).into());
    }
    self.0.auto(auto_stream, path_defs).await
  }

  #[inline]
  async fn manual(
    &self,
    manual_stream: ManualStream<CA, S, SA>,
    path_defs: (u8, &[RouteMatch]),
  ) -> Result<(), E> {
    if !is_web_socket_handshake(
      &manual_stream.req.rrd.headers,
      manual_stream.req.method,
      manual_stream.protocol,
    ) {
      return Err(crate::Error::from(ServerFrameworkError::InvalidWebSocketParameters).into());
    }
    self.0.manual(manual_stream, path_defs).await
  }
}

impl<CA, E, S, SA, T> EndpointNode<CA, E, S, SA> for WebSocket<T>
where
  E: From<crate::Error>,
  T: Endpoint<CA, E, S, SA>,
{
  const IS_ROUTER: bool = false;

  #[inline]
  fn paths_indices(
    &self,
    _: ArrayVectorU8<RouteMatch, 4>,
    _: &mut Vector<ArrayVectorU8<RouteMatch, 4>>,
  ) -> crate::Result<()> {
    Ok(())
  }
}