2 个稳定版本

1.1.0 2023年10月5日
1.0.0 2023年9月8日

#11#amqp-client

每月下载量 32

MIT/Apache

280KB
5.5K SLoC

bnuuy

dependency status Latest Version Docs

bnuuy 是纯 Rust 编写的 RabbitMQ 客户端 bnuuy 的分支。

创建这个分支是因为 bnuuy 仓库似乎已经废弃多年,尽管新提交和问题依然被打开。

尽管 amqprs 等替代品维护得更新,但它们缺乏良好的 API 和文档,因此这个项目值得重新启动。

使用方法

将此添加到您的 Cargo.toml

[dependencies]
bnuuy = "1.0.0"

有关用法,请参阅 文档示例

最低支持的 Rust 版本

bnuuy 1.0.0 的最低支持 Rust 版本目前是 Rust 1.56.0,但可能会随着补丁版本的发布而改变(也可能在我们不知情的情况下,随着依赖项补丁版本的发布而改变)。

TLS 支持

默认情况下,bnuuy 通过 native-tls 包启用 TLS 支持。您可以通过 rusttls-tls 功能切换到使用 rusttls

您可以通过关闭默认功能来禁用 native_tls 的支持

[dependencies]
bnuuy = { version = "1.0.0", default-features = false }

如果您禁用 TLS 支持,则 Connection::openConnection::open_tunedConnection::open_tls_stream 方法将不再可用,因为这三个方法都只允许安全连接。方法 Connection::insecure_openConnection::insecure_open_tunedConnection::insecure_open_stream 仍将可用;这些方法支持未加密的连接。

集成测试

bnuuy 包含需要 RabbitMQ 服务的集成测试。要运行这些测试,请在运行 cargo test 前设置环境变量 AMIQUIP_TEST_URLamqp://amqps:// URL。例如,如果您在开发机器上运行默认的 guest 账户的 RabbitMQ 实例

bash$ AMIQUIP_TEST_URL=amqp://guest:guest@localhost cargo test

如果未设置环境变量 AMIQUIP_TEST_URL,所有集成测试将跳过(并静默通过)。如果您使用 --nocapture 运行,您将在第一个这样的跳过测试上看到一条警告信息。

bash$ cargo test -- nocapture
...
test integration_tests::exchange::test_declare ... AMIQUIP_TEST_URL not defined - skipping integration tests
...

许可证

本项目根据以下任一许可证授权:

您可选其一。

贡献

除非您明确声明,否则根据 Apache-2.0 许可证定义的您有意提交以包含在 bnuuy 中的任何贡献,都应如上双重许可,而不附加任何额外条款或条件。

依赖项

~6–20MB
~318K SLoC