Awesome Open Source
Awesome Open Source

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.4"

For usage, see the documentation and examples.

Minimum Support Rust Version

The minimum supported Rust version for amiquip 0.4 is currently Rust 1.40.0, but that may change with a patch release (and could change with a patch release to a dependency without our knowledge).

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.4", 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:[email protected] 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.


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
rust (4,330
rabbitmq (243
amqp (70

Find Open Source By Browsing 7,000 Topics Across 59 Categories