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

• Allocates
• Unoptimized

Documentation

https://docs.rs/safina-net

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

• v0.1.7 - Use safina-executor v0.3.1.
• v0.1.6 - Use safina-executor v0.3.
• V0.1.5 - Update docs.
• v0.1.4 - Use safina-executor v0.2.
• v0.1.3 - Increase test coverage
• v0.1.2
  • Increase test coverage
  • Handle spurious EPROTOTYPE errors on macOS.
• v0.1.1
  • Add methods to TcpStream: peek, read_vectored, flush, and write_vectored.
  • Support Windows
• v0.1.0 - First published version

TO DO

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

Release Process

1. Edit Cargo.toml and bump version number.
2. Run ./release.sh

License: Apache-2.0