wtx 0.47.6

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

use crate::http::{Method, MsgBuilder, MsgDataMut, Request, WTX_USER_AGENT};
use core::ops::{Deref, DerefMut};

/// Request builder
///
/// Provides shortcuts to manipulate requests through a fluent interface.
#[derive(Debug)]
pub struct ReqBuilder<MD> {
  method: Method,
  msg_builder: MsgBuilder<MD>,
}

impl<MD> ReqBuilder<MD> {
  /// Constructor shortcut that has a default `GET` method
  #[inline]
  pub const fn get(msg_data: MD) -> Self {
    Self::new(Method::Get, msg_data)
  }

  /// Constructor shortcut that has the provided method.
  #[inline]
  pub const fn new(method: Method, msg_data: MD) -> Self {
    Self { method, msg_builder: MsgBuilder::new(msg_data) }
  }

  /// Constructor shortcut that has a default `POST` method
  #[inline]
  pub const fn post(msg_data: MD) -> Self {
    Self::new(Method::Post, msg_data)
  }

  /// Shortcut that converts this instance into a [`Request`].
  #[inline]
  pub fn into_request(self) -> Request<MD> {
    Request::new(self.method, self.msg_builder.msg_data)
  }

  /// Changes the method
  #[inline]
  pub const fn set_method(&mut self, method: Method) -> &mut Self {
    self.method = method;
    self
  }
}

impl<MD> ReqBuilder<MD>
where
  MD: MsgDataMut,
{
  /// Adds the headers that most servers expect from clients: `accept`, `host` and `user-agent`.
  #[inline]
  pub fn basic_req_headers(&mut self) -> crate::Result<&mut Self> {
    let _ = self.accept(&["*/*"])?.host::<()>(None)?.user_agent(&[WTX_USER_AGENT])?;
    Ok(self)
  }
}

impl<'msg_data, MD> ReqBuilder<&'msg_data mut MD> {
  /// Constructor shortcut that has a default `GET` method
  #[inline]
  pub const fn from_req_mut(req: &'msg_data mut Request<MD>) -> Self {
    Self::new(req.method, &mut req.msg_data)
  }
}

impl<MD> AsMut<ReqBuilder<MD>> for ReqBuilder<MD> {
  #[inline]
  fn as_mut(&mut self) -> &mut ReqBuilder<MD> {
    self
  }
}

impl<MD> AsRef<ReqBuilder<MD>> for ReqBuilder<MD> {
  #[inline]
  fn as_ref(&self) -> &ReqBuilder<MD> {
    self
  }
}

impl<MD> Default for ReqBuilder<MD>
where
  MD: Default,
{
  #[inline]
  fn default() -> Self {
    Self::get(MD::default())
  }
}

impl<MD> Deref for ReqBuilder<MD> {
  type Target = MsgBuilder<MD>;

  #[inline]
  fn deref(&self) -> &Self::Target {
    &self.msg_builder
  }
}

impl<MD> DerefMut for ReqBuilder<MD> {
  #[inline]
  fn deref_mut(&mut self) -> &mut Self::Target {
    &mut self.msg_builder
  }
}