io-arc 1.0.0

Proof of concept Arc with IO trait delegation
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131

//! Proof of concept Arc with IO trait delegation
//!
//! # Examples
//!
//! ```no_run
//! use std::net::TcpStream;
//! use io_arc::IoArc;
//! use std::io::{self, prelude::*};
//!
//! fn main() -> io::Result<()> {
//!     let stream = TcpStream::connect("localhost:8080")?;
//!     let stream = IoArc::new(stream);
//!
//!     let mut stream1 = stream.clone();
//!     let mut _stream2 = stream.clone();
//!
//!     stream1.write(b"hello world")?; // Write is implemented for Arc<TcpStream> directly
//!     Ok(())
//! }
//! ```

#![forbid(unsafe_code, future_incompatible, rust_2018_idioms)]
#![deny(missing_debug_implementations, nonstandard_style)]
#![warn(missing_docs, missing_doc_code_examples, unreachable_pub)]

use futures_io::{AsyncRead, AsyncWrite};
use std::io::{self, prelude::*};
use std::pin::Pin;
use std::sync::Arc;
use std::task::{Context, Poll};

use std::borrow::Borrow;

/// A variant of `Arc` that delegates IO traits if available on `&T`.
#[derive(Debug)]
pub struct IoArc<T>(Arc<T>);

impl<T> IoArc<T> {
    /// Create a new instance of IoArc.
    pub fn new(data: T) -> Self {
        Self(Arc::new(data))
    }
}

impl<T> Read for IoArc<T>
where
    for<'a> &'a T: Read,
{
    fn read(&mut self, buf: &mut [u8]) -> io::Result<usize> {
        (&mut &*self.0).read(buf)
    }
}

impl<T> Write for IoArc<T>
where
    for<'a> &'a T: Write,
{
    fn write(&mut self, buf: &[u8]) -> io::Result<usize> {
        (&mut &*self.0).write(buf)
    }

    fn flush(&mut self) -> io::Result<()> {
        (&mut &*self.0).flush()
    }
}

impl<T> AsyncRead for IoArc<T>
where
    for<'a> &'a T: AsyncRead,
{
    fn poll_read(
        self: Pin<&mut Self>,
        cx: &mut Context<'_>,
        buf: &mut [u8],
    ) -> Poll<io::Result<usize>> {
        Pin::new(&mut &*self.0).poll_read(cx, buf)
    }
}

impl<T> AsyncWrite for IoArc<T>
where
    for<'a> &'a T: AsyncWrite,
{
    fn poll_write(
        self: Pin<&mut Self>,
        cx: &mut Context<'_>,
        buf: &[u8],
    ) -> Poll<io::Result<usize>> {
        Pin::new(&mut &*self.0).poll_write(cx, buf)
    }

    fn poll_flush(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<io::Result<()>> {
        Pin::new(&mut &*self.0).poll_flush(cx)
    }

    fn poll_close(self: Pin<&mut Self>, cx: &mut Context<'_>) -> Poll<io::Result<()>> {
        Pin::new(&mut &*self.0).poll_close(cx)
    }
}

impl<T: Default> Default for IoArc<T> {
    fn default() -> Self {
        Self::new(Default::default())
    }
}

impl<T> From<T> for IoArc<T> {
    fn from(t: T) -> Self {
        Self::new(t)
    }
}

impl<T> Borrow<T> for IoArc<T> {
    fn borrow(&self) -> &T {
        self.0.borrow()
    }
}

impl<T> AsRef<T> for IoArc<T> {
    fn as_ref(&self) -> &T {
        self.0.as_ref()
    }
}

impl<T> Unpin for IoArc<T> {}

impl<T> Clone for IoArc<T> {
    fn clone(&self) -> Self {
        Self(self.0.clone())
    }
}