#websocket #io #web #tokio #async-std

async-tungstenite

Async binding for Tungstenite, the Lightweight stream-based WebSocket implementation

25 releases (14 breaking)

0.15.0 Sep 9, 2021
0.14.0 Jul 5, 2021
0.13.1 Mar 23, 2021
0.11.0 Dec 30, 2020
0.2.0 Nov 29, 2019

#5 in WebSocket

Download history 16071/week @ 2021-07-02 17191/week @ 2021-07-09 15825/week @ 2021-07-16 13928/week @ 2021-07-23 15280/week @ 2021-07-30 13649/week @ 2021-08-06 13789/week @ 2021-08-13 14357/week @ 2021-08-20 14775/week @ 2021-08-27 15495/week @ 2021-09-03 18767/week @ 2021-09-10 19694/week @ 2021-09-17 18244/week @ 2021-09-24 16570/week @ 2021-10-01 16699/week @ 2021-10-08 19869/week @ 2021-10-15

62,709 downloads per month
Used in 103 crates (61 directly)

MIT license

82KB
1.5K SLoC

async-tungstenite

Asynchronous WebSockets for async-std, tokio, gio and any std Futures runtime.

MIT licensed Crates.io Build Status

Documentation

Usage

Add this in your Cargo.toml:

[dependencies]
async-tungstenite = "*"

Take a look at the examples/ directory for client and server examples. You may also want to get familiar with async-std or tokio if you don't have any experience with it.

What is async-tungstenite?

This crate is based on tungstenite Rust WebSocket library and provides async bindings and wrappers for it, so you can use it with non-blocking/asynchronous TcpStreams from and couple it together with other crates from the async stack. In addition, optional integration with various other crates can be enabled via feature flags

  • async-tls: Enables the async_tls module, which provides integration with the async-tls TLS stack and can be used independent of any async runtime.
  • async-std-runtime: Enables the async_std module, which provides integration with the async-std runtime.
  • async-native-tls: Enables the additional functions in the async_std module to implement TLS via async-native-tls.
  • tokio-runtime: Enables the tokio module, which provides integration with the tokio runtime.
  • tokio-native-tls: Enables the additional functions in the tokio module to implement TLS via tokio-native-tls.
  • tokio-rustls-native-certs: Enables the additional functions in the tokio module to implement TLS via tokio-rustls and uses native system certificates found with rustls-native-certs.
  • tokio-rustls-webpki-roots: Enables the additional functions in the tokio module to implement TLS via tokio-rustls and uses the certificates webpki-roots provides.
  • gio-runtime: Enables the gio module, which provides integration with the gio runtime.

Messages vs Streaming

WebSocket provides a message-oriented protocol, and this crate supports sending and receiving data in messages; protocols built on WebSocket are allowed to make message boundaries semantically significant. However, some users of WebSocket may want to treat the socket as a continuous stream of bytes. If you know the sending end does not place significance on message boundaries, and you want to process a stream of bytes without regard to those boundaries, try ws_stream_tungstenite, which builds upon this crate.

tokio-tungstenite

Originally this crate was created as a fork of tokio-tungstenite and ported to the traits of the futures crate. Integration into async-std, tokio and gio was added on top of that.

Dependencies

~4–9.5MB
~218K SLoC