toy-rpc

一个异步 RPC 库，模仿 golang 的 net/rpc 包，并支持 async-std 和 tokio。

此项目仍在积极开发中。我的功能想法已经有点用尽了，所以如果您想要某个功能，请随时告诉我。

toy-rpc 旨在成为一个易于使用的异步 RPC 工具，灵感来源于 golang 的 net/rpc API。它支持 TCP 或 TLS 上的 async_std 和 tokio 运行时。提供了与常见 HTTP 服务器框架（如 actix_web、warp 和 tide）的集成。

总体使用和 API 应该与 golang 的 net/rpc 包类似。一些名称已更改，使其听起来更“rusty”。因为 Rust 不自带运行时反射，所以使用属性宏 #[export_impl] 和 #[export_trait] / #[export_trait_impl]，以及属性 #[export_method] 来标记函数在 golang 的 net/rpc 视角下为“导出”。

toy-rpc的一些其他功能

• 级联取消：每当一个未完成的Call<Res>被丢弃时，会向服务器发送取消请求，从而传播取消。

更详细的用法可以在书籍和文档中找到。

• 书籍
• 快速入门
• 文档
• 变更日志
• GitHub仓库
• crate.io
• 最低支持的Rust版本：1.53或更高

此crate使用#![forbid(unsafe_code)]来确保crate中没有使用unsafe。

功能标志

功能标志可以分为三类。

运行时和HTTP框架集成的选择

• async_std_runtime：支持与async-std一起使用
• tokio_runtime：支持与tokio一起使用
• http_tide：在服务器端启用tide集成。这还启用了async_std_runtime和ws_async_std
• http_actix_web：在服务器端启用actix-web集成。这还启用了tokio_runtime和ws_tokio
• http_warp：在服务器端启用与warp的集成。这还启用了tokio_runtime和ws_tokio
• http_axum：在服务器端启用与axum的集成。这还启用了tokio_runtime和ws_tokio

选择RPC服务器或客户端（两者可以同时启用）

• server：启用RPC服务器
• client：启用RPC客户端

选择序列化/反序列化（每次只能启用一个）

• serde_bincode：（默认）默认编解码器将使用bincode进行序列化/反序列化
• serde_json：默认编解码器将使用serde_json进行json序列化/反序列化
• serde_cbor：默认编解码器将使用serde_cbor进行序列化/反序列化
• serde_rmp：默认编解码器将使用rmp-serde进行序列化/反序列化

default = ["serde_bincode"]