httpageboy 1.0.19

A lightweight library for handling raw HTTP request/response transmission. Good base for APIs. Supports both synchronous and asynchronous programming models.
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

use crate::core::cors::CorsPolicy;
use crate::core::request::handle_request_async;
use crate::core::request_handler::Rh;
use crate::core::response::Response;
use crate::runtime::r#async::shared;
use crate::runtime::shared::print_server_info;
use async_std::io::prelude::*;
use async_std::net::{Shutdown, TcpListener, TcpStream};
use async_std::task::spawn;
use async_trait::async_trait;
use std::collections::HashMap;
use std::ops::{Deref, DerefMut};
use std::sync::Arc;

#[async_trait]
impl shared::AsyncStream for TcpStream {
  async fn write_all(&mut self, buf: &[u8]) -> std::io::Result<()> {
    WriteExt::write_all(self, buf).await
  }

  async fn flush(&mut self) -> std::io::Result<()> {
    WriteExt::flush(self).await
  }

  async fn shutdown(&mut self) -> std::io::Result<()> {
    std::future::ready(TcpStream::shutdown(self, Shutdown::Both)).await
  }
}

/// A non-blocking HTTP server powered by async-std.
pub struct Server(pub shared::GenericServer<TcpListener>);

impl Deref for Server {
  type Target = shared::GenericServer<TcpListener>;
  fn deref(&self) -> &Self::Target {
    &self.0
  }
}

impl DerefMut for Server {
  fn deref_mut(&mut self) -> &mut Self::Target {
    &mut self.0
  }
}

impl Server {
  /// Creates a new server and binds to the specified URL.
  pub async fn new(
    serving_url: &str,
    routes_list: Option<HashMap<(crate::core::request_type::Rt, String), Rh>>,
  ) -> std::io::Result<Self> {
    let listener = TcpListener::bind(serving_url).await?;
    let url = listener.local_addr()?.to_string();
    Ok(Server(shared::GenericServer {
      listener,
      url,
      routes: Arc::new(routes_list.unwrap_or_default()),
      files_sources: Arc::new(Vec::new()),
      auto_close: true,
      cors: Some(Arc::new(CorsPolicy::default())),
    }))
  }

  /// Returns the socket address the server is currently bound to.
  pub fn local_addr(&self) -> std::io::Result<std::net::SocketAddr> {
    self.listener.local_addr()
  }

  pub fn url(&self) -> &str {
    self.0.url.as_str()
  }

  pub fn set_cors(&mut self, policy: CorsPolicy) {
    self.0.cors = Some(Arc::new(policy));
  }

  pub fn set_cors_str(&mut self, config: &str) {
    self.set_cors(CorsPolicy::from_config_str(config));
  }

  /// Starts the server and begins accepting connections.
  pub async fn run(&self) {
    print_server_info(self.listener.local_addr().unwrap(), self.auto_close);
    while let Ok((mut stream, _)) = self.listener.accept().await {
      let routes = self.routes.clone();
      let files = self.files_sources.clone();
      let close_flag = self.auto_close;
      let cors_policy = self.cors.clone();

      spawn(async move {
        let (mut req, early) = crate::core::request::parse_stream_async_std(&mut stream, &routes, &files).await;
        let origin = req.origin().map(str::to_string);
        let method = req.method.clone();
        let resp = match early {
          Some(r) => r,
          None => {
            let routed = handle_request_async(&mut req, &routes, &files).await;
            if routed.is_none() && method == crate::core::request_type::RequestType::OPTIONS && cors_policy.is_some() {
              cors_policy
                .as_deref()
                .map(|policy| policy.preflight_response())
                .unwrap_or_else(Response::new)
            } else {
              routed.unwrap_or_else(Response::new)
            }
          }
        };
        shared::send_response(
          &mut stream,
          &resp,
          close_flag,
          cors_policy.as_deref(),
          origin.as_deref(),
        )
        .await;
      });
    }
  }
}