A lightweight, async WebSocket protocol for Rust.
## Introduction This library provides **type-safe WebSocket communication** with a request-response and notification system built on top of a flexible protocol. It ensures compile-time guarantees for message structure, reduces runtime errors, and simplifies building Rust client/server applications. - **Dynamic Methods**: Each message includes a method enum for type safety. - **Typed Requests & Responses**: Automatic serialization and deserialization. - **Optional Notifications**: Send asynchronous notifications across sessions. ## Features - Fully typed WebSocket sessions - Type-safe request/response mechanism - Optional typed notifications (Todo) - Lightweight, minimal runtime overhead - Async-first with Tokio support ## Installation ```bash cargo add session-rs ``` --- ### **Basic Example (client)** ```rust #[derive(Debug, Serialize, Deserialize)] struct Data; impl Method for Data { const NAME: &'static str = "data"; type Request = String; type Response = String; type Error = String; } let session = Session::connect("127.0.0.1:8080", "/").await?; session.start_receiver(); session .request::("Hello from client".to_string()) .await?; ``` ### **Basic Example (server)** ```rust #[derive(Debug, Serialize, Deserialize)] struct Data; impl Method for Data { const NAME: &'static str = "data"; type Request = String; type Response = String; type Error = String; } let server = SessionServer::bind("127.0.0.1:8080").await?; loop { let session = server.accept().await; session .on::