Crate async_io_converse

Expand description

async-io-converse

A wrapper over the async-io-typed crate which allows serde compatible types to be sent over any duplex connection that has types that implement AsyncRead and AsyncWrite. async-io-converse adds the ability to receive replies from the other process.

Who needs this?

If you have two endpoints that need to communicate with each other and

You can establish some kind of duplex I/O connection between them (i.e. TCP, named pipes, or a unix socket)
You need clear message boundaries
You’re not trying to conform to an existing wire format such as HTTP or protobufs. This crate uses a custom format.
The data you wish to send can be easily represented in a Rust type, and that type implements serde’s Deserialize and Serialize traits.

Then this crate might be useful to you!

Who doesn’t need this?

If the endpoints are in the same process then you should not use this crate. You’re better served by existing async mpsc channels. Many crates provide async mpsc channels, including futures and tokio. Pick your favorite implementation. Additionally, if you’re trying to interface with a process that doesn’t have Rust code, and can’t adopt a Rust portion, this crate will hurt much more than it will help. Consider using protobufs or JSON if Rust adoption is a blocker.