26 releases (14 breaking)

0.15.1 Nov 2, 2024
0.14.1 Aug 14, 2024
0.14.0 Jun 26, 2024
0.12.0 Mar 20, 2024
0.3.0 Jun 17, 2023

#231 in WebSocket

Download history 3001/week @ 2024-08-05 2842/week @ 2024-08-12 2754/week @ 2024-08-19 3113/week @ 2024-08-26 1645/week @ 2024-09-02 2023/week @ 2024-09-09 2825/week @ 2024-09-16 3134/week @ 2024-09-23 2970/week @ 2024-09-30 3658/week @ 2024-10-07 4164/week @ 2024-10-14 3462/week @ 2024-10-21 3648/week @ 2024-10-28 4297/week @ 2024-11-04 4359/week @ 2024-11-11 2378/week @ 2024-11-18

14,839 downloads per month
Used in 10 crates (2 directly)

MIT license

165KB
3.5K SLoC

Engineioxide does the heavy lifting for socketioxide, a socket.io server implementation in Rust which integrates with the tower stack.

You can still use engineioxide as a standalone crate to talk with an engine.io client.

Supported Protocols

You can enable support for other engine.io protocol implementations through feature flags. The latest protocol version (v4) is enabled by default.

To add support for the v3 protocol version, adjust your dependency configuration accordingly:

[dependencies]
# Enables the `v3` protocol (`v4` is always enabled, as it's the default).
engineioxide = { version = "0.3.0", features = ["v3"] }

Feature flags :

  • v3: Enable the engine.io v3 protocol
  • tracing: Enable tracing logs with the tracing crate

Basic example with axum :

use bytes::Bytes;
use engineioxide::layer::EngineIoLayer;
use engineioxide::handler::EngineIoHandler;
use engineioxide::{Socket, DisconnectReason, Str};
use std::sync::atomic::{AtomicUsize, Ordering};
use std::sync::{Arc, Mutex};
use axum::routing::get;
// Global state, with axum it must be clonable
#[derive(Debug, Default, Clone)]
struct MyHandler {
    user_cnt: Arc<AtomicUsize>,
}

// Socket state
#[derive(Debug, Default)]
struct SocketState {
    id: Mutex<String>,
}

impl EngineIoHandler for MyHandler {
    type Data = SocketState;

    fn on_connect(self: Arc<Self>, socket: Arc<Socket<SocketState>>) {
        let cnt = self.user_cnt.fetch_add(1, Ordering::Relaxed) + 1;
        socket.emit(cnt.to_string()).ok();
    }
    fn on_disconnect(&self,
        socket: Arc<Socket<SocketState>>,
        reason: DisconnectReason
    ) {
        let cnt = self.user_cnt.fetch_sub(1, Ordering::Relaxed) - 1;
        socket.emit(cnt.to_string()).ok();
    }
    fn on_message(&self, msg: Str, socket: Arc<Socket<SocketState>>) {
        *socket.data.id.lock().unwrap() = msg.into(); // bind a provided user id to a socket
    }
    fn on_binary(&self, data: Bytes, socket: Arc<Socket<SocketState>>) { }
}

// Create a new engineio layer
let layer = EngineIoLayer::new(Arc::new(MyHandler::default()));

let app = axum::Router::<()>::new()
    .route("/", get(|| async { "Hello, World!" }))
    .layer(layer);

// Spawn the axum server

Dependencies

~6–15MB
~190K SLoC