mirror of https://github.com/rwf2/Rocket.git
36 lines
1.0 KiB
Markdown
36 lines
1.0 KiB
Markdown
# `ws` [![ci.svg]][ci] [![crates.io]][crate] [![docs.svg]][crate docs]
|
|
|
|
[crates.io]: https://img.shields.io/crates/v/rocket_ws.svg
|
|
[crate]: https://crates.io/crates/rocket_ws
|
|
[docs.svg]: https://img.shields.io/badge/web-master-red.svg?style=flat&label=docs&colorB=d33847
|
|
[crate docs]: https://api.rocket.rs/v0.5-rc/rocket_ws
|
|
[ci.svg]: https://github.com/SergioBenitez/Rocket/workflows/CI/badge.svg
|
|
[ci]: https://github.com/SergioBenitez/Rocket/actions
|
|
|
|
This crate provides WebSocket support for Rocket via integration with Rocket's
|
|
[connection upgrades] API.
|
|
|
|
# Usage
|
|
|
|
1. Depend on `rocket_ws`, renamed here to `ws`:
|
|
|
|
```toml
|
|
[dependencies]
|
|
ws = { package = "rocket_ws", version ="=0.1.0-rc.3" }
|
|
```
|
|
|
|
2. Use it!
|
|
|
|
```rust
|
|
#[get("/echo")]
|
|
fn echo_stream(ws: ws::WebSocket) -> ws::Stream!['static] {
|
|
ws::stream! { ws =>
|
|
for await message in ws {
|
|
yield message?;
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
See the [crate docs] for full details.
|