2 个稳定版本
1.1.0 | 2023年10月5日 |
---|---|
1.0.0 | 2023年9月8日 |
#11 在 #amqp-client
每月下载量 32
280KB
5.5K SLoC
bnuuy
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::open
、Connection::open_tuned
和 Connection::open_tls_stream
方法将不再可用,因为这三个方法都只允许安全连接。方法 Connection::insecure_open
、Connection::insecure_open_tuned
和 Connection::insecure_open_stream
仍将可用;这些方法支持未加密的连接。
集成测试
bnuuy 包含需要 RabbitMQ 服务的集成测试。要运行这些测试,请在运行 cargo test
前设置环境变量 AMIQUIP_TEST_URL
为 amqp://
或 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 License,版本 2.0,(LICENSE-APACHE 或 http://www.apache.org/licenses/LICENSE-2.0)
- MIT 许可证 (LICENSE-MIT 或 http://opensource.org/licenses/MIT)
您可选其一。
贡献
除非您明确声明,否则根据 Apache-2.0 许可证定义的您有意提交以包含在 bnuuy 中的任何贡献,都应如上双重许可,而不附加任何额外条款或条件。
依赖项
~6–20MB
~318K SLoC