async-native-tls

Asynchronous Native TLS


Crates.io version Download docs.rs docs

API Docs | Releases


Native TLS for async-std or tokio.

This crate uses SChannel on Windows (via schannel), Secure Transport on OSX (via security-framework), and OpenSSL (via openssl) on all other platforms.

Installation

sh $ cargo add async-native-tls

Cargo Feature Flags

Example

async-std

Requires runtime-async-std feature (on by default).

```toml

Cargo.toml

[dependencies] async-native-tls = "0.4" ```

```rust use asyncstd::prelude::*; use asyncstd::net::TcpStream;

let stream = TcpStream::connect("google.com:443").await?; let mut stream = asyncnativetls::connect("google.com", stream).await?; stream.write_all(b"GET / HTTP/1.0\r\n\r\n").await?;

let mut res = Vec::new(); stream.readtoend(&mut res).await?; println!("{}", String::fromutf8lossy(&res)); ```

tokio

Requires runtime-tokio feature.

```toml

Cargo.toml

[dependencies] async-native-tls = { version = "0.4", default-features = false, features = [ "runtime-tokio" ] } ```

```rust use tokio::prelude::*; use tokio::net::TcpStream;

let stream = TcpStream::connect("google.com:443").await?; let mut stream = asyncnativetls::connect("google.com", stream).await?; stream.write_all(b"GET / HTTP/1.0\r\n\r\n").await?;

let mut res = Vec::new(); stream.readtoend(&mut res).await?; println!("{}", String::fromutf8lossy(&res)); ```

Contributing

Want to join us? Check out our "Contributing" guide and take a look at some of these issues:

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.