22 releases

0.2.20 Jan 16, 2024
0.2.19 Jan 16, 2024
0.2.16 Nov 15, 2023
0.2.7 Oct 31, 2023
0.1.0 May 11, 2023

#266 in Network programming

Download history 788/week @ 2023-12-23 1197/week @ 2023-12-30 1378/week @ 2024-01-06 1445/week @ 2024-01-13 1435/week @ 2024-01-20 1855/week @ 2024-01-27 1662/week @ 2024-02-03 1788/week @ 2024-02-10 1821/week @ 2024-02-17 1896/week @ 2024-02-24 2252/week @ 2024-03-02 2226/week @ 2024-03-09 1799/week @ 2024-03-16 1758/week @ 2024-03-23 2495/week @ 2024-03-30 1707/week @ 2024-04-06

8,117 downloads per month
Used in 20 crates (3 directly)

MIT license

120KB
3K SLoC

rustls-tokio-stream

rustls-tokio-stream is a Rust crate that provides an AsyncRead/AsyncWrite interface for rustls.

Features:

  • Supports duplex I/O via tokio::io::split and other methods out-of-the-box
  • Does not require either read or write polling to perform handshakes

Examples

Create a server and client running on localhost:

  fn server_config() -> ServerConfig {
    ServerConfig::builder()
      .with_safe_defaults()
      .with_no_client_auth()
      .with_single_cert(vec![certificate()], private_key())
      .expect("Failed to build server config")
  }

  fn client_config() -> ClientConfig {
    ClientConfig::builder()
      .with_safe_defaults()
      .with_no_client_auth()
  }

  async fn tcp_pair() -> (TcpStream, TcpStream) {
    let listener = TcpListener::bind(SocketAddr::V4(SocketAddrV4::new(Ipv4Addr::LOCALHOST, 0)))
      .await
      .unwrap();
    let port = listener.local_addr().unwrap().port();
    let server = spawn(async move { listener.accept().await.unwrap().0 });
    let client = spawn(async move {
      TcpSocket::new_v4()
        .unwrap()
        .connect(SocketAddr::V4(SocketAddrV4::new(Ipv4Addr::LOCALHOST, port)))
        .await
        .unwrap()
    });

    let (server, client) = (server.await.unwrap(), client.await.unwrap());
    (server, client)
  }

  async fn tls_pair() -> (TlsStream, TlsStream) {
    let (server, client) = tcp_pair().await;
    let server = TlsStream::new_server_side(server, server_config().into());
    let client = TlsStream::new_client_side(
      client,
      client_config().into(),
      "example.com".try_into().unwrap(),
    );

    (server, client)
  }

Dependencies

~10–21MB
~353K SLoC