110 releases (21 stable)

new 1.4.2 Oct 16, 2020
1.2.8 Sep 25, 2020
1.2.1 Jun 26, 2020
0.39.7 Apr 17, 2020
0.25.0 Jul 12, 2019

#4 in Database interfaces

Download history 2549/week @ 2020-06-28 3345/week @ 2020-07-05 3166/week @ 2020-07-12 3020/week @ 2020-07-19 3160/week @ 2020-07-26 2896/week @ 2020-08-02 2857/week @ 2020-08-09 2882/week @ 2020-08-16 3512/week @ 2020-08-23 3230/week @ 2020-08-30 3336/week @ 2020-09-06 3526/week @ 2020-09-13 3856/week @ 2020-09-20 4241/week @ 2020-09-27 4070/week @ 2020-10-04 3636/week @ 2020-10-11

14,672 downloads per month
Used in 21 crates (18 directly)

MIT license

285KB
7.5K SLoC

API Docs Build status Downloads Coverage Status Dependency Status LICENSE

A Rust AMQP client library.

This project follows the AMQP 0.9.1 specifications, targeting especially RabbitMQ.

Feature switches

  • codegen: generate code instead of using pregenerated one
  • native-tls (default): enable amqps support through native-tls
  • openssl: enable amqps support through openssl (preferred over native-tls when set)
  • rustls: enable amqps support through rustls (preferred over openssl when set, uses rustls-native-certs by default)
  • rustls-native-certs: same as rustls, be ensure we'll still use rustls-native-certs even if the default for rustls changes
  • rustls-webpki-roots-certs: same as rustls but using webkit-roots instead of rustls-native-certs

Integration with async-io

Integration with async-io is provided by the async-lapin crate.

Integration with async-std

Integration with async-std is provided by the async-amqp crate.

Integration with bastion

Integration with bastion is provided by the bastion-amqp crate.

Integration with smol

Integration with smol is provided by the lapinou crate.

Integration with tokio

Integration with tokio is provided by the tokio-amqp crate.

Example

use futures_executor::{LocalPool, ThreadPool};
use futures_util::stream::StreamExt;
use lapin::{
    options::*, publisher_confirm::Confirmation, types::FieldTable, BasicProperties, Connection,
    ConnectionProperties, Result,
};
use log::info;

fn main() -> Result<()> {
    if std::env::var("RUST_LOG").is_err() {
        std::env::set_var("RUST_LOG", "info");
    }

    env_logger::init();

    let addr = std::env::var("AMQP_ADDR").unwrap_or_else(|_| "amqp://127.0.0.1:5672/%2f".into());
    let executor = ThreadPool::new()?;

    LocalPool::new().run_until(async {
        let conn = Connection::connect(
            &addr,
            ConnectionProperties::default().with_default_executor(8),
        )
        .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!("Declared queue {:?}", queue);

        let mut consumer = channel_b
            .basic_consume(
                "hello",
                "my_consumer",
                BasicConsumeOptions::default(),
                FieldTable::default(),
            )
            .await?;
        executor.spawn_ok(async move {
            info!("will consume");
            while let Some(delivery) = consumer.next().await {
                let (channel, delivery) = delivery.expect("error in consumer");
                channel
                    .basic_ack(delivery.delivery_tag, BasicAckOptions::default())
                    .await
                    .expect("ack");
            }
        });

        let payload = b"Hello world!";

        loop {
            let confirm = channel_a
                .basic_publish(
                    "",
                    "hello",
                    BasicPublishOptions::default(),
                    payload.to_vec(),
                    BasicProperties::default(),
                )
                .await?
                .await?;
            assert_eq!(confirm, Confirmation::NotRequested);
        }
    })
}

Dependencies

~5–9MB
~206K SLoC