Lightweight stream-based WebSocket implementation for Rust.
Lightweight stream-based WebSocket implementation for Rust.
Lightweight stream-based WebSocket implementation for Rust.
…Take a look at the examples section to see how to write a simple client/server.
NOTE: tungstenite-rs is more like a barebone to build reliable modern networking applications
using WebSockets. If you're looking for a modern production-ready "batteries included" WebSocket
library that allows you to efficiently use non-blocking sockets and do "full-duplex" communication,
take a look at tokio-tungstenite.
Documentation
This library provides an implementation of WebSockets, RFC6455. It allows for both synchronous (like TcpStream) and asynchronous usage and is easy to integrate into any third-party event loops including MIO. The API design abstracts away all the internals of the WebSocket protocol but still makes them accessible for those who wants full control over the network.
It's formerly WS2, the 2nd implementation of WS. WS2 is the chemical formula of tungsten disulfide, the tungstenite mineral.
Tungstenite provides a complete implementation of the WebSocket specification.
TLS is supported on all platforms using native-tls or rustls. The following
features are available:
native-tlsnative-tls-vendoredrustls-tls-native-rootsrustls-tls-webpki-rootsChoose the one that is appropriate for your needs.
By default no TLS feature is activated, so make sure you use one of the TLS features, otherwise you won't be able to communicate with the TLS endpoints.
There is no support for permessage-deflate at the moment, but the PRs are welcome :wink:
Tungstenite is thoroughly tested and passes the Autobahn Test Suite for WebSockets. It is also covered by internal unit tests as well as possible.
Benches are in ./benches.
cargo bench --bench \* -- --quick --noplotcargo bench --bench e2e -- --quick --noplotPlease report bugs and make feature requests here.
No open issues yet, or sync has not completed.