You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
Daniel Abramov e36093047e Update README.md with doc and crates.io badges 8 years ago
examples Return close frame with ConnectionClosed 8 years ago
src trivial: remove commented-out code 8 years ago
.gitignore Initial commit, mostly working client 8 years ago
Cargo.toml Merge branch 'devel' 8 years ago
LICENSE-APACHE Relicense under MIT + Apache-2.0. 8 years ago
LICENSE-MIT Relicense under MIT + Apache-2.0. 8 years ago
README.md Update README.md with doc and crates.io badges 8 years ago

README.md

Tungstenite

Lightweight stream-based WebSocket implementation for Rust.


/// A WebSocket echo server
let server = TcpListener::bind("127.0.0.1:9001").unwrap();
for stream in server.incoming() {
    spawn (move || {
        let mut websocket = accept(stream.unwrap()).unwrap();
        loop {
            let msg = websocket.read_message().unwrap();
            websocket.write_message(msg).unwrap();
        }
    });
}

MIT licensed Apache-2.0 licensed Crates.io

Documentation

Introduction

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.

This library is a work in progress. Feel free to ask questions and send us pull requests.

Why Tungstenite?

It's formerly WS2, the 2nd implementation of WS. WS2 is the chemical formula of tungsten disulfide, the tungstenite mineral.

Features

Tungstenite provides a complete implementation of the WebSocket specification. TLS is supported on all platforms using native-tls.

There is no support for permessage-deflate at the moment. It's planned.

Testing

Tungstenite is thoroughly tested and passes the Autobahn Test Suite for WebSockets. It is also covered by internal unit tests as good as possible.

Contributing

Please report bugs and make feature requests here.