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 (89%)
• 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);

std::thread::spawn(move || { let mut tcpstream = std::net::TcpStream::connect(addr) .unwrap(); let mut buf = String::new(); use std::io::Read; tcpstream.readtostring(&mut buf).unwrap(); println!("read {:?}", buf); }); // let executor = safinaexecutor::Executor::new(1); // 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.0 - First published version

TO DO

• DONE - Implement TcpListener and TcpStream with tests & docs
• DONE - Publish on crates.io
• 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