#web #async #server #network

simple-websockets

Fast and efficient WebSocket server with an easy API

7 releases

0.1.6 Jun 14, 2023
0.1.5 Feb 7, 2023
0.1.4 Nov 9, 2021
0.1.3 Oct 26, 2021
0.1.1 Mar 11, 2021

#52 in WebSocket

Download history 157/week @ 2023-10-16 117/week @ 2023-10-23 522/week @ 2023-10-30 388/week @ 2023-11-06 175/week @ 2023-11-13 101/week @ 2023-11-20 98/week @ 2023-11-27 101/week @ 2023-12-04 81/week @ 2023-12-11 91/week @ 2023-12-18 79/week @ 2023-12-25 77/week @ 2024-01-01 141/week @ 2024-01-08 121/week @ 2024-01-15 85/week @ 2024-01-22 89/week @ 2024-01-29

449 downloads per month
Used in 2 crates

MIT license

15KB
176 lines

simple-websockets

An easy-to-use WebSocket server.

MIT licensed Docs Crates.io

Example

Echo server:

use simple_websockets::{Event, Responder};
use std::collections::HashMap;

fn main() {
    // listen for WebSockets on port 8080:
    let event_hub = simple_websockets::launch(8080)
        .expect("failed to listen on port 8080");
    // map between client ids and the client's `Responder`:
    let mut clients: HashMap<u64, Responder> = HashMap::new();

    loop {
        match event_hub.poll_event() {
            Event::Connect(client_id, responder) => {
                println!("A client connected with id #{}", client_id);
                // add their Responder to our `clients` map:
                clients.insert(client_id, responder);
            },
            Event::Disconnect(client_id) => {
                println!("Client #{} disconnected.", client_id);
                // remove the disconnected client from the clients map:
                clients.remove(&client_id);
            },
            Event::Message(client_id, message) => {
                println!("Received a message from client #{}: {:?}", client_id, message);
                // retrieve this client's `Responder`:
                let responder = clients.get(&client_id).unwrap();
                // echo the message back:
                responder.send(message);
            },
        }
    }
}

Dependencies

~4–12MB
~109K SLoC