70 releases

0.29.2 Aug 20, 2024
0.29.1 Jun 22, 2024
0.28.0 Apr 24, 2024
0.27.1 Jan 2, 2024
0.4.1 Jun 26, 2019

#304 in Network programming

Download history 35871/week @ 2024-07-18 34932/week @ 2024-07-25 36950/week @ 2024-08-01 37766/week @ 2024-08-08 37112/week @ 2024-08-15 35391/week @ 2024-08-22 34813/week @ 2024-08-29 42643/week @ 2024-09-05 36592/week @ 2024-09-12 35333/week @ 2024-09-19 38495/week @ 2024-09-26 34755/week @ 2024-10-03 37184/week @ 2024-10-10 39151/week @ 2024-10-17 37637/week @ 2024-10-24 33357/week @ 2024-10-31

154,132 downloads per month
Used in 92 crates (2 directly)

BSD-2-Clause

33KB
606 lines

std::net::TcpStream on steroids

API Docs Build status Downloads

tcp-stream is a library aiming at providing TLS support to std::net::TcpStream

Warning about crypto backends for rustls

A crypto implementation must be enabled in rustls using feature flags. We mimic what rustls does, providing one feature flag per implementation and enabling the same as rustls by default. Available options are:

  • rustls--aws_lc_rs (default)
  • rustls--ring

Examples

To connect to a remote server:

use tcp_stream::{HandshakeError, TcpStream, TLSConfig};

use std::io::{self, Read, Write};

fn main() {
    let stream = TcpStream::connect("google.com:443").unwrap();
    let mut stream = stream.into_tls("google.com", TLSConfig::default());

    while let Err(HandshakeError::WouldBlock(mid_handshake)) = stream {
        stream = mid_handshake.handshake();
    }

    let mut stream = stream.unwrap();

    while let Err(err) = stream.write_all(b"GET / HTTP/1.0\r\n\r\n") {
        if err.kind() != io::ErrorKind::WouldBlock {
            panic!("error: {:?}", err);
        }
    }
    stream.flush().unwrap();
    let mut res = vec![];
    while let Err(err) = stream.read_to_end(&mut res) {
        if err.kind() != io::ErrorKind::WouldBlock {
            panic!("stream error: {:?}", err);
        }
    }
    println!("{}", String::from_utf8_lossy(&res));
}

Dependencies

~0–18MB
~367K SLoC