/amiquip

Pure Rust RabbitMQ client

Primary LanguageRustApache License 2.0Apache-2.0

amiquip

Travis Build Status dependency status Latest Version Docs

amiquip is a RabbitMQ client written in pure Rust.

Usage

Add this to your Cargo.toml:

[dependencies]
amiquip = "0.3"

For usage, see the documentation and examples.

Minimum Support Rust Version

The minimum supported Rust version for amiquip 0.3 is Rust 1.36.0.

TLS Support

By default, amiquip enables TLS support via the native-tls crate. You can disable support for TLS by turning off default features:

[dependencies]
amiquip = { version = "0.3", default-features = false }

If you disable TLS support, the methods Connection::open, Connection::open_tuned, and Connection::open_tls_stream will no longer be available, as all three only allow secure connections. The methods Connection::insecure_open, Connection::insecure_open_tuned, and Connection::insecure_open_stream will still be available; these methods support unencrypted connections.

Integration Tests

amiquip contains integration tests that require a RabbitMQ server. To run these, set the AMIQUIP_TEST_URL environment variable to an amqp:// or amqps:// URL before running cargo test. For example, if you have a RabbitMQ instance running with the default guest account on your development machine:

bash$ AMIQUIP_TEST_URL=amqp://guest:guest@localhost cargo test

If the AMIQUIP_TEST_URL environment variable is not set, all integration tests will be skipped (and silently pass). If you run with --nocapture, you will see a warning printed on the first such skipped test:

bash$ cargo test -- nocapture
...
test integration_tests::exchange::test_declare ... AMIQUIP_TEST_URL not defined - skipping integration tests
...

License

This project is licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in amiquip by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.