51 releases (12 breaking)

✓ Uses Rust 2018 edition

new 0.34.0 Mar 24, 2020
0.32.5 Mar 9, 2020
0.28.4 Dec 3, 2019
0.28.3 Nov 21, 2019
0.25.0 Jul 12, 2019

#8 in Database interfaces

Download history 1945/week @ 2019-12-02 2839/week @ 2019-12-09 1653/week @ 2019-12-16 681/week @ 2019-12-23 634/week @ 2019-12-30 1784/week @ 2020-01-06 2611/week @ 2020-01-13 2245/week @ 2020-01-20 2486/week @ 2020-01-27 2066/week @ 2020-02-03 1889/week @ 2020-02-10 1991/week @ 2020-02-17 2548/week @ 2020-02-24 2086/week @ 2020-03-02 2014/week @ 2020-03-09 3038/week @ 2020-03-16

8,983 downloads per month
Used in 8 crates (5 directly)

MIT and maybe MPL-2.0

140KB
3.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, targetting especially RabbitMQ.

Feature switches

  • 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

Example

use futures_executor::LocalPool;
use futures_util::{future::FutureExt, stream::StreamExt, task::LocalSpawnExt};
use lapin::{
    options::*, types::FieldTable, BasicProperties, Connection, ConnectionProperties, Result,
};
use log::info;

fn main() -> Result<()> {
    env_logger::init();

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

    executor.run_until(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!("Declared queue {:?}", queue);

        let consumer = channel_b
            .clone()
            .basic_consume(
                "hello",
                "my_consumer",
                BasicConsumeOptions::default(),
                FieldTable::default(),
            )
            .await?;
        let _consumer = spawner.spawn_local(async move {
            info!("will consume");
            consumer
                .for_each(move |delivery| {
                    let delivery = delivery.expect("error caught in in consumer");
                    channel_b
                        .basic_ack(delivery.delivery_tag, BasicAckOptions::default())
                        .map(|_| ())
                })
                .await
        });

        let payload = b"Hello world!";

        loop {
            channel_a
                .basic_publish(
                    "",
                    "hello",
                    BasicPublishOptions::default(),
                    payload.to_vec(),
                    BasicProperties::default(),
                )
                .await?;
        }
    })
}

Dependencies

~4–7.5MB
~178K SLoC