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

use core::marker::PhantomData;

use crate::{
  codec::{CodecController, Decode, DecodeSeq, Encode},
  collection::Vector,
  misc::Lease,
};

/// Generic `D`ecoder/`E`ncoder
#[derive(Debug)]
pub struct GenericCodec<DA, EA> {
  decode_aux: PhantomData<DA>,
  encode_aux: PhantomData<EA>,
}

impl<DA, EA> CodecController for GenericCodec<DA, EA> {
  type DecodeWrapper<'inner, 'outer, 'rem>
    = DecodeWrapper<'inner, DA>
  where
    'inner: 'outer;
  type Error = crate::Error;
  type EncodeWrapper<'inner, 'outer, 'rem>
    = EncodeWrapper<'inner, EA>
  where
    'inner: 'outer;
}

impl<DA, EA> Decode<'_, GenericCodec<DA, EA>> for () {
  #[inline]
  fn decode(_: &mut DecodeWrapper<'_, DA>) -> crate::Result<Self> {
    Ok(())
  }
}

impl<DA, EA> DecodeSeq<'_, GenericCodec<DA, EA>> for () {
  #[inline]
  fn decode_seq(_: &mut Vector<Self>, _: &mut DecodeWrapper<'_, DA>) -> crate::Result<()> {
    Ok(())
  }
}

impl<DA, EA> Encode<GenericCodec<DA, EA>> for () {
  #[inline]
  fn encode(&self, _: &mut EncodeWrapper<'_, EA>) -> crate::Result<()> {
    Ok(())
  }
}

/// Struct used for decoding different formats.
#[derive(Debug, PartialEq)]
pub struct DecodeWrapper<'de, DA> {
  /// Raw bytes where decoded elements are originated.
  pub bytes: &'de [u8],
  /// Auxiliary decoding data
  pub decode_aux: DA,
}

impl<'de, DA> DecodeWrapper<'de, DA> {
  /// Shortcut
  #[inline]
  pub const fn new(bytes: &'de [u8], decode_aux: DA) -> Self {
    Self { bytes, decode_aux }
  }
}

impl<DA> Lease<[u8]> for DecodeWrapper<'_, DA> {
  #[inline]
  fn lease(&self) -> &[u8] {
    self.bytes
  }
}

/// Struct used for encoding different formats.
#[derive(Debug)]
pub struct EncodeWrapper<'any, EA> {
  /// Buffer where the encoded contents are stored.
  pub buffer: &'any mut Vector<u8>,
  /// Auxiliary encoding data
  pub encode_aux: EA,
}

impl<'any, EA> EncodeWrapper<'any, EA> {
  /// Shortcut
  #[inline]
  pub const fn new(buffer: &'any mut Vector<u8>, encode_aux: EA) -> Self {
    Self { buffer, encode_aux }
  }
}

impl<EA> Lease<[u8]> for EncodeWrapper<'_, EA> {
  #[inline]
  fn lease(&self) -> &[u8] {
    self.buffer
  }
}