#io #reconnect #retry #tcp-stream #tokio #stubborn #stubborn-tcp-stream

stubborn-io

io traits/structs that automatically recover from potential disconnections/interruptions

19 releases

0.3.5 May 8, 2024
0.3.4 Jan 25, 2024
0.3.3 Dec 13, 2023
0.3.2 Sep 30, 2022
0.1.0 Jul 31, 2019

#203 in Network programming

Download history 3173/week @ 2024-01-24 3622/week @ 2024-01-31 3342/week @ 2024-02-07 4321/week @ 2024-02-14 3437/week @ 2024-02-21 3335/week @ 2024-02-28 3963/week @ 2024-03-06 3860/week @ 2024-03-13 3864/week @ 2024-03-20 2914/week @ 2024-03-27 3849/week @ 2024-04-03 3304/week @ 2024-04-10 4063/week @ 2024-04-17 3955/week @ 2024-04-24 3199/week @ 2024-05-01 2642/week @ 2024-05-08

14,607 downloads per month
Used in 2 crates

MIT license

32KB
615 lines

stubborn-io

This crate provides io traits/structs that automatically recover from potential disconnections/interruptions.

To use with your project, add the following to your Cargo.toml:

stubborn-io = "0.3"

API Documentation, examples and motivations can be found here - https://docs.rs/stubborn-io .

Usage Example

In this example, we will see a drop in replacement for tokio's TcpStream, with the distinction that it will automatically attempt to reconnect in the face of connectivity failures.

use stubborn_io::StubbornTcpStream;
use tokio::io::AsyncWriteExt;

let addr = "localhost:8080";

// we are connecting to the TcpStream using the default built in options.
// these can also be customized (for example, the amount of reconnect attempts,
// wait duration, etc) using the connect_with_options method.
let mut tcp_stream = StubbornTcpStream::connect(addr).await?;
// once we acquire the wrapped IO, in this case, a TcpStream, we can
// call all of the regular methods on it, as seen below
tcp_stream.write_all(b"hello world!").await?;

Dependencies

~3–11MB
~103K SLoC