barehttp 0.1.0

Blocking HTTP/1.1 client for no_std + alloc
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

//! Custom `DnsResolver` + `BlockingSocket` on `HttpClient`.
//! Logging wrappers over the OS resolver and socket.

use barehttp::config::Config;
use barehttp::{
  BlockingSocket, BlockingSocketFactory, DnsResolver, Error, HttpClient, IpAddr, OsBlockingSocket, OsDnsResolver,
  SocketAddr,
};
use barehttp::{DnsError, SocketError};

/// OS DNS with resolve logging.
struct LoggingDns {
  inner: OsDnsResolver,
}

impl DnsResolver for LoggingDns {
  fn resolve(
    &self,
    host: &str,
  ) -> Result<Vec<IpAddr>, DnsError> {
    println!("dns: resolving {host}");
    let addrs = self.inner.resolve(host)?;
    println!("dns: {host} -> {addrs:?}");
    Ok(addrs)
  }
}

/// Cleartext [`OsBlockingSocket`] wrapper with connect / byte-count logging.
///
/// [`BlockingSocket::is_os_cleartext`] is `true`. Do not enable `assume_tls_socket`
/// unless this type terminates TLS.
struct LoggingSocket {
  inner: OsBlockingSocket,
}

impl BlockingSocket for LoggingSocket {
  fn connect(
    &mut self,
    addr: &SocketAddr,
    host: &str,
  ) -> Result<(), SocketError> {
    println!("tcp: connect {addr} (host={host})");
    self.inner.connect(addr, host)
  }

  fn read(
    &mut self,
    buf: &mut [u8],
  ) -> Result<usize, SocketError> {
    let n = self.inner.read(buf)?;
    println!("tcp: read {n} bytes");
    Ok(n)
  }

  fn write(
    &mut self,
    buf: &[u8],
  ) -> Result<usize, SocketError> {
    let n = self.inner.write(buf)?;
    println!("tcp: write {n} bytes");
    Ok(n)
  }

  fn shutdown(&mut self) -> Result<(), SocketError> {
    println!("tcp: shutdown");
    self.inner.shutdown()
  }

  fn set_read_timeout(
    &mut self,
    timeout_ms: u32,
  ) -> Result<(), SocketError> {
    self.inner.set_read_timeout(timeout_ms)
  }

  fn set_write_timeout(
    &mut self,
    timeout_ms: u32,
  ) -> Result<(), SocketError> {
    self.inner.set_write_timeout(timeout_ms)
  }

  fn set_connect_timeout(
    &mut self,
    timeout_ms: u32,
  ) -> Result<(), SocketError> {
    self.inner.set_connect_timeout(timeout_ms)
  }

  fn is_os_cleartext() -> bool {
    // Cleartext OS TCP: report true so assume_tls_socket is rejected.
    true
  }
}

impl BlockingSocketFactory for LoggingSocket {
  fn new() -> Result<Self, SocketError> {
    Ok(Self {
      inner: OsBlockingSocket::new()?,
    })
  }
}

fn main() -> Result<(), Error> {
  let dns = LoggingDns { inner: OsDnsResolver };
  let client: HttpClient<LoggingSocket, LoggingDns> = HttpClient::with_adapters(dns, Config::default());

  let response = client.get("http://example.com/").call()?;
  let preview: String = response.to_text()?.chars().take(120).collect();
  println!("{} {}", response.status_code(), preview);
  Ok(())
}