Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amqp-rs/lapin
AMQP client library in Rust, with a clean, futures based API
https://github.com/amqp-rs/lapin
amqp amqp-client amqp0-9-1 async hacktoberfest messaging rust
Last synced: about 1 month ago
JSON representation
AMQP client library in Rust, with a clean, futures based API
- Host: GitHub
- URL: https://github.com/amqp-rs/lapin
- Owner: amqp-rs
- License: mit
- Created: 2017-03-02T16:10:03.000Z (over 7 years ago)
- Default Branch: main
- Last Pushed: 2024-05-01T20:39:00.000Z (4 months ago)
- Last Synced: 2024-05-01T23:54:54.235Z (4 months ago)
- Topics: amqp, amqp-client, amqp0-9-1, async, hacktoberfest, messaging, rust
- Language: Rust
- Homepage:
- Size: 2.1 MB
- Stars: 987
- Watchers: 10
- Forks: 94
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://docs.rs/lapin)
[](https://github.com/amqp-rs/lapin/actions)
[](https://crates.io/crates/lapin)
[](https://coveralls.io/github/amqp-rs/lapin?branch=main)
[](https://deps.rs/repo/github/amqp-rs/lapin)
[](LICENSE)
A Rust AMQP client library.
This project follows the [AMQP 0.9.1 specifications](https://www.rabbitmq.com/resources/specs/amqp0-9-1.pdf), targeting especially RabbitMQ.
## Features
- codegen: force code generation (default to pregenerated sources)
- vendored-openssl: use a vendored openssl version instead of the system one (when using openssl backend)
- verbose-errors: enable more verbose errors in the AMQP parser
## TLS backends
- native-tls
- openssl
- rustls (default)
## Rustls certificates store
- rustls-native-certs (default)
- rustls-webpki-roots-certs
## Warning about crypto backends for rustls
A crypto implementation must be enabled in rustls using feature flags.
We mimic what rustls does, providing one feature flag per implementation and enabling the same as rustls by default.
Available options are:
- `rustls--aws_lc_rs` (default)
- `rustls--ring`
## Integration with third-party runtimes
Lapin can use any runtime of your choice by passing it to the `ConnectionProperties`.
You can configure the executor to use through [executor-trait](https://crates.io/crates/executor-trait).
You can configure the reactor to use through [reactor-trait](https://crates.io/crates/reactor-trait).
There are implementations for tokio, async-std and others.
## Example
```rust
use futures_lite::stream::StreamExt;
use lapin::{
options::*, publisher_confirm::Confirmation, types::FieldTable, BasicProperties, Connection,
ConnectionProperties, Result,
};
use tracing::info;
fn main() -> Result<()> {
if std::env::var("RUST_LOG").is_err() {
std::env::set_var("RUST_LOG", "info");
}
tracing_subscriber::fmt::init();
let addr = std::env::var("AMQP_ADDR").unwrap_or_else(|_| "amqp://127.0.0.1:5672/%2f".into());
async_global_executor::block_on(async {
let conn = Connection::connect(
&addr,
ConnectionProperties::default(),
)
.await?;
info!("CONNECTED");
let channel_a = conn.create_channel().await?;
let channel_b = conn.create_channel().await?;
let queue = channel_a
.queue_declare(
"hello",
QueueDeclareOptions::default(),
FieldTable::default(),
)
.await?;
info!(?queue, "Declared queue");
let mut consumer = channel_b
.basic_consume(
"hello",
"my_consumer",
BasicConsumeOptions::default(),
FieldTable::default(),
)
.await?;
async_global_executor::spawn(async move {
info!("will consume");
while let Some(delivery) = consumer.next().await {
let delivery = delivery.expect("error in consumer");
delivery
.ack(BasicAckOptions::default())
.await
.expect("ack");
}
}).detach();
let payload = b"Hello world!";
loop {
let confirm = channel_a
.basic_publish(
"",
"hello",
BasicPublishOptions::default(),
payload,
BasicProperties::default(),
)
.await?
.await?;
assert_eq!(confirm, Confirmation::NotRequested);
}
})
}
```