ba9227ad31
Differential Revision: https://phabricator.services.mozilla.com/D42365 --HG-- rename : third_party/rust/input_buffer/LICENSE-APACHE => third_party/rust/percent-encoding/LICENSE-APACHE extra : moz-landing-system : lando |
||
---|---|---|
.. | ||
examples | ||
src | ||
tests | ||
.cargo-checksum.json | ||
CHANGELOG.md | ||
Cargo.toml | ||
LICENSE | ||
README.md |
README.md
WS-RS
Lightweight, event-driven WebSockets for Rust.
/// A WebSocket echo server
listen("127.0.0.1:3012", |out| {
move |msg| {
out.send(msg)
}
})
Introduction
This library provides an implementation of WebSockets, RFC6455 using MIO. It allows for handling multiple connections on a single thread, and even spawning new client connections on the same thread. This makes for very fast and resource efficient WebSockets. The API design abstracts away the menial parts of the WebSocket protocol and allows you to focus on application code without worrying about protocol conformance. However, it is also possible to get low-level access to individual WebSocket frames if you need to write extensions or want to optimize around the WebSocket protocol.
Getting Started
For detailed installation and usage instructions, check out the guide.
Features
WS-RS provides a complete implementation of the WebSocket specification. There is also support for ssl and permessage-deflate.
Testing
WS-RS is thoroughly tested and passes the Autobahn Test Suite for
WebSockets, including the tests for permessage-deflate
. Visit
ws-rs.org to view the results of the latest test run.
Contributing
Please report bugs and make feature requests here.