async-datagram 3.0.0

Async datagram traits.
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

# async-datagram
[![crates.io version][1]][2] [![build status][3]][4]
[![downloads][5]][6] [![docs.rs docs][7]][8]

Async datagram traits.

- [Documentation][8]
- [Crates.io][2]
- [Releases][releases]

## Examples
__Basic usage__
```rust
use async_datagram::AsyncDatagram;
use std::task::{Context, Poll};
use std::pin::Pin;

struct Udp;

impl AsyncDatagram for Udp {
  type Sender = std::net::SocketAddr;
  type Receiver = std::net::SocketAddr;
  type Err = std::io::Error;

  fn poll_send_to(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    buf: &[u8],
    target: &Self::Receiver,
  ) -> Poll<Result<usize, Self::Err>> {
    Poll::Ready(Ok(0))
  }

  fn poll_recv_from(
    self: Pin<&mut Self>,
    cx: &mut Context<'_>,
    buf: &mut [u8],
  ) -> Poll<Result<(usize, Self::Sender), Self::Err>> {
    Poll::Pending
  }
}
```

## Installation
```sh
$ cargo add async-datagram
```

## Safety
This crate uses ``#![deny(unsafe_code)]`` to ensure everything is implemented in
100% Safe Rust.

## Contributing
Want to join us? Check out our ["Contributing" guide][contributing] and take a
look at some of these issues:

- [Issues labeled "good first issue"][good-first-issue]
- [Issues labeled "help wanted"][help-wanted]

## References
None.

## License
[MIT](./LICENSE-MIT) OR [Apache-2.0](./LICENSE-APACHE)

[1]: https://img.shields.io/crates/v/async-datagram.svg?style=flat-square
[2]: https://crates.io/crates/async-datagram
[3]: https://img.shields.io/travis/rustasync/async-datagram/master.svg?style=flat-square
[4]: https://travis-ci.org/rustasync/async-datagram
[5]: https://img.shields.io/crates/d/async-datagram.svg?style=flat-square
[6]: https://crates.io/crates/async-datagram
[7]: https://img.shields.io/badge/docs-latest-blue.svg?style=flat-square
[8]: https://docs.rs/async-datagram

[releases]: https://github.com/rustasync/async-datagram/releases
[contributing]: https://github.com/rustasync/async-datagram/blob/master.github/CONTRIBUTING.md
[good-first-issue]: https://github.com/rustasync/async-datagram/labels/good%20first%20issue
[help-wanted]: https://github.com/rustasync/async-datagram/labels/help%20wanted