rust-amqp

AMQ protocol implementation in pure rust.

Note: The project is still in very early stages of development, it implements all the protocol parsing, but not all the protocol methods are wrapped/easy to use. Expect the API to be changed in the future.

What it currently can do:

• Connect to server
• Open/close channels
• Declare queues/exchanges
• All the methods from the Basic class are implemented, including get, publish, ack, nack, reject, consume. So you can send/receive messages.

Have a look at the examples in examples/ folder.

Connecting to the server & openning channel:

```rust extern crate amqp; use amqp::session::Session; use amqp::table;

let mut session = Session::openurl("amqp://localhost/").unwrap(); let mut channel = session.openchannel(1).unwrap(); ```

Note: This library supports TLS connections, via OpenSSL. However, this is an optional feature that is enabled by default but can be disabled at build-time (via cargo --no-default-features on the command-line, or with default-features = false in your Cargo.toml).

Declaring queue:

rust //The arguments come in following order: //queue: &str, passive: bool, durable: bool, exclusive: bool, auto_delete: bool, nowait: bool, arguments: Table let queue_declare = channel.queue_declare("my_queue_name", false, true, false, false, false, table::new());

Publishing message:

rust channel.basic_publish("", "my_queue_name", true, false, protocol::basic::BasicProperties{ content_type: Some("text".to_string()), ..Default::default()}, (b"Hello from rust!").to_vec());

This will send message: "Hello from rust!" to the queue named "myqueuename".

The messages have type of Vec<u8>, so if you want to send string, first you must convert it to Vec<u8>.

Development notes:

The methods encoding/decoding code is generated using codegen.rb & amqp-rabbitmq-0.9.1.json spec.

To generate a new spec, run:

sh make

To build the project and run the testsuite, use cargo:

sh cargo build cargo test

Moreover, there are several source examples to show library usage, and an interactive one to quickly test the library. They can be run directly from cargo:

sh cargo run --example interactive