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
|
# async-dup
[](
https://github.com/smol-rs/async-dup/actions)
[](
https://github.com/smol-rs/async-dup)
[](
https://crates.io/crates/async-dup)
[](
https://docs.rs/async-dup)
Duplicate an async I/O handle.
This crate provides two tools, `Arc` and `Mutex`:
* `Arc` implements `AsyncRead`, `AsyncWrite`, and `AsyncSeek` if a reference to the inner type does.
* A reference to `Mutex` implements `AsyncRead`, `AsyncWrite`, and `AsyncSeek` if the inner type does.
Wrap an async I/O handle in `Arc` or `Mutex` to clone it or share among tasks.
## Examples
Clone an async I/O handle:
```rust
use async_dup::Arc;
use futures::io;
use smol::Async;
use std::net::TcpStream;
// A client that echoes messages back to the server.
let stream = Async::<TcpStream>::connect("127.0.0.1:8000").await?;
// Create two handles to the stream.
let reader = Arc::new(stream);
let mut writer = reader.clone();
// Echo data received from the reader back into the writer.
io::copy(reader, &mut writer).await?;
```
Share an async I/O handle:
```rust
use async_dup::Mutex;
use futures::io;
use futures::prelude::*;
// Reads data from a stream and echoes it back.
async fn echo(stream: impl AsyncRead + AsyncWrite + Unpin) -> io::Result<u64> {
let stream = Mutex::new(stream);
io::copy(&stream, &mut &stream).await
}
```
## License
Licensed under either of
* Apache License, Version 2.0 ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
* MIT license ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)
at your option.
#### Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.
|
