Rust-WebSocket

Rust-WebSocket 是用 Rust 编写的 WebSocket (RFC6455) 库。这是一个分支（分支的原因是上游不活跃）。

Rust-WebSocket 为处理 WebSocket 连接（客户端和服务器）提供了一个框架。该库目前处于实验状态，但提供了正常和安全 WebSocket 的功能，支持分片的消息级别 API，数据帧级别的 API，以及扩展和自定义行为的能力。

安装

要将 crates.io 中的库发布版本添加到 Cargo 项目中，请将以下内容添加到 Cargo.toml 的 'dependencies' 部分

websocket-vi = "~0.18.1"

并将 extern crate websocket_vi; 添加到您的项目中。

用法

该库可以与测试、benches 以及 Rust 夜间版本的一些额外功能一起编译。要启用夜间功能，请使用 cargo --features nightly ...。

请参阅最新版本库的文档此处，以及位于 /examples 的示例，可以使用

cargo run --example server

并在单独的终端中运行

cargo run --example client

测试

可以使用 cargo test 运行测试，使用 cargo bench 运行基准测试。

包含了一些测试，确保核心 WebSocket 功能按预期工作。这些测试还不是全面的，仍在开发中。

##Autobahn TestSuite

Rust-WebSocket 使用 Autobahn TestSuite 来测试对 RFC6455 的符合性。如果您已安装 Autobahn TestSuite，您可以使用以下命令自行运行这些测试：

wstest -m fuzzingserver
cargo run --example autobahn-client

测试客户端实现

wstest -m fuzzingclient
cargo run --example autobahn-server

测试服务器实现。规范文件可在 此处 获取。

这些测试的结果可在 此处 查看。

许可证

MIT 许可证 (MIT)

版权所有 (c) 2014-2015 Cyderize

本文件授予任何获得本软件及其相关文档副本（以下简称“软件”）的人免费使用权，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本，并允许软件的受让人进行上述操作，前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的任何副本或主要部分中。

软件按“原样”提供，不提供任何形式的明示或暗示保证，包括但不限于适销性、适用于特定目的和版权侵权的保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任承担责任，无论该责任基于合同、侵权或其他原因，是否与软件或其使用或其他相关操作有关。