safina-net

This is a safe Rust library for network communication.

It is part of safina, a safe async runtime.

Features

• forbid(unsafe_code)
• Depends only on std
• Good test coverage (91%)
• Works with safina-executor or any async executor

Limitations

• No AsyncRead or AsyncWrite implementations yet.
• Unoptimized. Uses polling. This has more latency and CPU load than other async networking libraries.
• TCP connect uses a blocking thread. Concurrent connect operations are limited by executor's blocking thread pool size.

Examples

```rust let bindaddr = std::net::SocketAddr::from(([127, 0, 0, 1], 0)); let mut listener = safinanet::TcpListener::bind(&bindaddr) .unwrap(); let addr = listener.inner().localaddr().unwrap(); println!("{}", &addr);

let executor = safinaexecutor::Executor::default(); executor.spawn(async move { let mut tcpstream = safinanet::TcpStream::connect(addr) .await .unwrap(); let mut buf = String::new(); tcpstream.readtostring(&mut buf).await.unwrap(); println!("read {:?}", buf); });

let (mut tcpstream, _addr) = listener.accept().await.unwrap(); tcpstream.write_all(b"response").await.unwrap(); println!("wrote response"); ```

For complete examples, see the integration tests in tests/.

Alternatives

• async-net
  • Dependencies are full of unsafe
• async-io
  • Full of unsafe
• tokio
  • Very popular
  • Fast
  • Internally incredibly complicated
  • Full of unsafe
• tcp-stream
  • Blocks async executor threads
  • Contains a little unsafe code

Changelog

TO DO

• Add additional crates with adapters to popular async io traits, like safina-net-tokio, safina-net-futures, etc.

License: Apache-2.0