5 unstable releases

0.3.2 Jan 18, 2025
0.3.1 Sep 9, 2024
0.3.0 Jul 18, 2024
0.2.0 May 23, 2024
0.1.0 May 22, 2024

#369 in Asynchronous

Download history 35/week @ 2024-12-09 7/week @ 2025-01-06 112/week @ 2025-01-13 79/week @ 2025-01-20 77/week @ 2025-01-27 139/week @ 2025-02-03 69/week @ 2025-02-10 94/week @ 2025-02-17 66/week @ 2025-02-24 33/week @ 2025-03-03 31/week @ 2025-03-10 54/week @ 2025-03-17

191 downloads per month
Used in golang-ipc-rs

MIT/Apache

31KB
712 lines

tipsy

crates.io docs.rs Dependency Status license CI codecov GitHub repo size Lines of Code

This is a fork of parity-tokio-ipc.

tipsy is a library for cross-platform async IPC using Tokio. It utilizes unix sockets on UNIX (via tokio::net::UnixStream) and named pipes on windows (via tokio::net::windows::named_pipe).

Server

use tipsy::{Endpoint, OnConflict, ServerId};
use futures::stream::StreamExt;
use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    Endpoint::new(ServerId::new("my-server"), OnConflict::Overwrite)?
        .incoming()?
        .for_each(|conn| async {
            match conn {
                Ok(stream) => println!("Got connection!"),
                Err(e) => eprintln!("Error when receiving connection: {:?}", e),
            }
        });
    Ok(())
}

Client

use tipsy::{Endpoint, ServerId};
use tokio::io::AsyncWriteExt;
use std::error::Error;

#[tokio::main]
async fn main() -> Result<(), Box<dyn Error>> {
    let mut client = Endpoint::connect(ServerId::new("my-server")).await?;
    client.write_all(b"ping").await?;
    Ok(())
}

Examples

See examples.

Supported Rust Versions

The MSRV is currently 1.75.0.

Dependencies

~3–12MB
~131K SLoC