paperplane 0.2.0

Async WebSocket library
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

<div align="center">
  <h1>
    <img alt="logo" src="./logo/logo.svg" />
    <br />
    Paperplane
  </h1>
  <a href="https://gitlab.com/rasmusmerzin/paperplane/-/commits/master">
    <img alt="build" src="https://img.shields.io/gitlab/pipeline/rasmusmerzin/paperplane/master" />
  </a>
  <a href="https://crates.io/crates/paperplane">
    <img alt="version" src="https://img.shields.io/crates/v/paperplane?label=version" />
  </a>
  <a href="https://crates.io/crates/paperplane">
    <img alt="license" src="https://img.shields.io/crates/l/paperplane?label=license" />
  </a>
  <p>
    WebSocket library which utilizes
    <a href="https://crates.io/crates/async-std">async-std</a>,
    <a href="https://crates.io/crates/async-tungstenite">async-tungstenite</a> &
    <a href="https://crates.io/crates/futures">futures</a>.
    <br />
    Currently it is a proof of concept.
  </p>
</div>

## Example

```rust
use async_std::task;
use paperplane::{Event, Message, Server};
use std::time;

fn main() {
    let server = Server::new();

    {
        let server = server.clone();
        task::spawn(async move {
            let mut count = 0usize;
            loop {
                task::sleep(time::Duration::from_secs(1)).await;
                server.send_all(Message::Text(count.to_string())).await.ok();
                count += 1;
            }
        });
    }

    task::block_on(async {
        server.listen("0.0.0.0:8000").await.unwrap();
        while let Some(event) = server.next().await {
            match event {
                Event::Message(id, msg) => server
                    .send_map(|conn_id| match conn_id == id {
                        true => None,
                        false => Some(msg.clone()),
                    })
                    .await
                    .ok(),
                _ => None,
            };
        }
    });
}
```

Simple duplex communication example.
See [examples folder](./examples) for more examples.

## Should Add

- option to automatically close inactive connections
- option to not accept connections depending on their address (dynamic deny list)