wtx 0.47.2

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
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149

use crate::http::{
  KnownHeaderName, ReqResBuilder, ReqResBuilderInput, ReqResDataMut, Response, StatusCode, Version,
};
use core::ops::{Deref, DerefMut};

/// Response builder
///
/// Provides shortcuts to manipulate responses through a fluent interface.
#[derive(Debug)]
pub struct ResBuilder<RRD> {
  /// Generic builder
  rrb: ReqResBuilder<RRD>,
  /// Status code
  status_code: StatusCode,
  /// See [`Version`].
  version: Version,
}

impl<RRD> ResBuilder<RRD> {
  /// A new empty response with a 400 Bad Request status code.
  #[inline]
  pub const fn bad_request(rrd: RRD) -> Self {
    Self {
      rrb: ReqResBuilder::new(rrd),
      status_code: StatusCode::BadRequest,
      version: Version::Http2,
    }
  }

  /// A new empty response with a 201 Created status code.
  #[inline]
  pub const fn created(rrd: RRD) -> Self {
    Self { rrb: ReqResBuilder::new(rrd), status_code: StatusCode::Created, version: Version::Http2 }
  }

  /// A new empty response with a 500 Internal Server Error status code.
  #[inline]
  pub const fn internal_server_error(rrd: RRD) -> Self {
    Self {
      rrb: ReqResBuilder::new(rrd),
      status_code: StatusCode::InternalServerError,
      version: Version::Http2,
    }
  }

  /// A new empty response with a 404 Not Found status code.
  #[inline]
  pub const fn not_found(rrd: RRD) -> Self {
    Self {
      rrb: ReqResBuilder::new(rrd),
      status_code: StatusCode::NotFound,
      version: Version::Http2,
    }
  }

  /// A new empty response with a 200 OK status code.
  #[inline]
  pub const fn ok(rrd: RRD) -> Self {
    Self { rrb: ReqResBuilder::new(rrd), status_code: StatusCode::Ok, version: Version::Http2 }
  }

  /// Shortcut that converts this instance into a [`Response`].
  #[inline]
  pub fn into_response(self) -> Response<RRD> {
    Response::new(self.rrb.rrd, self.status_code, self.version)
  }

  /// Changes the status code
  #[inline]
  pub const fn status_code(&mut self, status_code: StatusCode) -> &mut Self {
    self.status_code = status_code;
    self
  }
}

impl<RRD> ResBuilder<RRD>
where
  RRD: ReqResDataMut,
{
  /// Sets the `Location` header, typically used with 3xx redirect status codes.
  #[inline]
  pub fn location<'left, 'right, I>(&mut self, uri: I) -> crate::Result<&mut Self>
  where
    I: Into<ReqResBuilderInput<'left, 'right>>,
  {
    self.rrb.push_header(KnownHeaderName::Location.into(), uri)?;
    Ok(self)
  }

  /// Sets the `Set-Cookie` header.
  #[inline]
  pub fn set_cookie<'left, 'right, I>(&mut self, cookie: I) -> crate::Result<&mut Self>
  where
    I: Into<ReqResBuilderInput<'left, 'right>>,
  {
    self.rrb.push_header(KnownHeaderName::SetCookie.into(), cookie)?;
    Ok(self)
  }

  /// Sets the `Cache-Control` header.
  #[inline]
  pub fn cache_control<'left, 'right, I>(&mut self, policy: I) -> crate::Result<&mut Self>
  where
    I: Into<ReqResBuilderInput<'left, 'right>>,
  {
    self.rrb.push_header(KnownHeaderName::CacheControl.into(), policy)?;
    Ok(self)
  }
}

impl<RRD> Default for ResBuilder<RRD>
where
  RRD: Default,
{
  #[inline]
  fn default() -> Self {
    Self::ok(RRD::default())
  }
}

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

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

impl<RRD> Deref for ResBuilder<RRD> {
  type Target = ReqResBuilder<RRD>;

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

impl<RRD> DerefMut for ResBuilder<RRD> {
  #[inline]
  fn deref_mut(&mut self) -> &mut Self::Target {
    &mut self.rrb
  }
}